Instala la biblioteca de fuentes de datos de Java

En esta página, se describe cómo usar o modificar la biblioteca de visualización de Google para Java y cómo contribuir al código fuente abierto del proyecto.

Contenido

  1. Requisitos
  2. Dependencias
  3. Cómo usar la biblioteca según se proporciona
  4. Cómo ejecutar los ejemplos
  5. Cómo modificar la biblioteca
  6. Contribuye al proyecto de código abierto

Requisitos

Debes tener los siguientes componentes para usar la biblioteca de visualización de Java en Google:

  • Un contenedor de servlet y la versión 2.4 o posterior de la API de Servlet. Uno de los contenedores de servlet más utilizados es Apache Tomcat, que incluye la API de Servlet. Consulta http://tomcat.apache.org/download-55.cgi para descargar el objeto binario de la versión 5.5. Solo necesitas instalar el módulo principal. También necesitas a Tomcat para completar las secciones del instructivo: Primeros pasos, Cómo usar un almacén de datos externo y Cómo definir capacidades y el flujo de eventos.
  • Java Development Kit versión 6.0 o superior

    Nota: También es posible usar la versión 5.0 de JDK. Sin embargo, debes quitar @Override de cada método de la biblioteca que anule un método de interfaz. Esto se debe al cambio en el comportamiento de la anotación @Override en la versión 6.0 de JDK.

Dependencias

La biblioteca de Java de la fuente de datos tiene las siguientes dependencias. La biblioteca se probó con las versiones mencionadas; se aceptarán otras, pero no se probaron.

Se incluyen en la fuente o la descarga:

No se incluye en la fuente o la descarga:

  • Para usar la clase SqlDataSourceHelper con una base de datos MySQL, también necesitas mysql.jar en el entorno de ejecución. Consulta http://www.mysql.com/products/connector/j/ para obtener detalles y versiones descargables.

Cómo usar la biblioteca según lo proporcionado

En esta sección, se describe cómo usar la biblioteca de visualización de Java si no necesitas modificarla. Este proceso varía según el sistema de compilación:

Si usas Maven, configura una dependencia en la biblioteca de visualización con los siguientes parámetros:

  • ID de grupo: com.google.visualization
  • ID del artefacto: visualización-datasource
  • Número de versión: usa el número de la versión más reciente que aparece en la página del proyecto.

Si usas cualquier otro sistema de compilación:

Cómo ejecutar los ejemplos

Los archivos JAR de ejemplo se incluyen junto con los archivos JAR de la biblioteca en el archivo ZIP descargable. Las instrucciones para ejecutar los ejemplos se proporcionan en la página de introducción.

Cómo modificar la biblioteca

Si deseas modificar el código de biblioteca, deberás descargar la fuente del sitio de hosting de código abierto y compilarla. Antes de hacerlo, lee la información de licencia vinculada a la sección "Licencia de código" en la página del proyecto para ver si se permite tu caso práctico.

Estos son los pasos para descargar y compilar la biblioteca:

  1. Descarga el código fuente con SVN, como se describe en la pestaña Source > Checkout en la página del proyecto de código abierto.
  2. Compila tu código. Si compilas en Maven, usa el archivo pom.xml proporcionado con la fuente. Si compilas con Apache Ant, sigue las instrucciones que se brindan a continuación (ten en cuenta que el código se probó con la versión 1.7.0 de Ant; si tienes una versión anterior de este producto, es posible que debas realizar una actualización)

Instrucciones para la compilación de Ant

1. Modifica tus propiedades de compilación:

  1. Navega al subdirectorio build-src del directorio de instalación que elegiste.
  2. Con un editor de texto, abre el archivo build.properties y realiza los siguientes cambios:
    • Edita la propiedad servlet-api.jar para que apunte a tu archivo servlet-api.jar. Por ejemplo, si instalaste Tomcat en tu unidad c: en el directorio tomcat_home, debes especificar la propiedad servlet-api.jar de la siguiente manera:
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      Nota: Usa barras diagonales en lugar de barras inversas en la ruta de acceso del archivo, incluso cuando usas Windows

    • Para usar tus propias copias de las dependencias descritas anteriormente, edita las rutas de acceso en el mismo archivo build.properties.

2. Compila la biblioteca:

Navega por el subdirectorio build-src en el archivo y escribe uno de los siguientes vínculos:

  • ant datasource: Compila la biblioteca de fuente de datos.
  • ant example: Construye los ejemplos
  • ant: Compila una fuente de datos y ejemplos.
  • ant test: Compila y ejecuta las pruebas de la biblioteca de fuentes de datos. Es muy útil cuando modificas la biblioteca.

Cómo contribuir al proyecto de código abierto

Si deseas contribuir con cambios en el proyecto de código abierto, deberás obtener los permisos de envío del proyecto. Envía un correo electrónico a google-visualization-api@googlegroups.com para solicitar permiso y obtener instrucciones sobre cómo enviar cambios.