Einstieg in Datenquellen

In diesem Abschnitt wird SimpleExampleServlet eingeführt. Dies ist die einfachste Implementierung einer Datenquelle, die in der Bibliothek enthalten ist. In diesem Abschnitt finden Sie auch detaillierte Anleitungen zum Ausführen und Testen von SimpleExampleServlet.

Wir stellen vor: SimpleExampleServlet

Die Klasse SimpleExampleServlet befindet sich im Paket examples. Diese Klasse enthält ein Beispiel für die einfachste Implementierung einer Datenquelle. SimpleExampleServlet übernimmt von DataSourceServlet, implementiert generateDataTable() und muss in einem Servlet-Container ausgeführt werden.

Ein SimpleExampleServlet-Snippet wird unten bereitgestellt. Die Funktion generateDataTable stellt Daten der Bibliothek zur Verfügung. Diese Funktion erstellt eine Datentabellenbeschreibung, definiert die Datentabellenspalten und füllt die Datentabelle mit Daten. Die Bibliothek verarbeitet alle anderen Aktionen, die zum Zurückgeben der Datentabelle an die Abfragevisualisierung erforderlich sind.

// 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;
  }
}

SimpleExampleServlet ausführen und testen

In diesem Abschnitt erfahren Sie, wie Sie SimpleExampleServlet ausführen und testen.

Wenn Sie dies noch nicht getan haben, finden Sie im Abschnitt Installation Informationen zu den Voraussetzungen und eine Anleitung zum Herunterladen und Erstellen der Bibliothek. Achten Sie darauf, einen Webserver zu installieren, der auch als Servlet-Container wie Apache Tomcat fungiert, falls Sie noch keinen solchen Server haben. Die Anleitung in diesem Abschnitt gilt speziell für Apache Tomcat auf einem Windows-System.

Zum Ausführen und Testen von SimpleExampleServlet erstellen Sie eine Webanwendung, die die Datenquelle SimpleExampleServlet ausführt, und führen dann eine Beispielwebseite mit einer Visualisierung aus, die Daten aus der Datenquelle abruft. Dies wird in den folgenden Abschnitten beschrieben:

Webanwendung in Apache Tomcat erstellen

Folgen Sie der Anleitung unten oder passen Sie sie an, um eine Webanwendung in Apache Tomcat zu erstellen. Die folgende Anleitung gilt speziell für Apache Tomcat auf einem Windows-System:

  1. Rufen Sie das Verzeichnis auf, in dem Sie Tomcat installiert haben. Dies wird in diesem Dokument als <tomcat_home> geschrieben.
     
  2. Rufen Sie das Unterverzeichnis webapps auf.
     
  3. Erstellen Sie ein Unterverzeichnis namens myWebApp.
     
  4. Wechseln Sie zu dem gerade erstellten Unterverzeichnis und erstellen Sie ein weiteres Unterverzeichnis mit dem Namen WEB-INF.
     
  5. Wechseln Sie in das Unterverzeichnis WEB-INF und erstellen Sie ein weiteres Unterverzeichnis namens lib.
    Der vollständige Pfad sollte <tomcat_home>/webapps/myWebApp/WEB-INF/lib sein.
     
  6. Kopieren Sie web.xml aus <data_source_library_install>/examples/src/html in das Verzeichnis WEB-INF. Dabei ist <data_source_library_install> das Verzeichnis, in dem Sie die Datenquellenbibliothek installiert haben. Mit den folgenden Zeilen in web.xml wird SimpleExampleServlet definiert und zugeordnet:
    <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. Rufen Sie das Verzeichnis auf, in dem Sie die Datenquellenbibliothek installiert haben. Dies ist in diesem Dokument als <data_source_library_install> geschrieben.
     
  8. Kopieren Sie alle Abhängigkeitspakete in <tomcat_home>/webapps/myWebApp/WEB-INF/lib. Die Pakete werden in <data_source_library_install>/lib installiert, sofern Sie sie nicht in einem anderen Verzeichnis ablegen.
     
  9. Wenn Sie die Bibliothek selbst erstellt haben, kopieren Sie visualization-datasource-1.0.2.jar und visualization-datasource-examples.jar
    von <data_source_library_install>/build
    nach <tomcat_home>/webapps/myWebApp/WEB-INF/lib.

    Wenn Sie die ZIP-Datei entpackt haben, kopieren Sie visualization-datasource-1.0.2.jar und visualization-datasource-examples.jar
    von <data_source_library_install>
    nach <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
    Die Versionsnummer im JAR-Dateinamen kann je nach aktueller Versionsnummer variieren.
  10. Starten Sie Tomcat oder starten Sie Tomcat neu, wenn er bereits ausgeführt wird.
     
  11. Klicken Sie auf den folgenden Link:

    http://localhost:8080/myWebApp/simpleexample

    Je nach Bildschirmbreite werden 6–7 Textzeilen angezeigt.
    Der Text beginnt mit google.visualization.Query.setResponse
    und endet mit /Tiger'},{v:80.0},{v:false}]}]}});

    Das sind die Daten, die von Ihrer Datenquelle an eine Abfragevisualisierung zurückgegeben werden.

Daten mithilfe einer Visualisierung ansehen

Mit der Datei getting_started.html im Verzeichnis <data_source_library_install>/examples/src/html können Sie eine Visualisierung der Daten aufrufen. Die folgende Zeile aus getting_started.html gibt das zu verwendende Servlet an. Die Servlet-Zuordnung wurde in Schritt 8 unter Webanwendung in Apache Tomcat erstellen eingerichtet.

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

Weitere Informationen zum Angeben einer Visualisierung und zum Verwenden der Abfragesprache finden Sie unter Diagramme verwenden und in der Referenz zur Abfragesprache.

So können Sie eine Visualisierung der von der Datenquelle bereitgestellten Daten aufrufen oder anpassen:

  1. Kopieren Sie die Datei getting_started.html aus dem Verzeichnis <data_source_library_install>/examples/src/html
    in das Verzeichnis <tomcat_home>/webapps/myWebApp/.
     
  2. Klicken Sie auf den Link http://localhost:8080/myWebApp/getting_started.html. Daraufhin sollte Folgendes angezeigt werden:



    Fertig! Sie haben Ihre erste Datenquelle eingerichtet.

Next Steps

Das nächste Beispiel wird im Abschnitt Externen Datenspeicher verwenden beschrieben. Alternativ können Sie zur Einführung zurückkehren oder die folgenden Links aufrufen: