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

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

תוכן עניינים

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

דרישות

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

כלול במקור או בהורדה:

לא כלולים במקור או בהורדה:

  • כדי להשתמש במחלקה SqlDataSourceHelper עם מסד נתונים של mySQL, צריך את mysql.jar גם בסביבת זמן הריצה. פרטים נוספים וגרסאות שניתנות להורדה זמינים בכתובת http://www.mysql.com/products/connector/j/.

שימוש בספרייה כפי שהיא

בקטע הזה נסביר איך להשתמש בספריית Java החזותית אם לא צריך לשנות אותה. התהליך הזה משתנה בהתאם למערכת ה-build שלכם:

אם משתמשים ב-Maven, צריך להגדיר תלות בספריית הוויזואליזציה באמצעות ההגדרות הבאות:

  • מזהה קבוצה: com.google.Visualization
  • מזהה פריט מידע שנוצר בתהליך הפיתוח (Artifact): מקור הנתונים להמחשה
  • מספר הגרסה: צריך להשתמש במספר הגרסה העדכני ביותר שמופיע בדף הפרויקט.

אם משתמשים במערכת build אחרת:

הרצת הדוגמאות

הקבצים לדוגמה של ה-JAR נכללים יחד עם ה-JAR של הספרייה בקובץ ה-ZIP שניתן להורדה. הוראות להפעלת הדוגמאות מופיעות בדף תחילת העבודה.

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

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

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

  1. מורידים את קוד המקור באמצעות SVN, כפי שמתואר בכרטיסייה מקור > תשלום בדף הפרויקט של קוד פתוח.
  2. בונים את הקוד. אם עובדים ב-Maven, צריך להשתמש בקובץ pom.xml שסופק עם המקור. אם אתם בונים באמצעות Apache Ant, פעלו לפי ההוראות הבאות (שימו לב שהקוד נבדק באמצעות Ant גרסה 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 – יצירה והרצה של הבדיקות בספריית מקורות הנתונים. שימושי מאוד כאשר משנים את הספרייה.

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

אם אתם רוצים לתרום שינויים בפרויקט הקוד הפתוח, יש לקבל הרשאות הגשה לפרויקט. שולחים אימייל לכתובת google-visualization-api@googlegroups.com עם בקשה לקבלת הרשאה והוראות לשליחת שינויים.