Introdução às fontes de dados

Esta seção apresenta o SimpleExampleServlet, que é o exemplo de implementação mais simples de uma fonte de dados fornecida com a biblioteca. Esta seção também fornece instruções detalhadas sobre como executar e testar o SimpleExampleServlet.

Conheça o SimpleExampleServlet

A classe SimpleExampleServlet está localizada no pacote examples. Essa classe fornece um exemplo da implementação mais simples de uma fonte de dados. SimpleExampleServlet herda de DataSourceServlet, implementa generateDataTable() e precisa ser executado em um contêiner de servlet.

Confira um snippet de SimpleExampleServlet abaixo. A função generateDataTable expõe dados à biblioteca. Essa função cria uma descrição da tabela de dados, define as colunas e preenche a tabela com dados. A biblioteca processa todas as outras ações necessárias para retornar a tabela de dados à visualização de consulta.

// 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();
    ArrayList cd = 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;
  }
}

Execução e teste de SimpleExampleServlet

Esta seção fornece instruções sobre como executar e testar o SimpleExampleServlet.

Se você ainda não fez isso, consulte a seção Instalação para informações sobre pré-requisitos e instruções sobre como baixar e criar a biblioteca. Instale um servidor da Web que também funcione como um contêiner de servlet, como o Apache Tomcat, se você ainda não tiver um no seu sistema. As instruções nesta seção são específicas para o Apache Tomcat em um sistema Windows.

Para executar e testar SimpleExampleServlet, crie um aplicativo da Web que execute a fonte de dados SimpleExampleServlet e, em seguida, execute uma página da Web de exemplo com uma visualização que mostre os dados consultados da fonte de dados. Isso é descrito nas seções a seguir:

Como criar um aplicativo da Web no Apache Tomcat

Siga ou adapte as instruções abaixo para criar um aplicativo da Web no Apache Tomcat. Estas instruções são específicas para o Apache Tomcat em um sistema Windows:

  1. Navegue até o diretório em que você instalou o Tomcat. Isso está escrito neste documento como <tomcat_home>.
     
  2. Navegue até o subdiretório webapps.
     
  3. Crie um subdiretório chamado myWebApp.
     
  4. Mude para o subdiretório que você acabou de criar e crie outro subdiretório chamado WEB-INF.
     
  5. Mude para o subdiretório WEB-INF e crie outro subdiretório chamado lib.
    O caminho completo precisa ser <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
     
  6. Copie web.xml de <data_source_library_install>/examples/src/html para o diretório WEB-INF. Em que <data_source_library_install> é o diretório em que você instalou a biblioteca de fonte de dados. As linhas a seguir em web.xml definem e mapeiam 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>
  7. Navegue até o diretório em que você instalou a biblioteca de fonte de dados. Isso é escrito neste documento como <data_source_library_install>.
     
  8. Copie todos os pacotes de dependência para <tomcat_home>/webapps/myWebApp/WEB-INF/lib. Os pacotes são instalados em <data_source_library_install>/lib, a menos que você os coloque em um diretório diferente.
     
  9. Se você criou a biblioteca, copie visualization-datasource-1.0.2.jar e visualization-datasource-examples.jar
    de <data_source_library_install>/build
    para <tomcat_home>/webapps/myWebApp/WEB-INF/lib.

    Se você descompactou o arquivo ZIP, copie visualization-datasource-1.0.2.jar e visualization-datasource-examples.jar
    de <data_source_library_install>
    para <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
    O número da versão no nome do arquivo JAR pode variar dependendo da versão mais recente.
     
  10. Inicie ou reinicie o Tomcat se ele já estiver em execução.
     
  11. Clique no link a seguir:

    http://localhost:8080/myWebApp/simpleexample

    A tela mostra de seis a sete linhas de texto, dependendo da largura da tela.
    O texto começa com google.visualization.Query.setResponse
    e termina com /Tiger'},{v:80.0},{v:false}]}]}});

    Esses são os dados retornados pela sua fonte de dados a uma visualização de consulta.

Usar uma visualização para ver os dados

O arquivo getting_started.html no diretório <data_source_library_install>/examples/src/html pode ser usado para conferir uma visualização dos dados. A linha a seguir, extraída de getting_started.html, especifica o servlet a ser usado. O mapeamento de servlet foi configurado na etapa 8 de Criação de um aplicativo da Web no Apache Tomcat.

var query = new google.visualization.Query('simpleexample');

Para mais informações sobre como especificar uma visualização e usar a linguagem de consulta, consulte Como usar gráficos e a Referência da linguagem de consulta.

Siga ou adapte as instruções abaixo para ver uma visualização dos dados fornecidos pela fonte:

  1. Copie o arquivo getting_started.html do diretório <data_source_library_install>/examples/src/html
    para o diretório <tomcat_home>/webapps/myWebApp/.
     
  2. Clique no link a seguir http://localhost:8080/myWebApp/getting_started.html. Você vai ver o seguinte:
     


    Pronto! Você configurou sua primeira fonte de dados.

Próximas etapas

O próximo exemplo é descrito na seção Usar um repositório de dados externo. Como alternativa, volte à Introdução ou acesse os seguintes links: