Installazione della libreria Java di origine dati

In questa pagina viene descritto come utilizzare o modificare la libreria Java di Google Visualization e come contribuire al codice open source per il progetto.

Contenuti

  1. Requisiti
  2. Dipendenze
  3. Utilizzo della Raccolta come fornito
  4. Esempi
  5. Modifica della Raccolta
  6. Contribuire al progetto open source

Requisiti

Per utilizzare la libreria Java di visualizzazione di Google, devi disporre dei seguenti componenti:

  • Un container di servlet e l'API Servlet versione 2.4 o successive. Uno dei container di servlet più 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 principale. Devi inoltre utilizzare 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 6.0 o versioni successive.

    Nota: è anche possibile utilizzare JDK versione 5.0. Tuttavia, devi rimuovere @Override da ogni metodo nella libreria che esegue l'override di un metodo di interfaccia. Ciò è dovuto al cambiamento 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.

Contenuti inclusi nella fonte o nel download:

Non inclusi nella fonte o nel download:

  • Per utilizzare la classe SqlDataSourceHelper con un database MySQL, hai bisogno anche di mysql.jar nell'ambiente di runtime. Consulta: http://www.mysql.com/products/connector/j/ per dettagli e versioni scaricabili.

Utilizzare la Raccolta così come viene fornita

In questa sezione viene descritto come utilizzare la libreria Java di visualizzazione se non devi modificarla. Questo processo varia a seconda del sistema di compilazione:

Se utilizzi Maven, configura una dipendenza dalla libreria di visualizzazioni con le seguenti impostazioni:

  • ID gruppo: com.google.visualization
  • ID artefatto: visualizzazione-origine dati
  • Numero di versione: usa 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 JAR della libreria, nel file ZIP scaricabile. Le istruzioni per l'esecuzione degli esempi sono disponibili nella pagina Per iniziare.

Modifica della Raccolta

Se vuoi modificare il codice libreria, dovrai scaricare il codice sorgente dal sito di hosting open source e crearlo. Prima di farlo, leggi le informazioni sulla licenza a cui rimanda la sezione "Licenza del codice" nella pagina del progetto per vedere 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 della pagina del progetto open source.
  2. Crea il tuo codice. Se crei in Maven, usa il file pom.xml fornito con l'origine. Se crei 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. Con 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 sull'unità 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: nel percorso del file utilizza barre non rovesciate, anche in Windows.

    • Per utilizzare le tue copie delle dipendenze descritte in precedenza, modifica i percorsi nello stesso file build.properties.

2. Crea la raccolta:

Passa alla sottodirectory build-src nel file e digita una delle seguenti indicazioni:

  • ant datasource: crea la libreria dell'origine dati
  • ant example - Crea gli esempi
  • ant: crea sia origini dati che esempi
  • ant test: crea ed esegue i test della libreria di origini dati. Molto utile quando modifichi la libreria.

Contribuire al progetto open source

Se vuoi contribuire con modifiche al progetto open source, devi ottenere le autorizzazioni di invio del progetto. Invia un'email all'indirizzo google-visualization-api@googlegroups.com per chiedere l'autorizzazione e le istruzioni su come inviare le modifiche.