התקנת ספריית Java של מקור נתונים

בדף הזה מוסבר איך להשתמש בספריית ה-Java של Google חזותית או לשנות אותה, ואיך לתרום לקוד המקור של הפרויקט.

תוכן עניינים

1. הדרישות
2. יחסי תלות
3. שימוש בספרייה שסופקה
4. הפעלת הדוגמאות
5. שינוי הספרייה
6. תרומה לפרויקט הקוד הפתוח

דרישות

כדי להשתמש בספריית 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 שאפשר להוריד. ההוראות להפעלת הדוגמאות מפורטות בדף תחילת העבודה.

שינוי הספרייה

אם ברצונך לשנות את קוד הספרייה, עליך להוריד את המקור מהאתר המארח של הקוד הפתוח ולבנות אותו. לפני ביצוע הפעולה הזו, עליך לקרוא את פרטי הרישיון בקטע "רישיון קוד" בדף הפרויקט כדי לבדוק אם השימוש שלך מותר.

אלו השלבים להורדה ולבנייה של הספרייה:

1. מורידים את קוד המקור באמצעות SVN, כפי שמתואר בכרטיסייה Source > Checkout בדף הפתיחה של פרויקט מקור.
2. יוצרים את הקוד. אם המבנה קיים ב-Maven, יש להשתמש בקובץ pom.xml שסופק עם המקור. אם אתם בונים באמצעות Apache Ant, עליכם לפעול לפי ההוראות שבהמשך (שימו לב שהקוד נבדק עם Ant version גרסה 1.7.0. אם יש לכם גרסה ישנה יותר של Ant, יכול להיות שתצטרכו לשדרג)

הוראות לבניית נמלים

1. משנים את מאפייני ה-build:

1. ניווט אל ספריית המשנה build-src של ספריית ההתקנה שבחרת.
2. באמצעות עורך טקסט, פותחים את הקובץ 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 – יצירה והרצה של בדיקות בספרייה של מקור הנתונים. שימושי מאוד לשינוי הספרייה.

תרומה לפרויקט הקוד הפתוח

אם ברצונך לתרום שינויים לפרויקט בקוד הפתוח, עליך לקבל הרשאות שליחה לפרויקט. שלחו אימייל לכתובת [e-mail] ובקשו הרשאה והוראות לשליחת שינויים.