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
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:
- icu4j versión 4.0.1
- Jakarta commons lang versión 2.4.
- Yakarta Commons Logging versión 1.1.1
- Biblioteca de colecciones de Google versión 1.0.
- javacc versión 4.2 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 Solo es necesario si pretendes usar una fuente de datos CSV.
No se incluye en la fuente o la descarga:
- Para usar la clase
SqlDataSourceHelper
con una base de datos MySQL, también necesitasmysql.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:
- 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 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:
- 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.
- 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:
- Navega al subdirectorio
build-src
del directorio de instalación que elegiste. - 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 archivoservlet-api.jar
. Por ejemplo, si instalaste Tomcat en tu unidadc:
en el directoriotomcat_home
, debes especificar la propiedadservlet-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.
- Edita la propiedad
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 ejemplosant
: 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.