בדף הזה מוסבר איך להשתמש בספריית ה-Java של Google חזותית או לשנות אותה, ואיך לתרום לקוד המקור של הפרויקט.
תוכן עניינים
דרישות
כדי להשתמש בספריית Java להצגה חזותית של Google, עליך להשתמש ברכיבים הבאים:
- מאגר מאגרי מודעות ו-Servlet API מגרסה 2.4 ואילך. אחד מהמאגרים הנפוצים ביותר של הצגות הוא Apache Tomcat, שכולל את Servlet API. היכנס לכתובת http://tomcat.apache.org/download-55.cgi כדי להוריד את הקובץ הבינארי לגרסה 5.5. יש להתקין רק את המודול המרכזי. בנוסף, ב-Tomcat צריך להשלים את קטעי ההדרכה: תחילת העבודה, שימוש במאגר נתונים חיצוני והגדרת יכולות וזרימת האירועים.
- Java Development Kit גרסה 6.0 ומעלה.
הערה: אפשר להשתמש גם ב-JDK גרסה 5.0. עם זאת, עליך להסיר את
@Override
מכל שיטה בספרייה שעוקף שיטת ממשק. הסיבה לכך היא השינוי בהתנהגות ההערות של@Override
בגרסה JDK בגרסה 6.0.
יחסי תלות
בספריית Java של מקור הנתונים יש את יחסי התלות הבאים. הספרייה נבדקה עם הגרסאות שברשימה. ייתכן שגרסאות אחרות היו קבילות, אבל לא נבדקו.
המקור או ההורדה:
- icu4j גרסה 4.0.1.
- Jakarta Commons גרסה 2.4.
- יומן Jakarta Commons: גרסה 1.1.1.
- ספריית האוספים של Google גרסה 1.0.
- javacc גרסה 4.2. צריך לעשות זאת רק אם מתכוונים להדר את הספריות, למשל, כשמשנים אותן כפי שמתואר בהמשך.
- opencsv גרסה 1.8. פעולה זו נדרשת רק אם מתכוונים להשתמש במקור נתונים של CSV.
לא נכללים במקור או בהורדה:
- כדי להשתמש במחלקה
SqlDataSourceHelper
עם מסד נתונים mySQL, צריך גם אתmysql.jar
בסביבת סביבת הריצה. פרטים נוספים וגרסאות להורדה זמינות בכתובת http://www.mysql.com/products/connector/j/ .
שימוש בספרייה כפי שסופק
בקטע הזה מוסבר איך משתמשים בספריית Java להצגה חזותית אם לא צריך לשנות אותה. התהליך הזה משתנה בהתאם למערכת ה-build שלכם:
אם משתמשים ב-Maven, צריך להגדיר תלות בספריית הרכיבים החזותיים באמצעות ההגדרות הבאות:
- מזהה קבוצה: com.google.visualization
- מזהה פריט מידע שנוצר בתהליך פיתוח (Artifact): Visual-datasource
- מספר הגרסה: יש להשתמש במספר הגרסה העדכני ביותר שמופיע בדף הפרויקט.
אם אתם משתמשים במערכת build אחרת:
- מורידים את קובץ ה-ZIP של הספרייה מדף הפרויקט, פורסים את הקבצים ומצרפים אותם לפרויקט, כנדרש על פי מערכת ה-build.
הרצת הדוגמאות
קובצי ה-JAR לדוגמה כלולים יחד עם JAR של הספרייה בקובץ ה-ZIP שאפשר להוריד. ההוראות להפעלת הדוגמאות מפורטות בדף תחילת העבודה.
שינוי הספרייה
אם ברצונך לשנות את קוד הספרייה, עליך להוריד את המקור מהאתר המארח של הקוד הפתוח ולבנות אותו. לפני ביצוע הפעולה הזו, עליך לקרוא את פרטי הרישיון בקטע "רישיון קוד" בדף הפרויקט כדי לבדוק אם השימוש שלך מותר.
אלו השלבים להורדה ולבנייה של הספרייה:
- מורידים את קוד המקור באמצעות SVN, כפי שמתואר בכרטיסייה Source > Checkout בדף הפתיחה של פרויקט מקור.
- יוצרים את הקוד. אם המבנה קיים ב-Maven, יש להשתמש בקובץ pom.xml שסופק עם המקור. אם אתם בונים באמצעות Apache Ant, עליכם לפעול לפי ההוראות שבהמשך (שימו לב שהקוד נבדק עם Ant version גרסה 1.7.0. אם יש לכם גרסה ישנה יותר של Ant, יכול להיות שתצטרכו לשדרג)
הוראות לבניית נמלים
1. משנים את מאפייני ה-build:
- ניווט אל ספריית המשנה
build-src
של ספריית ההתקנה שבחרת. - באמצעות עורך טקסט, פותחים את הקובץ
build.properties
ועורכים את השינויים הבאים:- עורכים את המאפיין
servlet-api.jar
כך שיצביע על הקובץservlet-api.jar
. לדוגמה, אם התקנת את Tomcat בכונןc:
בספרייהtomcat_home
, עליך לציין את המאפייןservlet-api.jar
כך:
servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar
הערה: יש להשתמש בקו נטוי לפנים במקום בקו נטוי לאחור, גם כשמשתמשים ב-Windows
- כדי להשתמש בעותקים של יחסי התלות המתוארים למעלה, יש לערוך את הנתיבים באותו קובץ build.properties.
- עורכים את המאפיין
2. בונים את הספרייה:
מנווטים בספריית המשנה build-src
בקובץ ומקלידים:
ant datasource
– בניית הספרייה של מקור הנתוניםant example
– נבנה את הדוגמאותant
- בניית מקור נתונים ודוגמאותant test
– יצירה והרצה של בדיקות בספרייה של מקור הנתונים. שימושי מאוד לשינוי הספרייה.
תרומה לפרויקט הקוד הפתוח
אם ברצונך לתרום שינויים לפרויקט בקוד הפתוח, עליך לקבל הרשאות שליחה לפרויקט. שלחו אימייל לכתובת google-visualization-api@googlegroups.com ובקשו הרשאה והוראות לשליחת שינויים.