תחילת העבודה עם מקורות נתונים

בקטע הזה מוצגת הדוגמה הפשוטה ביותר להטמעה של מקור נתונים, SimpleExampleServlet, שמסופקת עם הספרייה. בקטע הזה יש גם הוראות מפורטות להרצה ולבדיקה של SimpleExampleServlet.

נעים להכיר: SimpleExampleServlet

הכיתה SimpleExampleServlet נמצאת בחבילה examples. המחלקות האלה מספקות דוגמה להטמעה הפשוטה ביותר של מקור נתונים. ‫SimpleExampleServlet הוא נגזר מ-DataSourceServlet, מטמיע את generateDataTable(), וחייב לפעול בתוך מאגר servlet.

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

// This example extends DataSourceServlet
public class SimpleExampleServlet extends DataSourceServlet {

  @Override
  public DataTable generateDataTable(Query query, HttpServletRequest request) {
    // Create a data table,
    DataTable data = new DataTable();
    ArrayList cd = new ArrayList();
    cd.add(new ColumnDescription("name", ValueType.TEXT, "Animal name"));
    cd.add(new ColumnDescription("link", ValueType.TEXT, "Link to wikipedia"));
    cd.add(new ColumnDescription("population", ValueType.NUMBER, "Population size"));
    cd.add(new ColumnDescription("vegeterian", ValueType.BOOLEAN, "Vegetarian?"));

    data.addColumns(cd);

    // Fill the data table.
    try {
      data.addRowFromValues("Aye-aye", "http://en.wikipedia.org/wiki/Aye-aye", 100, true);
      data.addRowFromValues("Sloth", "http://en.wikipedia.org/wiki/Sloth", 300, true);
      data.addRowFromValues("Leopard", "http://en.wikipedia.org/wiki/Leopard", 50, false);
      data.addRowFromValues("Tiger", "http://en.wikipedia.org/wiki/Tiger", 80, false);
    } catch (TypeMismatchException e) {
      System.out.println("Invalid type!");
    }
    return data;
  }
}

הפעלה ובדיקה של SimpleExampleServlet

בקטע הזה מוסבר איך להריץ ולבדוק את SimpleExampleServlet.

אם עדיין לא עשיתם זאת, כדאי לעיין בקטע התקנה כדי לקבל מידע על הדרישות המוקדמות והוראות להורדה ולבנייה של הספרייה. אם אין לכם שרת אינטרנט במערכת, אתם צריכים להתקין שרת אינטרנט שפועל גם כמאגר סרוולטים, כמו Apache Tomcat. ההוראות בקטע הזה ספציפיות ל-Apache Tomcat במערכת Windows.

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

יצירת אפליקציית אינטרנט ב-Apache Tomcat

פועלים לפי ההוראות הבאות או משנים אותן כדי ליצור אפליקציית אינטרנט ב-Apache Tomcat. ההוראות האלה ספציפיות ל-Apache Tomcat במערכת Windows:

  1. עוברים לספרייה שבה התקנתם את Tomcat. במסמך הזה, זה כתוב כ-<tomcat_home>.
     
  2. עוברים אל ספריית המשנה webapps.
     
  3. יוצרים תיקיית משנה בשם myWebApp.
     
  4. עוברים לספריית המשנה שיצרתם כרגע ויוצרים ספריית משנה נוספת בשם WEB-INF.
     
  5. עוברים לספריית המשנה WEB-INF ויוצרים ספריית משנה נוספת בשם lib.‫
    הנתיב המלא צריך להיות <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
     
  6. מעתיקים את web.xml מ-<data_source_library_install>/examples/src/html לספרייה WEB-INF. כאשר <data_source_library_install> הוא הספרייה שבה התקנתם את ספריית מקורות הנתונים. השורות הבאות ב-web.xml מגדירות וממפות את SimpleExampleServlet:
    <servlet>
  <servlet-name>My Servlet</servlet-name>
  <description>My servlet description.</description>
  <servlet-class>SimpleExampleServlet</servlet-class>
</servlet>

<servlet-mapping>
  <servlet-name>My Servlet</servlet-name>
  <url-pattern>/simpleexample</url-pattern>
</servlet-mapping>
  7. עוברים לספרייה שבה התקנתם את ספריית מקור הנתונים. במסמך הזה, השם הזה מופיע כ-<data_source_library_install>.
     
  8. מעתיקים את כל חבילות התלות אל <tomcat_home>/webapps/myWebApp/WEB-INF/lib. החבילות מותקנות ב-<data_source_library_install>/lib, אלא אם שומרים אותן בספרייה אחרת.
     
  9. אם יצרתם את הספרייה בעצמכם, צריך להעתיק את visualization-datasource-1.0.2.jar ואת visualization-datasource-examples.jar
    מ-<data_source_library_install>/build
    אל <tomcat_home>/webapps/myWebApp/WEB-INF/lib.

    אם פתחתם את קובץ ה-ZIP, מעתיקים את visualization-datasource-1.0.2.jar ואת visualization-datasource-examples.jar
    מ-<data_source_library_install>
    אל <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
    שימו לב שמספר הגרסה בשם קובץ ה-JAR עשוי להשתנות בהתאם למספר הגרסה האחרונה.
     
  10. מפעילים את Tomcat או מפעילים מחדש את Tomcat אם הוא כבר פועל.
     
  11. לוחצים על הקישור הבא:

    http://localhost:8080/myWebApp/simpleexample

    במסך מוצגות 6-7 שורות טקסט, בהתאם לרוחב המסך.
    הטקסט מתחיל ב- google.visualization.Query.setResponse
    ומסתיים ב- /Tiger'},{v:80.0},{v:false}]}]}});

    אלה הנתונים שמוחזרים ממקור הנתונים להמחשה של שאילתה.

שימוש בהמחשה חזותית כדי להציג את הנתונים

אפשר להשתמש בקובץ getting_started.html בספרייה <data_source_library_install>/examples/src/html כדי לראות תצוגה חזותית של הנתונים. השורה הבאה, שנלקחה מתוך getting_started.html, מציינת את ה-servlet שבו צריך להשתמש. מיפוי ה-servlet הוגדר בשלב 8 של יצירת אפליקציית אינטרנט ב-Apache Tomcat.

var query = new google.visualization.Query('simpleexample');

מידע נוסף על איך לציין תרשים ולהשתמש בשפת השאילתות זמין במאמרים שימוש בתרשימים ומאמר עזר בנושא שפת השאילתות.

כדי לראות תרשים של הנתונים שמגיעים ממקור הנתונים, פועלים לפי ההוראות הבאות או מתאימים אותן:

  1. מעתיקים את הקובץ getting_started.html מהספרייה <data_source_library_install>/examples/src/html
    לספרייה <tomcat_home>/webapps/myWebApp/.
     
  2. לוחצים על הקישור הבא http://localhost:8080/myWebApp/getting_started.html, אמורה להופיע ההודעה הבאה:
     


    זהו! הגדרתם את מקור הנתונים הראשון.

השלבים הבאים

הדוגמה הבאה מתוארת בקטע שימוש במאגר נתונים חיצוני. אפשר גם לחזור אל ההקדמה או לעיין בקישורים הבאים: