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

בקטע הזה אנחנו משיקים את 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.

אם עדיין לא עשיתם זאת, בקטע Installation יש מידע על דרישות מוקדמות והוראות להורדה וליצירה של הספרייה. חשוב להתקין שרת אינטרנט שמתפקד גם כקונטיינר servlet, כמו 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 של Creating a Web Application ב-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, ואתם אמורים לראות את זה:
     


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

השלבים הבאים

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