Datenquelle der Java-Bibliothek installieren

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

Inhalt

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

Voraussetzungen

Sie benötigen die folgenden Komponenten, um die Google Visualization-Java-Bibliothek 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, das die Servlet API enthält. Unter http://tomcat.apache.org/download-55.cgi kannst du das Binärprogramm für Version 5.5 herunterladen. Sie müssen nur das Core-Modul installieren. Sie benötigen außerdem Tomcat, um die Anleitungsabschnitte Erste Schritte, Verwenden eines externen Datenspeichers und Definieren von Funktionen und Ereignisfluss abzuschließen.
  • Java Development Kit Version 6.0 oder höher.

    Hinweis: Sie können auch die JDK-Version 5.0 verwenden. Sie müssen dann jedoch @Override aus jeder Methode in der Bibliothek entfernen, die eine Schnittstellenmethode überschreibt. Dies liegt an der Änderung des Annotationsverhaltens @Override in 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 nicht getestet.

In der Quelle oder im Download enthalten:

Nicht in der Quelle oder beim Download enthalten:

  • Wenn Sie die Klasse SqlDataSourceHelper mit einer MySQL-Datenbank verwenden möchten, benötigen Sie außerdem mysql.jar in Ihrer Laufzeitumgebung. Weitere Informationen und herunterladbare Versionen finden Sie unter http://www.mysql.com/products/connector/j/.

Bereitgestellte Bibliothek verwenden

In diesem Abschnitt wird beschrieben, wie Sie die Visualisierungs-Java-Bibliothek verwenden können, wenn Sie sie nicht ändern müssen. Dieser Vorgang 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 Sie den Bibliothekscode ändern möchten, müssen Sie den Quellcode von der Open-Source-Hosting-Website herunterladen und erstellen. Lesen Sie vorher die Informationen zur Lizenzierung, die im Abschnitt „Codelizenz“ auf der Projektseite verlinkt sind. Dort erfahren Sie, ob Ihr Anwendungsfall zulässig ist.

So laden Sie die Bibliothek herunter und erstellen sie:

  1. Lade den Quellcode mithilfe von SVN herunter. Eine Beschreibung dazu findest du auf dem Tab Quelle > Kasse auf der Open-Source-Projektseite.
  2. Code erstellen Verwenden Sie beim Erstellen in Maven die mit der Quelle bereitgestellte Datei pom.xml. Wenn Sie mit Apache Ant arbeiten, folgen Sie der nächsten Anleitung. Der Code wurde mit Ant Version 1.7.0 getestet. Wenn Sie eine frühere Version von Ant verwenden, müssen Sie möglicherweise ein Upgrade ausführen.

Anleitung für Ameisenbau

1. Ändern Sie Ihre Build-Attribute:

  1. Rufen Sie das Unterverzeichnis build-src des ausgewählten Installationsverzeichnisses auf.
  2. Öffnen Sie die Datei build.properties in einem Texteditor und nehmen Sie die folgenden Ä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 Schrägstriche anstelle von umgekehrten Schrägstrichen, auch unter Windows.

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

2. Erstellen Sie die Bibliothek:

Rufen Sie das Unterverzeichnis build-src in der Datei auf und geben Sie einen der folgenden Werte ein:

  • ant datasource – Erstellt die Datenquellenbibliothek
  • ant example – Erstellt die Beispiele
  • ant – Erstellt Datenquelle und Beispiele
  • ant test: Erstellt und führt Tests für die Datenquellenbibliothek aus. Dies ist sehr nützlich, wenn Sie die Bibliothek ändern.

Beitrag zum Open-Source-Projekt

Wenn Sie Änderungen für das Open-Source-Projekt vornehmen möchten, benötigen Sie Berechtigungen zum Einreichen für das Projekt. Senden Sie eine E-Mail an google-visualization-api@googlegroups.com mit der Bitte um Berechtigung und Anweisungen zum Senden von Änderungen.