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

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

חדש: SimpleExampleServlet

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

קטע מתוך 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.
    חשוב לשים לב שמספר הגרסה בשם של קובץ ה-gar יכול להשתנות בהתאם למספר הגרסה האחרון.
  10. מפעילים את Tomcat או מפעילים מחדש את Tomcat, אם הוא כבר פועל.
     
  11. לוחצים על הקישור הבא:

    http://localhost:8080/myWebApp/פשוטexample

    במסך מוצגות 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, מציינת את ה-הגשה שבה יש להשתמש. מיפוי שירות השרת הוגדר בשלב 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/get_start.html, אמורים להופיע כך:



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

השלבים הבאים

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