Java-Bibliothek für die Datenquelle installieren

Auf dieser Seite wird beschrieben, wie Sie die Java-Bibliothek für die Google-Visualisierung verwenden oder ändern und wie Sie zum Open-Source-Code für das Projekt beitragen können.

Inhalt

  1. Voraussetzungen
  2. Abhängigkeiten
  3. Bibliothek in der angegebenen Form verwenden
  4. Beispiele ausführen
  5. Bibliothek ändern
  6. Beitrag zum Open-Source-Projekt

Voraussetzungen

Sie benötigen die folgenden Komponenten, um die Java-Bibliothek für die Google-Visualisierung verwenden zu können:

  • Ein Servlet-Container und die Servlet-API Version 2.4 oder höher. Einer der am häufigsten verwendeten Servlet-Container ist Apache Tomcat, in dem die Servlet API enthalten ist. Informationen zum Herunterladen des Binärprogramms für Version 5.5 finden Sie unter http://tomcat.apache.org/download-55.cgi. Sie müssen nur das Kernmodul installieren. Außerdem benötigen Sie Tomcat, um die Anleitungsabschnitte Erste Schritte, Externen Datenspeicher verwenden und Funktionen und Ereignisfluss definieren auszuführen.
  • Java Development Kit ab Version 6.0

    Hinweis: Sie können auch das JDK Version 5.0 verwenden. Anschließend müssen Sie jedoch @Override aus jeder Methode in der Bibliothek entfernen, die eine Schnittstellenmethode überschreibt. Dies liegt an der Änderung des Verhaltens der Annotationen @Override in der JDK-Version 6.0.

Abhängigkeiten

Für die Java-Bibliothek der Datenquelle gelten die folgenden Abhängigkeiten. Die Bibliothek wurde mit den aufgeführten Versionen getestet. Andere Versionen sind möglicherweise akzeptabel, wurden aber noch nicht getestet.

In der Quelle oder im Download enthalten:

Nicht in der Quelle oder im Download enthalten:

  • Zur Verwendung der SqlDataSourceHelper-Klasse mit einer MySQL-Datenbank benötigen Sie außerdem mysql.jar in Ihrer Laufzeitumgebung. Einzelheiten und herunterladbare Versionen finden Sie unter: http://www.mysql.com/products/connector/j/.

Bibliothek in der angegebenen Form verwenden

In diesem Abschnitt wird beschrieben, wie Sie die Java-Visualisierungsbibliothek verwenden, wenn Sie sie nicht ändern müssen. Dieser Prozess variiert je nach Build-System:

Wenn Sie Maven verwenden,richten Sie eine Abhängigkeit von der Visualisierungsbibliothek mit den folgenden Einstellungen ein:

  • Gruppen-ID: com.google.visualization
  • Artefakt-ID: Visualization-Datenquelle
  • Versionsnummer: Verwenden Sie die neueste Versionsnummer, die auf der Projektseite aufgeführt ist.

Wenn Sie ein anderes Build-System verwenden:

Beispiele ausführen

Die JAR-Beispieldateien sind zusammen mit den Bibliotheks-JARs in der herunterladbaren ZIP-Datei enthalten. Eine Anleitung zum Ausführen der Beispiele finden Sie auf der Seite Erste Schritte.

Bibliothek ändern

Wenn du den Bibliothekscode ändern möchtest, musst du den Quellcode von der Open-Source-Hosting-Website herunterladen und erstellen. Lesen Sie vorher die Lizenzinformationen, die im Abschnitt „Code-Lizenz“ auf der Projektseite verlinkt sind. Dort erfahren Sie, ob Ihr Anwendungsfall zulässig ist.

So können Sie die Bibliothek herunterladen und erstellen:

  1. Lade den Quellcode mit SVN herunter, wie auf der Open-Source-Projektseite auf dem Tab Quelle > Bezahlvorgang beschrieben.
  2. Erstellen Sie Ihren Code. Bei der Erstellung in Maven verwenden Sie die mit der Quelle bereitgestellte Datei pom.xml. Wenn Sie für den Build mit Apache Ant sorgen, folgen Sie der unten stehenden Anleitung. Der Code wurde mit der Ant-Version 1.7.0 getestet. Wenn Sie eine ältere Version von Ant haben, müssen Sie möglicherweise ein Upgrade ausführen.

Anweisungen zum Bau von Ameisen

1. Passen Sie die Build-Attribute an:

  1. Wechseln Sie zum Unterverzeichnis build-src des ausgewählten Installationsverzeichnisses.
  2. Öffnen Sie die Datei build.properties mit einem Texteditor und nehmen Sie folgende Änderungen vor:
    • Bearbeiten Sie das Attribut servlet-api.jar so, dass es auf die Datei servlet-api.jar verweist. Wenn Sie beispielsweise Tomcat auf dem Laufwerk c: im Verzeichnis tomcat_home installiert haben, geben Sie das Attribut servlet-api.jar so an:
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      Hinweis: Verwenden Sie im Dateipfad auch unter Windows Schrägstriche statt umgekehrter Schrägstriche.

    • Wenn Sie Ihre eigenen Kopien der oben beschriebenen Abhängigkeiten verwenden möchten, bearbeiten Sie die Pfade in derselben build.properties-Datei.

2. Erstellen Sie die Bibliothek:

Gehen Sie in der Datei durch das Unterverzeichnis build-src und geben Sie eine der folgenden Optionen ein:

  • ant datasource – Erstellt die Datenquellenbibliothek
  • ant example – Erstellt die Beispiele
  • ant – Erstellt sowohl die Datenquelle als auch Beispiele
  • ant test – Erstellt die Tests der Datenquellenbibliothek und führt sie aus. Das ist sehr nützlich, wenn Sie die Bibliothek ändern.

Zum Open-Source-Projekt beitragen

Wenn Sie Änderungen am Open-Source-Projekt beitragen möchten, benötigen Sie Berechtigungen zum Senden für das Projekt. Senden Sie eine E-Mail an google-visualization-api@googlegroups.com und bitten Sie um Ihre Einwilligung und um eine Anleitung zum Senden von Änderungen.