Guida introduttiva alle origini dati

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

SimpleExampleServlet

La classe SimpleExampleServlet si trova nel pacchetto examples. Questa classe fornisce un esempio dell'implementazione più semplice di un'origine dati. SimpleExampleServlet eredita da DataSourceServlet, implementa generateDataTable() e deve essere eseguito in 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 dati, definisce le colonne della tabella dati e completa la tabella dati con i dati. La libreria gestisce tutte le altre azioni richieste per restituire la tabella di dati alla visualizzazione della 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 di SimpleExampleServlet

Questa sezione fornisce istruzioni su come eseguire e testare SimpleExampleServlet.

Se non l'hai ancora fatto, consulta la sezione sull'installazione per informazioni sui prerequisiti e per le 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 sul tuo sistema. Le istruzioni riportate 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, quindi esegui una pagina web di esempio con una visualizzazione che mostra i dati di cui è stata eseguita la query dall'origine dati. Questo aspetto viene descritto nelle seguenti sezioni:

Creazione di un'applicazione web su Apache Tomcat

Segui o segui 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. Passa alla directory in cui hai installato Tomcat. che è stata scritta nel documento <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 denominata 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 righe 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. Questo documento è scritto in <data_source_library_install>.
     
  8. Copia tutti i pacchetti di dipendenze in <tomcat_home>/webapps/myWebApp/WEB-INF/lib. I pacchetti vengono installati in <data_source_library_install>/lib, a meno che non vengano inseriti in una directory diversa.
     
  9. Se hai creato la libreria, copia visualization-datasource-1.0.2.jar e visualization-datasource-examples.jar
    da <data_source_library_install>/build
    in <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>
    in <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 di versione più recente.
  10. Avvia Tomcat o riavvia Tomcat se è già in esecuzione.
     
  11. Fai clic sul seguente link:

    http://localhost:8080/myWebApp/simpleexample

    Lo schermo mostra 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 dalla tua origine dati a una visualizzazione di query.

Utilizzare una visualizzazione per visualizzare i dati

Il file getting_started.html nella directory <data_source_library_install>/examples/src/html può essere utilizzato per visualizzare una visualizzazione dei dati. La riga seguente, presa da getting_started.html, specifica il servlet da utilizzare. La mappatura dei servlet è stata configurata nel passaggio 8 di 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 Utilizzo dei grafici e il riferimento per il linguaggio di query.

Segui o segui le istruzioni riportate di seguito per visualizzare 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 seguente link http://localhost:8080/myWebApp/getting_started.html, dovresti vedere:



    Questo è 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 all'introduzione o esplorare i seguenti link: