כאן תוכלו לקרוא על הקטע 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(); ArrayListcd = 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:
- עוברים לספרייה שבה התקנתם את Tomcat. זה כתוב במסמך הזה בתור
<tomcat_home>
.
- עוברים אל ספריית המשנה
webapps
.
- יצירת ספריית משנה בשם
myWebApp
.
- מעבר לספריית המשנה שיצרת הרגע וצרו ספריית משנה אחרת בשם
WEB-INF
.
- מעבר לספריית המשנה
WEB-INF
ויצירת ספריית משנה אחרת בשםlib
.
הנתיב המלא צריך להיות<tomcat_home>/webapps/myWebApp/WEB-INF/lib
.
- העתקת
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>
- עוברים אל הספרייה שבה התקנתם את ספריית מקורות הנתונים.
נכתב במסמך הזה בתור
<data_source_library_install>
.
- מעתיקים את כל חבילות התלות
ל-
<tomcat_home>/webapps/myWebApp/WEB-INF/lib
. החבילות מותקנות ב-<data_source_library_install>/lib
, אלא אם הן מועברות לספרייה אחרת.
- אם יצרת את הספרייה בעצמך, יש להעתיק את
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 יכול להשתנות בהתאם למספר הגרסה האחרון. - מפעילים את Tomcat או מפעילים מחדש את Tomcat, אם הוא כבר פועל.
- לוחצים על הקישור הבא:
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');
למידע נוסף על ציון תצוגה חזותית ועל שימוש בשפת השאילתות, ראו שימוש בתרשימים וחומר העזר לגבי שפת השאילתות.
כדי לראות תצוגה חזותית של הנתונים שסופקו על ידי מקור הנתונים:
- מעתיקים את הקובץ
getting_started.html
מספריית<data_source_library_install>/examples/src/html
אל ספריית<tomcat_home>/webapps/myWebApp/
.
- לוחצים על הקישור הבא http://localhost:8080/myWebApp/get_start.html,
אמורים להופיע כך:
וזה! הגדרת את מקור הנתונים הראשון שלך.
השלבים הבאים
הדוגמה הבאה מתוארת בקטע שימוש בחנות נתונים חיצונית. לחלופין, תוכלו לחזור למבוא או לעיין בקישורים הבאים:
- לקבלת מבוא לכיתות הנפוצות ביותר בספרייה, ראו כיתות מרכזיות.
- לדוגמה, איך להטמיע זרימת אירועים משלכם ויכולות השאילתה, עיינו במאמר הגדרת יכולות וזרימת אירועים.
- אם אינך רוצה לרשת בירושה מ-
DataSourceServlet
, אפשר להטמיע מקור נתונים כפי שמתואר בקטע שימוש ב-Servelet משלך. לדוגמה, לא מומלץ לרשת בירושה מ-DataSourceServlet
אם מקבלים בירושה הגשה מכיתה אחרת. - אם אתם לא רוצים להשתמש בשרת הצגת מודעות, כדאי לעיין במאמר הטמעת מקור נתונים שאינו מוצג.
- במאמר העברת פרמטרים אל
DataTableGenerator.generateDataTable
מוסבר איך מעבירים פרמטרים מאפליקציה למקור נתונים.