Introdução à biblioteca de fonte de dados

A Biblioteca de fontes de dados de visualização do Google facilita a criação de uma fonte de dados de visualização. A biblioteca implementa o protocolo de conexão e a linguagem de consulta da API Google Preview. Escreva apenas o código necessário para disponibilizar os dados para a biblioteca na forma de uma tabela de dados. A tabela de dados é uma tabela bidimensional de valores em que cada coluna é de um único tipo. Escrever o código necessário é mais fácil com o provisionamento de classes abstratas e funções auxiliares.

A implementação mais simples da biblioteca envolve a herança de uma única classe, a implementação de uma função de membro e a execução da fonte de dados como um servlet dentro de um contêiner do servlet. Na implementação mais simples, a seguinte sequência de eventos ocorre quando uma visualização consulta a fonte de dados:

1. O contêiner do servlet processa a consulta e a transmite para a biblioteca Java da fonte de dados.
2. A biblioteca analisa a consulta.
3. O código de implementação, ou seja, o código que você escreve, retorna uma tabela de dados para a biblioteca.
4. A biblioteca executa a consulta na tabela de dados.
5. A biblioteca renderiza a tabela de dados na resposta esperada pela visualização.
6. O contêiner do servlet retorna a resposta à visualização.

Isso é ilustrado no diagrama a seguir:

A seção Primeiros passos com as fontes de dados descreve como implementar esse tipo de fonte.

Os dados veiculados por uma fonte podem ser especificados no código de implementação, o que é adequado para pequenas quantidades de dados estáticos. Para conjuntos de dados maiores, é mais provável que você precise usar um armazenamento de dados externo, como um arquivo ou banco de dados externo. Se uma fonte de dados usa um armazenamento externo, a seguinte sequência de eventos ocorre quando uma visualização consulta a fonte:

1. O contêiner do servlet processa a consulta e a transmite para a biblioteca Java da fonte de dados.
2. A biblioteca analisa a consulta.
3. O código de implementação, o código que você escreve, lê os dados mantidos no armazenamento de dados e retorna uma tabela de dados para a biblioteca. Se o conjunto de dados for grande e o armazenamento de dados tiver recursos de consulta, você poderá usá-los para aumentar a eficiência da fonte de dados.
4. A biblioteca executa a consulta na tabela de dados.
5. A biblioteca renderiza a tabela de dados na resposta esperada pela visualização.
6. O contêiner do servlet retorna a resposta à visualização.

Isso é ilustrado no diagrama a seguir:

A seção Como usar um armazenamento de dados externo descreve como implementar esse tipo de fonte de dados.