בדף הזה נסביר איך להשתמש בספריית Java של Google שאפשר לראות או לשנות אותה, ואיך לתרום לקוד הפתוח של הפרויקט.
תוכן עניינים
דרישות
כדי להשתמש בספריית Java החזותית של Google, צריכים להיות לכם הרכיבים הבאים:
- מאגר servlet ו-Servlet API גרסה 2.4 ואילך. אחד הקונטיינרים הנפוצים ביותר של servlet הוא Apache Tomcat, והוא כולל את Servlet API. אפשר להיכנס לכתובת http://tomcat.apache.org/download-55.cgi כדי להוריד את הקובץ הבינארי לגרסה 5.5. צריך להתקין רק את מודול הליבה. בנוסף, תצטרכו את Tomcat כדי להשלים את קטעי המדריך: תחילת העבודה, שימוש במאגר נתונים חיצוני והגדרת יכולות וזרימת האירועים.
- Java Development Kit מגרסה 6.0 ואילך.
הערה: אפשר להשתמש גם בגרסה 5.0 של JDK. עם זאת, לאחר מכן צריך להסיר את
@Overrideמכל method בספרייה שמבטלת שיטה של ממשק. הסיבה לכך היא השינוי בהתנהגות ההערות@Overrideבגרסה 6.0 של JDK.
תלות
ספריית Java של מקור הנתונים כוללת את יחסי התלות הבאים. הספרייה נבדקה עם הגרסאות הרשומות. יכול להיות שגרסאות אחרות מקובלות, אבל לא נבדקו.
כלול במקור או בהורדה:
- icu4j גרסה 4.0.1.
- Jakarta Commons lang גרסה 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): מקור הנתונים להמחשה
- מספר הגרסה: צריך להשתמש במספר הגרסה העדכני ביותר שמופיע בדף הפרויקט.
אם משתמשים במערכת build אחרת:
- מורידים את קובץ ה-ZIP של הספרייה מדף הפרויקט, מחלצים את הקבצים דחוסים וכוללים אותם בפרויקט בהתאם לדרישות מערכת ה-build.
הרצת הדוגמאות
הקבצים לדוגמה של ה-JAR נכללים יחד עם ה-JAR של הספרייה בקובץ ה-ZIP שניתן להורדה. הוראות להפעלת הדוגמאות מופיעות בדף תחילת העבודה.
שינוי הספרייה
כדי לשנות את קוד הספרייה, צריך להוריד את המקור מאתר האירוח של הקוד הפתוח ולבנות אותו. לפני ביצוע הפעולה הזו, חשוב לקרוא את פרטי הרישוי שמקושרים בקטע 'רישיון קוד' בדף הפרויקט כדי לראות אם התרחיש לדוגמה שלכם מותר.
אלה השלבים להורדה ולבנייה של הספרייה:
- מורידים את קוד המקור באמצעות SVN, כפי שמתואר בכרטיסייה מקור > תשלום בדף הפרויקט של קוד פתוח.
- בונים את הקוד. אם עובדים ב-Maven, צריך להשתמש בקובץ pom.xml שסופק עם המקור. אם אתם בונים באמצעות Apache Ant, פעלו לפי ההוראות הבאות (שימו לב שהקוד נבדק באמצעות Ant גרסה 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 עם בקשה לקבלת הרשאה והוראות לשליחת שינויים.