En esta página, se describe cómo usar o modificar la biblioteca de Java de visualización de Google y cómo contribuir al código abierto para el proyecto.
Contenido
Requisitos
Debes tener los siguientes componentes para usar la biblioteca de Java de visualización de Google:
- Un contenedor de servlet y la versión 2.4 o superior de la API de servlet. Uno de los contenedores de servlet más usados 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 debes instalar el módulo principal. También necesitas Tomcat para completar las secciones del instructivo: Cómo comenzar, Cómo usar un almacén de datos externo y Cómo definir las funciones y el flujo de eventos.
- El Java Development Kit versión 6.0 o posterior.
Nota: También es posible usar la versión 5.0 de JDK. Sin embargo, debes quitar
@Overridede 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@Overrideen la versión 6.0 de JDK.
Dependencias
La biblioteca Java de fuente de datos tiene las siguientes dependencias. La biblioteca se probó con las versiones indicadas. Otras versiones pueden ser aceptables, pero no se probaron.
Se incluyen en la fuente o la descarga:
- icu4j versión 4.0.1.
- Jakarta Commons lang versión 2.4.
- Yakarta Commons Logging versión 1.1.1.
- Versión 1.0 de la Biblioteca de colecciones de Google
- Versión 4.2 de javacc. Esto solo es necesario si tienes la intención de compilar las bibliotecas, por ejemplo, cuando las modificas como se describe a continuación.
- opencsv versión 1.8. Esto es necesario solo si tienes la intención de usar una fuente de datos CSV.
No se incluyen en la fuente ni en la descarga:
- Para usar la clase
SqlDataSourceHelpercon una base de datos MySQL, también necesitasmysql.jaren tu entorno de ejecución. Consulta http://www.mysql.com/products/connector/j/ para obtener detalles y versiones descargables.
Cómo usar la biblioteca tal como se proporciona
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 tu sistema de compilación:
Si usas Maven, establece una dependencia en la biblioteca de visualizaciones con la siguiente configuración:
- ID de grupo: com.google.visualization
- ID del artefacto: Visualizaciones-fuente de datos
- Número de versión: Usa el número de versión más reciente que aparece en la página del proyecto.
Si usas cualquier otro sistema de compilación, haz lo siguiente:
- Descarga el archivo ZIP de la biblioteca desde la página del proyecto, descomprime los archivos e inclúyelos en tu proyecto como lo requiera el sistema de compilación.
Cómo ejecutar los ejemplos
Los archivos de ejemplo JAR 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 la biblioteca, deberás descargar el código fuente del sitio de hosting de código abierto y compilarlo. 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.
Para descargar y compilar la biblioteca, sigue estos pasos:
- Descarga el código fuente mediante SVN, como se describe en la pestaña Fuente > Confirmación de la compra en la página del proyecto de código abierto.
- 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 proporcionan 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 Ant, es posible que debas actualizarla).
Instrucciones de compilación de hormigas
1. Modifica las propiedades de compilación:
- Navega hasta el subdirectorio
build-srcdel directorio de instalación elegido. - Con un editor de texto, abre el archivo
build.propertiesy realiza los siguientes cambios:- Edita la propiedad
servlet-api.jarpara que apunte a tu archivoservlet-api.jar. Por ejemplo, si instalaste Tomcat en la unidadc:del directoriotomcat_home, debes especificar la propiedadservlet-api.jarde la siguiente manera:
servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jarNota: Usa barras diagonales en lugar de barras inversas en la ruta de acceso del archivo, incluso si usas Windows.
- Para usar tus propias copias de las dependencias descritas anteriormente, edita las rutas de acceso en el mismo archivo build.properties.
- Edita la propiedad
2. Compila la biblioteca:
Navega por el subdirectorio build-src del archivo y escribe una de las siguientes opciones:
ant datasource: Compila la biblioteca de fuentes de datosant example: Compila los ejemplosant: Compila fuentes de datos y ejemplosant 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 aportar cambios al proyecto de código abierto, deberás obtener permisos de envío para el proyecto. Envía un correo electrónico a google-visualization-api@googlegroups.com para solicitar permiso y solicitar instrucciones sobre cómo enviar los cambios.