資料來源 Java 程式庫 - 關於本指南
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本指南說明如何使用 Google 視覺化資料來源程式庫實作資料來源。
本指南將在「簡介」概念後方提供入門教學課程一節。這個方法可讓您建立簡易資料來源，並以視覺化方式進行測試。如要瞭解更複雜的實作方式，請參閱其他教學課程各節的「使用外部資料儲存庫」和「定義功能和事件流」。視您的需求而定，您可能不需要完成全部三堂教學課程，不過我們建議您至少完成「Getting Started」(開始使用) 區段。本指南的其他章節將協助您增進知識。
目錄
觀眾
您必須熟悉 Java 和 Java JDK 技術才能使用這個程式庫。
此外，您還須瞭解如何使用圖表，但這並非必要，建議您熟悉 Google Visualization API 傳輸通訊協定和查詢語言。
指南總覽
本指南包含以下章節：
- 簡介
介紹程式庫，概略說明資料來源的運作方式。
- 安裝
說明程式庫的必備條件和依附元件，以及如何下載及建構原始碼。
- 開始使用
推出 SimpleExampleServlet。SimpleExampleServlet 是搭配程式庫提供最簡單的實作範例。本節也提供執行及測試 SimpleExampleServlet 的逐步操作說明。
- 使用外部資料儲存庫
推出 CsvDataSourceServlet。CsvDataSourceServlet 是使用 CSV 檔案做為外部資料儲存庫的實作範例。本節也提供執行及測試 CsvDataSourceServlet 的逐步操作說明。
- 定義功能與事件流
推出 AdvancedExampleServlet2。AdvancedExampleServlet2 是定義功能和事件流程的實作範例。本節也會提供執行及測試 AdvancedExampleServlet2 的逐步操作說明。
- 處理安全性、錯誤、警告和記錄
說明如何確保資料來源安全無虞，以及如何處理錯誤、警告和記錄。
- 實作秘訣
提供相關資訊，協助您編寫更複雜的程式庫實作。
- 程式庫套件和金鑰類別
提供程式庫套件和重要類別的概要簡介。
快速參考範例
這個程式庫提供了六個實作範例。本指南將介紹上述其中三種，另外另外兩種。下表範例可協助您找出要實作的行為類型。
如要進一步瞭解資料來源程式庫專案，請參閱 首頁。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-07-10 (世界標準時間)。
[null,null,["上次更新時間：2024-07-10 (世界標準時間)。"],[[["\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/)."]]
