ספריית Java של מקור נתונים – מידע על המדריך הזה
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במדריך הזה מוסבר איך להשתמש בספריית מקור הנתונים של התצוגה החזותית של Google כדי להטמיע מקור נתונים.
במדריך הזה מופיע הקטע תחילת העבודה אחרי המושגים ברשימה מבוא.
הגישה הזו מאפשרת ליצור מקור נתונים פשוט ולבדוק אותו באמצעות הצגה חזותית. קטעי המדריך האחרים הם שימוש במאגר נתונים חיצוני והגדרת יכולות וזרימה של אירועים, שעוסקים בהטמעות מורכבות יותר. בהתאם לדרישות שלכם, יכול להיות שלא תצטרכו להשלים את כל שלושת המדריכים, אבל מומלץ להשלים לפחות את הסעיף Getting Started (תחילת העבודה).
החלקים האחרים במדריך יעזרו לכם להרחיב את הידע.
תוכן עניינים
קהל
כדי להשתמש בספרייה, חשוב להכיר את Java ו-Javaservlet.
צריך גם להבין איך להשתמש בתרשימים, ולמרות שזה לא חיוני, כדאי להכיר את פרוטוקול
הכבל של GoogleVisual API ואת שפת השאילתות.
סקירה כללית של המדריך
המדריך הזה כולל את הקטעים הבאים:
- מבוא
מציגה את הספרייה, ומספקת סקירה כללית של אופן הפעולה של מקור נתונים.
- התקנה
תיאור הדרישות המוקדמות ויחסי התלות של הספרייה, ואיך להוריד וליצור את קוד המקור.
- איך מתחילים
הצגה של SimpleExampleServlet. SimpleExampleServlet הוא ההטמעה הפשוטה ביותר לדוגמה שסופקה בספרייה.
בקטע הזה תמצאו גם הוראות מפורטות להרצה של SimpleExampleServlet ולבדיקה שלה.
- שימוש במאגר נתונים חיצוני
הצגה של CsvDataSourceServlet. CsvDataSourceServlet הוא הטמעה לדוגמה שמשתמשת בקובץ CSV כמאגר נתונים חיצוני.
בקטע הזה תמצאו גם הוראות מפורטות להרצה של CsvDataSourceServlet ולבדיקה שלה.
- הגדרת יכולות וזרימת האירועים
הצגה של AdvancedExampleServlet2. AdvancedExampleServlet2 הוא הטמעה לדוגמה שמגדירה יכולות וזרימה של אירועים. בקטע הזה יש גם הוראות מפורטות להרצה ולבדיקה של AdvancedExampleServlet2.
- טיפול באבטחה, בשגיאות, באזהרות וברישום ביומן
תיאור האופן שבו ניתן לאבטח את מקור הנתונים ואיך לטפל בשגיאות, באזהרות וברישום ביומן.
- טיפים להטמעה
מספקת מידע שיעזור לכם לכתוב הטמעות מורכבות יותר של הספרייה.
- חבילות ספרייה ומחלקות מפתחות
מציג מבוא ברמה גבוהה לחבילות ולסוגי המפתחות של הספרייה.
דוגמאות לעיון מהיר
בספרייה יש שישה הטמעות לדוגמה. שלושה מהם
מתוארים במדריך הזה, והאחרים לא. הטבלה הבאה תעזור לכם למצוא דוגמה לסוג ההתנהגות שאתם רוצים להטמיע.
למידע על הפרויקט של ספריית מקורות הנתונים, ראו דף הבית.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-07-10 (שעון UTC).
[null,null,["עדכון אחרון: 2024-07-10 (שעון UTC)."],[[["\u003cp\u003eThis guide explains how to use the Google Visualization Data Source Library to create custom data sources for interactive charts using Java and Java Servlet technology.\u003c/p\u003e\n"],["\u003cp\u003eIt includes tutorials on basic setup, using external data stores like CSV files, and defining advanced capabilities like custom event flows.\u003c/p\u003e\n"],["\u003cp\u003eThe guide assumes familiarity with Java, Java Servlets, Google Charts and optionally, the Google Visualization API wire protocol and query language.\u003c/p\u003e\n"],["\u003cp\u003eSeveral example implementations are provided, including \u003ccode\u003eSimpleExampleServlet\u003c/code\u003e, \u003ccode\u003eCsvDataSourceServlet\u003c/code\u003e, and \u003ccode\u003eAdvancedExampleServlet2\u003c/code\u003e, each demonstrating different features of the library.\u003c/p\u003e\n"],["\u003cp\u003eFor more details on the project and its source code, refer to the project's home page.\u003c/p\u003e\n"]]],[],null,["# Data Source Java Library - About This Guide\n\nThis Guide describes how to use the Google Visualization Data Source\nLibrary to implement a data source.\n\nThis guide provides a [Getting Started](/chart/interactive/docs/dev/dsl_get_started) tutorial\nsection after the concepts in the [Introduction](/chart/interactive/docs/dev/dsl_intro).\nThis approach lets you create a simple data source and test it using a\nvisualization. The other tutorial sections are [Using\nan External Data Store](/chart/interactive/docs/dev/dsl_csv) and [Defining\nCapabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet), which cover more complex\nimplementations. Depending on your requirements, you might not need to\ncomplete all three tutorials, though it is recommended that you at least\ncomplete the [Getting Started](/chart/interactive/docs/dev/dsl_get_started) section.\nThe other sections of the guide help you to build on your knowledge.\n\nContents\n--------\n\n- [Audience](#audience)\n- [Guide Overview](#overview)\n- [Examples Quick Reference](#quick)\n- [More Information](#more)\n\nAudience\n--------\n\nYou need to be familiar with [Java](http://www.java.com/) and [Java\nservlet technology](http://java.sun.com/products/servlet/overview.html) to use the library.\n\nYou also need to understand [how to\nuse charts](/chart/interactive/docs), and though not essential, it is helpful to be familiar\nwith the Google Visualization API [wire\nprotocol](/chart/interactive/docs/dev/implementing_data_source#requestformat), and the [query\nlanguage](/chart/interactive/docs/querylanguage).\n\nGuide Overview\n--------------\n\nThis guide contains the following sections:\n\n- [Introduction](/chart/interactive/docs/dev/dsl_intro)\n\n\n Introduces the library, providing an overview of how a data source\n works.\n- [Installation](/chart/interactive/docs/dev/dsl_install)\n\n\n Describes the library's prerequisites and dependencies, and how to download\n and build the source code.\n- [Getting Started](/chart/interactive/docs/dev/dsl_get_started)\n\n Introduces `SimpleExampleServlet`. `SimpleExampleServlet` is\n the simplest example implementation that is provided with the library.\n This section also provides step-by-step instructions on how to run and\n test `SimpleExampleServlet`.\n- [Using an External Data Store](/chart/interactive/docs/dev/dsl_csv)\n\n Introduces `CsvDataSourceServlet`. `CsvDataSourceServlet` is\n an example implementation that uses a CSV file as an external data store.\n This section also provides step-by-step instructions on how to run and\n test `CsvDataSourceServlet`.\n- [Defining Capabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet)\n\n Introduces `AdvancedExampleServlet2`. `AdvancedExampleServlet2` is\n an example implementation that defines capabilities and flow\n of events. This section also provides step-by-step instructions on how\n to run and test `AdvancedExampleServlet2`.\n- [Handling Security, Errors, Warnings,\n and Logging](/chart/interactive/docs/dev/dsl_errors_and_logging)\n\n Describes how to make your data source secure,\n and how to handle errors, warnings, and logging.\n- [Implementation Tips](/chart/interactive/docs/dev/dsl_key_concepts)\n\n Provides information that will help you write more complex implementations\n of the library.\n- [Library\n Packages and Key Classes](/chart/interactive/docs/dev/dsl_packages)\n\n Provides a high level introduction to the library's packages and key\n classes.\n\nExamples Quick Reference\n------------------------\n\nThe library is provided with six example implementations. Three of these\nare described in this Guide, the others are not. The following\ntable will help\nyou find an example of the type of behavior you want to implement.\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------|------------------|--------------------|--------------------|\n| **Example** | **Servlet extended** | **Capabilities** | **Flow of events** | **Source of data** |\n| [`SimpleExampleServlet`](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/SimpleExampleServlet.java) Described in [Getting Started](/chart/interactive/docs/dev/dsl_get_started) | `DataSourceServlet` | `NONE` | Default | Within class |\n| [CsvDataSourceServlet](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/CsvDataSourceServlet.java) Described in [Using an External Data Store](/chart/interactive/docs/dev/dsl_csv) | `DataSourceServlet` | `NONE` | Default | CSV file |\n| [`AdvancedExampleServlet2`](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/AdvancedExampleServlet2.java) Described in [Defining Capabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet) | `HttpServlet` | `SELECT` | Custom | Within class |\n| [SimpleExampleServlet2](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/SimpleExampleServlet2.java) Not described in this Guide | `HttpServlet` ` ` | `NONE` | Custom | Within class |\n| [AdvancedExampleServlet](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/AdvancedExampleServlet.java) Not described in this Guide | `DataSourceServlet` | `SELECT` | Default | Within class |\n| [SqlDataSourceServlet](http://code.google.com/p/google-visualization-java/source/browse/trunk/examples/src/java/SqlDataSourceServlet.java) Not described in this Guide | `DataSourceServlet` | `SQL` | Default | SQL database |\n\nMore Information\n----------------\n\nFor information on the Data Source Library project, see the [home\npage](http://code.google.com/p/google-visualization-java/)."]]
