In questa pagina viene descritto come utilizzare o modificare la libreria Java di Visualizzazione Google e come contribuire al codice open source per il progetto.
Contenuti
Requisiti
Per utilizzare la libreria Java di visualizzazione Google devi avere i seguenti componenti:
- Un container di servlet e la versione 2.4 o successiva dell'API Servlet. Uno dei container servlet più comunemente utilizzati è Apache Tomcat, che include l'API Servlet. Visita la pagina http://tomcat.apache.org/download-55.CGI per scaricare il programma binario per la versione 5.5. Devi installare solo il modulo Core. Devi anche usare Tomcat per completare le sezioni del tutorial: Introduzione, Utilizzo di un datastore esterno e Definizione delle funzionalità e del flusso di eventi.
- Java Development Kit versione 6.0 o successive.
Nota: è anche possibile utilizzare JDK versione 5.0. Tuttavia, devi rimuovere
@Override
da ogni metodo nella raccolta che sostituisce un metodo dell'interfaccia. Ciò è dovuto alla modifica del comportamento dell'annotazione@Override
in JDK versione 6.0.
Dipendenze
La libreria Java dell'origine dati ha le seguenti dipendenze. La libreria è stata testata con le versioni elencate; altre versioni potrebbero essere accettabili, ma non sono state testate.
Funzionalità inclusa nella fonte o nel download:
- icu4j versione 4.0.1.
- Lingua comune di Giacarta versione 2.4.
- Logging di Giacarta versione 1.1.1.
- Raccolta di raccolte di Google versione 1.0.
- javacc versione 4.2. Questa operazione è necessaria solo se intendi compilare le librerie, ad esempio quando le modifichi come descritto di seguito.
- opencsv versione 1.8. Questa operazione è necessaria solo se intendi utilizzare un'origine dati CSV.
Non incluso nella fonte o nel download:
- Per utilizzare la classe
SqlDataSourceHelper
con un database mySQL, devi avere anchemysql.jar
nel tuo ambiente di runtime. Consulta la pagina http://www.mysql.com/products/connector/j/ per i dettagli e le versioni scaricabili.
Usare la Raccolta come fornita
Questa sezione descrive come utilizzare la libreria Java di visualizzazione se non è necessario modificarla. Questo processo varia a seconda del sistema di compilazione:
Se usi Maven, imposta una dipendenza dalla libreria di visualizzazione con le seguenti impostazioni:
- ID gruppo: com.google.visualization
- ID artefatto: visualizzazione-origine dati
- Numero di versione: utilizza il numero di versione più recente elencato nella pagina del progetto.
Se utilizzi un altro sistema di compilazione:
- Scarica il file ZIP della libreria dalla pagina del progetto, decomprimi i file e includili nel tuo progetto come richiesto dal tuo sistema di compilazione.
Esecuzione degli esempi
I file di esempio JAR sono inclusi insieme ai file JAR della libreria nel file ZIP scaricabile. Le istruzioni sull'esecuzione degli esempi sono disponibili nella pagina Per iniziare.
Modificare la raccolta
Se vuoi modificare il codice libreria, devi scaricare il codice sorgente dal sito di hosting open source e crearlo. Prima di eseguire questa operazione, leggi le informazioni sulla licenza collegate nella sezione "Licenza del codice" nella pagina del progetto per verificare se il tuo caso d'uso è consentito.
Ecco la procedura per scaricare e creare la libreria:
- Scarica il codice sorgente utilizzando SVN, come descritto nella scheda Origine > Pagamento nella pagina del progetto open source.
- Crea il tuo codice. Se crei in Maven, utilizza il file pom.xml fornito con la sorgente. Se crei un'app con Apache Ant, segui le istruzioni riportate di seguito (tieni presente che il codice è stato testato con Ant versione 1.7.0; se hai una versione precedente di Ant, potrebbe essere necessario eseguire l'upgrade)
Istruzioni per la creazione di formiche
1. Modifica le proprietà della build:
- Vai alla sottodirectory
build-src
della directory di installazione scelta. - Utilizzando un editor di testo, apri il file
build.properties
e apporta le seguenti modifiche:- Modifica la proprietà
servlet-api.jar
in modo che punti al fileservlet-api.jar
. Ad esempio, se hai installato Tomcat sul tuo Drivec:
nella directorytomcat_home
, devi specificare la proprietàservlet-api.jar
come segue:
servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar
Nota: utilizza le barre anziché le barre rovesciate nel percorso del file, anche quando utilizzi Windows.
- Per utilizzare le tue copie delle dipendenze descritte sopra, modifica i percorsi nello stesso file build.properties.
- Modifica la proprietà
2. Crea la raccolta:
Esplora la sottodirectory build-src
nel file e digita una delle seguenti
opzioni:
ant datasource
: crea la libreria di origini datiant example
: crea gli esempiant
- Crea sia l'origine dati che gli esempiant test
: crea ed esegue i test della libreria di origini dati. Molto utile quando modifichi la raccolta.
Contributo al progetto open source
Se vuoi contribuire a modifiche al progetto open source, devi ottenere le autorizzazioni di invio al progetto. Invia un'email all'indirizzo google-visualization-api@googlegroups.com chiedendo l'autorizzazione e le istruzioni su come inviare le modifiche.