Stay organized with collections
Save and categorize content based on your preferences.
This Guide describes how to use the Google Visualization Data Source
Library to implement a data source.
This guide provides a Getting Started tutorial
section after the concepts in the Introduction.
This approach lets you create a simple data source and test it using a
visualization. The other tutorial sections are Using
an External Data Store and Defining
Capabilities and the Flow of Events, which cover more complex
implementations. Depending on your requirements, you might not need to
complete all three tutorials, though it is recommended that you at least
complete the Getting Started section.
The other sections of the guide help you to build on your knowledge.
Introduces SimpleExampleServlet. SimpleExampleServlet is
the simplest example implementation that is provided with the library.
This section also provides step-by-step instructions on how to run and
test SimpleExampleServlet.
Introduces CsvDataSourceServlet. CsvDataSourceServlet is
an example implementation that uses a CSV file as an external data store.
This section also provides step-by-step instructions on how to run and
test CsvDataSourceServlet.
Introduces AdvancedExampleServlet2. AdvancedExampleServlet2 is
an example implementation that defines capabilities and flow
of events. This section also provides step-by-step instructions on how
to run and test AdvancedExampleServlet2.
Provides a high level introduction to the library's packages and key
classes.
Examples Quick Reference
The library is provided with six example implementations. Three of these
are described in this Guide, the others are not. The following
table will help
you find an example of the type of behavior you want to implement.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 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/)."]]