Introduzione alle origini dati

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

Presentazione di 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 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 dati, definisce le colonne della tabella dati e la compila con i dati. La libreria gestisce tutte le altre azioni necessarie per restituire la tabella dati alla visualizzazione di 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 Installazione per informazioni sui prerequisiti e istruzioni su come scaricare e creare la libreria. Assicurati di installare un server web che funga anche da container servlet, come Apache Tomcat, se non ne hai già uno sul 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, quindi esegui una pagina web di esempio con una visualizzazione che mostra i dati di cui è stata eseguita una query dall'origine dati. Questa procedura è 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. In questo documento è scritto come <tomcat_home>.
     
  2. Vai alla sottodirectory webapps.
     
  3. Crea una sottodirectory denominata myWebApp.
     
  4. Passa alla sottodirectory appena creata e crea un'altra sottodirectory denominata 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 a 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. In questo documento è scritto come <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 li inserisci in una directory diversa.
     
  9. Se hai creato tu stesso la libreria, 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 di versione più recente.
  10. Avvia Tomcat o riavvialo 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 restituiti dall'origine dati a una visualizzazione di query.

Utilizzo di 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 seguente riga, tratta da getting_started.html, specifica la servlet da utilizzare. Il mapping della servlet è stato configurato 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 al linguaggio di query.

Segui o adatta 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
    nella directory <tomcat_home>/webapps/myWebApp/.
     
  2. Fai clic sul seguente link http://localhost:8080/myWebApp/getting_started.html, dovresti visualizzare quanto segue:
     


    Ecco fatto. Hai configurato la tua prima origine dati.

Passaggi successivi

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