Biblioteca Java de origem de dados - Sobre este guia
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este guia descreve como usar a biblioteca de fontes de dados de visualização do Google para implementar uma fonte de dados.
Neste guia, fornecemos uma seção de tutorial de Primeiros passos
após os conceitos da Introdução.
Essa abordagem permite criar uma fonte de dados simples e testá-la usando uma
visualização. As outras seções do tutorial são Como usar um armazenamento de dados externo e Como definir recursos e o fluxo de eventos, que abrangem implementações mais complexas. Dependendo dos seus requisitos, pode não ser necessário
concluir os três tutoriais, embora seja recomendável que você
conclua pelo menos a seção Como começar.
As outras seções do guia ajudam você a desenvolver seu conhecimento.
Conteúdo
Público
Você precisa conhecer Java e tecnologia de servlet Java para usar a biblioteca.
Você também precisa entender como usar gráficos. Embora não seja essencial, é útil conhecer o protocolo de transferência eletrônica da API Google Visualization e a linguagem de consulta.
Visão geral do guia
Este guia contém as seguintes seções:
- Introdução
Apresenta a biblioteca, fornecendo uma visão geral de como uma fonte de dados
funciona.
- Instalação
Descreve os pré-requisitos e as dependências da biblioteca e como fazer o download
e criar o código-fonte.
- Primeiros passos
Apresenta SimpleExampleServlet
. SimpleExampleServlet
é o exemplo de implementação mais simples fornecido com a biblioteca.
Esta seção também fornece instruções detalhadas sobre como executar e
testar o SimpleExampleServlet
.
- Como usar um repositório de dados externo
Apresenta CsvDataSourceServlet
. CsvDataSourceServlet
é
um exemplo de implementação que usa um arquivo CSV como um repositório de dados externo.
Esta seção também fornece instruções detalhadas sobre como executar e
testar o CsvDataSourceServlet
.
- Definição de recursos e o fluxo de eventos
Apresenta AdvancedExampleServlet2
. AdvancedExampleServlet2
é
um exemplo de implementação que define recursos e fluxo
de eventos. Esta seção também fornece instruções detalhadas sobre como
executar e testar AdvancedExampleServlet2
.
- Como lidar com segurança, erros, avisos e geração de registros
descreve como proteger a fonte de dados
e lidar com erros, avisos e registros.
- Dicas de implementação
Fornece informações que ajudarão você a escrever implementações mais complexas
da biblioteca.
- Pacotes
de biblioteca e classes de chave
Oferece uma introdução de alto nível aos pacotes e classes de
chave da biblioteca.
Exemplos de referência rápida
A biblioteca é fornecida com seis exemplos de implementação. Três deles estão descritos neste guia, os outros não. A tabela a seguir ajudará a encontrar um exemplo do tipo de comportamento que você quer implementar.
Para mais informações sobre o projeto da biblioteca de fonte de dados, consulte a página inicial.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-07-10 UTC.
[null,null,["Última atualização 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/)."]]