Introduzione alle origini dati

Questa sezione introduce SimpleExampleServlet, che è l'implementazione di esempio più semplice di un'origine dati fornita con la libreria. Questa sezione fornisce anche istruzioni dettagliate su come eseguire e testare SimpleExampleServlet.

Introduzione a SimpleExampleServlet

La classe SimpleExampleServlet si trova nel pacchetto examples. Questa classe fornisce un esempio della implementazione più semplice di un'origine dati. SimpleExampleServlet eredita da DataSourceServlet, implementa generateDataTable() e deve essere eseguito all'interno di un container servlet.

Di seguito è riportato uno snippet di SimpleExampleServlet. La funzione generateDataTable espone i dati alla libreria. Questa funzione crea una descrizione della tabella di dati, definisce le colonne della tabella di dati e compila la tabella con i dati. La libreria gestisce tutte le altre azioni necessarie per restituire la tabella di dati alla visualizzazione con query.

// This example extends DataSourceServlet
public class SimpleExampleServlet extends DataSourceServlet {

  @Override
  public DataTable generateDataTable(Query query, HttpServletRequest request) {
    // Create a data table,
    DataTable data = new DataTable();
    ArrayList cd = new ArrayList();
    cd.add(new ColumnDescription("name", ValueType.TEXT, "Animal name"));
    cd.add(new ColumnDescription("link", ValueType.TEXT, "Link to wikipedia"));
    cd.add(new ColumnDescription("population", ValueType.NUMBER, "Population size"));
    cd.add(new ColumnDescription("vegeterian", ValueType.BOOLEAN, "Vegetarian?"));

    data.addColumns(cd);

    // Fill the data table.
    try {
      data.addRowFromValues("Aye-aye", "http://en.wikipedia.org/wiki/Aye-aye", 100, true);
      data.addRowFromValues("Sloth", "http://en.wikipedia.org/wiki/Sloth", 300, true);
      data.addRowFromValues("Leopard", "http://en.wikipedia.org/wiki/Leopard", 50, false);
      data.addRowFromValues("Tiger", "http://en.wikipedia.org/wiki/Tiger", 80, false);
    } catch (TypeMismatchException e) {
      System.out.println("Invalid type!");
    }
    return data;
  }
}

Esecuzione e test SimpleExampleServlet

Questa sezione fornisce istruzioni su come eseguire e testare SimpleExampleServlet.

Se non lo hai già fatto, consulta la sezione Installazione per informazioni sui prerequisiti e istruzioni su come scaricare e creare la libreria. Assicurati di installare un server web che funzioni anche come container di servlet, come Apache Tomcat, se non ne hai già uno nel tuo sistema. Le istruzioni in questa sezione sono specifiche per Apache Tomcat su un sistema Windows.

Per eseguire e testare SimpleExampleServlet, crea un'applicazione web che esegue l'origine dati SimpleExampleServlet, poi esegui una pagina web di esempio con una visualizzazione che mostra i dati per cui è stata eseguita la query dall'origine dati. Questa procedura viene descritta nelle sezioni seguenti:

Creazione di un'applicazione web su Apache Tomcat

Segui o adatta le istruzioni riportate di seguito per creare un'applicazione web su Apache Tomcat. Queste istruzioni sono specifiche per Apache Tomcat su un sistema Windows:

  1. Vai alla directory in cui hai installato Tomcat. Nel documento è scritto <tomcat_home>.
     
  2. Vai alla sottodirectory webapps.
     
  3. Crea una sottodirectory denominata myWebApp.
     
  4. Passa alla sottodirectory appena creata e crea un'altra sottodirectory chiamata WEB-INF.
     
  5. Passa alla sottodirectory WEB-INF e crea un'altra sottodirectory chiamata lib.
    Il percorso completo deve essere <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
     
  6. Copia web.xml da <data_source_library_install>/examples/src/html nella directory WEB-INF. Dove <data_source_library_install> è la directory in cui hai installato la libreria dell'origine dati. Le seguenti linee in web.xml definiscono e mappano SimpleExampleServlet:
    <servlet>
  <servlet-name>My Servlet</servlet-name>
  <description>My servlet description.</description>
  <servlet-class>SimpleExampleServlet</servlet-class>
</servlet>

<servlet-mapping>
  <servlet-name>My Servlet</servlet-name>
  <url-pattern>/simpleexample</url-pattern>
</servlet-mapping>
  7. Vai alla directory in cui hai installato la libreria dell'origine dati. È scritto in questo documento come <data_source_library_install>.
     
  8. Copia tutti i pacchetti di dipendenze in <tomcat_home>/webapps/myWebApp/WEB-INF/lib. I pacchetti sono installati in <data_source_library_install>/lib, a meno che non li inserisci in una directory diversa.
     
  9. Se hai creato tu la raccolta, copia visualization-datasource-1.0.2.jar e visualization-datasource-examples.jar
    da <data_source_library_install>/build
    a <tomcat_home>/webapps/myWebApp/WEB-INF/lib.

    Se hai decompresso il file ZIP, copia visualization-datasource-1.0.2.jar e visualization-datasource-examples.jar
    da <data_source_library_install>
    a <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
    Tieni presente che il numero di versione nel nome del file jar può variare a seconda del numero della versione più recente.
  10. Avvia Tomcat o riavvia Tomcat se è già in esecuzione.
     
  11. Fai clic sul seguente link:

    http://localhost:8080/myWebApp/simpleexample

    Sullo schermo vengono visualizzate 6-7 righe di testo, a seconda della larghezza dello schermo.
    Il testo inizia con google.visualization.Query.setResponse
    e termina con /Tiger'},{v:80.0},{v:false}]}]}});

    Questi sono i dati che vengono restituiti dall'origine dati a una visualizzazione con query.

Utilizzare una visualizzazione per visualizzare i dati

Puoi utilizzare il file getting_started.html nella directory <data_source_library_install>/examples/src/html per visualizzare una visualizzazione dei dati. La riga seguente, presa da getting_started.html, specifica il servlet da utilizzare. Il mapping del servlet è stato configurato nel passaggio 8 della pagina Creazione di un'applicazione web su Apache Tomcat.

var query = new google.visualization.Query('simpleexample');

Per ulteriori informazioni su come specificare una visualizzazione e utilizzare il linguaggio di query, consulta Uso dei grafici e Riferimento per il linguaggio di query.

Segui o adatta le istruzioni riportate di seguito per vedere una visualizzazione dei dati forniti dall'origine dati:

  1. Copia il file getting_started.html dalla directory <data_source_library_install>/examples/src/html
    alla directory <tomcat_home>/webapps/myWebApp/.
     
  2. Fai clic sul link http://localhost:8080/myWebApp/getting_started.html, dovresti vedere quanto segue:
     


    È tutto. Hai configurato la tua prima origine dati.

Passaggi successivi

L'esempio successivo è descritto nella sezione Utilizzo di un datastore esterno. In alternativa, puoi tornare alla sezione Introduzione o esplorare i seguenti link: