Comienza a usar fuentes de datos

En esta sección, se presenta SimpleExampleServlet, que es la implementación de ejemplo más simple de una fuente de datos que se proporciona con la biblioteca. En esta sección, también se proporcionan instrucciones paso a paso sobre cómo ejecutar y probar SimpleExampleServlet.

Presentamos SimpleExampleServlet

La clase SimpleExampleServlet se encuentra en el paquete examples. Esta clase proporciona un ejemplo de la implementación más simple de una fuente de datos. SimpleExampleServlet hereda de DataSourceServlet, implementa generateDataTable() y debe ejecutarse dentro de un contenedor de servlet.

A continuación, se proporciona un fragmento de SimpleExampleServlet. La función generateDataTable expone datos a la biblioteca. Esta función crea una descripción de la tabla de datos, define las columnas de la tabla de datos y la propaga con datos. La biblioteca controla todas las demás acciones necesarias para mostrar la tabla de datos en la visualización de consultas.

// 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;
  }
}

Ejecución y prueba SimpleExampleServlet

En esta sección, se proporcionan instrucciones sobre cómo ejecutar y probar SimpleExampleServlet.

Si aún no lo hiciste, consulta la sección Instalación para obtener información sobre los requisitos previos y las instrucciones sobre cómo descargar y compilar la biblioteca. Asegúrate de instalar un servidor web que también funcione como un contenedor de servlet, como Apache Tomcat, si aún no tienes uno en tu sistema. Las instrucciones de esta sección son específicas de Apache Tomcat en un sistema Windows.

Para ejecutar y probar SimpleExampleServlet, crea una aplicación web que ejecute la fuente de datos SimpleExampleServlet y, luego, ejecuta una página web de ejemplo con una visualización que muestre datos consultados desde la fuente. Esto se describe en las siguientes secciones:

Cómo crear una aplicación web en Apache Tomcat

Sigue o adapta las instrucciones a continuación para crear una aplicación web en Apache Tomcat. Estas instrucciones son específicas de Apache Tomcat en un sistema Windows:

  1. Navega hasta el directorio en el que instalaste Tomcat. Se escribe en este documento como <tomcat_home>.
     
  2. Navega al subdirectorio webapps.
     
  3. Crea un subdirectorio llamado myWebApp.
     
  4. Cambia al subdirectorio que acabas de crear y crea otro subdirectorio llamado WEB-INF.
     
  5. Cambia al subdirectorio WEB-INF y crea otro subdirectorio llamado lib.
    La ruta de acceso completa debe ser <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
     
  6. Copia web.xml de <data_source_library_install>/examples/src/html al directorio WEB-INF. En el ejemplo anterior, <data_source_library_install> es el directorio en el que instalaste la biblioteca de fuente de datos. Las siguientes líneas de web.xml definen y asignan 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. Navega al directorio en el que instalaste la biblioteca de fuente de datos. Está escrito en este documento como <data_source_library_install>.
     
  8. Copia todos los paquetes de dependencia en <tomcat_home>/webapps/myWebApp/WEB-INF/lib. Los paquetes se instalan en <data_source_library_install>/lib, a menos que los coloques en un directorio diferente.
     
  9. Si compilaste la biblioteca tú mismo, copia visualization-datasource-1.0.2.jar y visualization-datasource-examples.jar
    de <data_source_library_install>/build
    a <tomcat_home>/webapps/myWebApp/WEB-INF/lib.

    Si descomprimiste el archivo ZIP, copia visualization-datasource-1.0.2.jar y visualization-datasource-examples.jar
    de <data_source_library_install>
    a <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
    Ten en cuenta que el número de versión en el nombre del archivo jar puede variar según el número de versión más reciente.
  10. Inicia Tomcat o reinicia Tomcat si ya se está ejecutando.
     
  11. Haz clic en el siguiente vínculo:

    http://localhost:8080/myWebApp/simpleexample

    La pantalla muestra entre 6 y 7 líneas de texto, según el ancho de la pantalla.
    El texto comienza con google.visualization.Query.setResponse
    y termina con /Tiger'},{v:80.0},{v:false}]}]}});

    Estos son los datos que muestra la fuente de datos en una visualización de consulta.

Cómo usar una visualización para ver los datos

El archivo getting_started.html en el directorio <data_source_library_install>/examples/src/html se puede usar para ver una visualización de los datos. En la siguiente línea, tomada de getting_started.html, se especifica el servlet que se usará. La asignación de servlet se configuró en el paso 8 de Crea una aplicación web en Apache Tomcat.

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

Para obtener más información sobre cómo especificar una visualización y usar el lenguaje de consulta, visita Usa gráficos y la Referencia de lenguaje de consulta.

Sigue o sigue las instrucciones que se indican a continuación para ver una visualización de los datos que proporciona la fuente de datos:

  1. Copia el archivo getting_started.html del directorio <data_source_library_install>/examples/src/html
    al directorio <tomcat_home>/webapps/myWebApp/.
     
  2. Haz clic en el siguiente vínculo http://localhost:8080/myWebApp/getting_started.html. Deberías ver lo siguiente:



    Eso es todo. Configuraste tu primera fuente de datos.

Próximos pasos

El siguiente ejemplo se describe en la sección Cómo usar un almacén de datos externo. Como alternativa, puedes volver a la Introducción o explorar los siguientes vínculos: