Installare la libreria Java dell'origine dati

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:

Non incluso nella fonte o nel download:

  • Per utilizzare la classe SqlDataSourceHelper con un database mySQL, devi avere anche mysql.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:

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:

  1. Scarica il codice sorgente utilizzando SVN, come descritto nella scheda Origine > Pagamento nella pagina del progetto open source.
  2. 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:

  1. Vai alla sottodirectory build-src della directory di installazione scelta.
  2. 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 file servlet-api.jar. Ad esempio, se hai installato Tomcat sul tuo Drive c: nella directory tomcat_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.

2. Crea la raccolta:

Esplora la sottodirectory build-src nel file e digita una delle seguenti opzioni:

  • ant datasource: crea la libreria di origini dati
  • ant example: crea gli esempi
  • ant - Crea sia l'origine dati che gli esempi
  • ant 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.