Installer la bibliothèque Java de source de données

Cette page explique comment utiliser ou modifier la bibliothèque Java Google Visualization, et comment contribuer au code Open Source du projet.

Contenus

  1. Conditions requises
  2. Dépendances
  3. Utiliser la bibliothèque fournie
  4. Exécuter les exemples
  5. Modifier la bibliothèque
  6. Contribuer au projet Open Source

Conditions requises

Pour utiliser la bibliothèque Java de visualisation Google, vous devez disposer des composants suivants:

  • Un conteneur de servlet et l'API Servlet version 2.4 ou ultérieure L'un des conteneurs de servlets les plus couramment utilisés est Apache Tomcat, qui inclut l'API Servlet. Consultez la page http://tomcat.apache.org/download-55.cgi pour télécharger le binaire de la version 5.5. Il vous suffit d'installer le module Core. Vous avez également besoin de Tomcat pour terminer les sections du tutoriel : Premiers pas, Utiliser un datastore externe et Définir les fonctionnalités et le flux d'événements.
  • Le kit de développement Java version 6.0 ou ultérieure

    Remarque: Il est également possible d'utiliser le JDK version 5.0. Toutefois, vous devez ensuite supprimer @Override de chaque méthode de la bibliothèque qui remplace une méthode d'interface. Cela est dû à la modification du comportement d'annotation @Override dans la version 6.0 du JDK.

Dépendances

La bibliothèque Java de la source de données comporte les dépendances suivantes. La bibliothèque a été testée avec les versions répertoriées. D'autres versions peuvent être acceptables, mais n'ont pas été testées.

Inclus dans la source ou le téléchargement :

Non inclus dans la source ni dans le téléchargement:

  • Pour utiliser la classe SqlDataSourceHelper avec une base de données mySQL, vous avez également besoin de mysql.jar dans votre environnement d'exécution. Pour en savoir plus et obtenir des versions téléchargeables, consultez la page http://www.mysql.com/products/connector/j/.

Utiliser la bibliothèque fournie

Cette section explique comment utiliser la bibliothèque Java de visualisation si vous n'avez pas besoin de la modifier. Ce processus varie selon votre système de compilation:

Si vous utilisez Maven, configurez une dépendance à la bibliothèque de visualisations avec les paramètres suivants:

  • ID du groupe: com.google.visualization
  • ID de l'artefact: visualisation-datasource
  • Numéro de version: utilisez le numéro de version le plus récent indiqué sur la page du projet.

Si vous utilisez un autre système de compilation:

Exécuter les exemples

Les fichiers d'exemple JAR sont inclus avec les fichiers JAR de la bibliothèque dans le fichier ZIP téléchargeable. Des instructions sur l'exécution des exemples sont disponibles sur la page Premiers pas.

Modifier la bibliothèque

Si vous souhaitez modifier le code de la bibliothèque, vous devez télécharger la source sur le site d'hébergement Open Source et la compiler. Avant de commencer, consultez les informations de licence liées à la section "Licence de code" sur la page du projet pour voir si votre cas d'utilisation est autorisé.

Pour télécharger et créer la bibliothèque, procédez comme suit:

  1. Téléchargez le code source à l'aide de SVN, comme décrit dans l'onglet Source > Règlement de la page du projet Open Source.
  2. Compilez votre code. Si vous compilez dans Maven, utilisez le fichier pom.xml fourni avec la source. Si vous utilisez Apache Ant, suivez les instructions suivantes (notez que le code a été testé avec Ant version 1.7.0). Si vous possédez une version antérieure d'Ant, vous devrez peut-être effectuer une mise à niveau.

Instructions de conception des fourmis

1. Modifiez les propriétés de votre build :

  1. Accédez au sous-répertoire build-src du répertoire d'installation choisi.
  2. À l'aide d'un éditeur de texte, ouvrez le fichier build.properties et apportez les modifications suivantes :
    • Modifiez la propriété servlet-api.jar pour qu'elle pointe vers votre fichier servlet-api.jar. Par exemple, si vous avez installé Tomcat sur votre disque c: dans le répertoire tomcat_home, vous devez spécifier la propriété servlet-api.jar comme suit:
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      Remarque : Utilisez des barres obliques plutôt que des barres obliques inverses dans le chemin d'accès du fichier, même sous Windows.

    • Pour utiliser vos propres copies des dépendances décrites ci-dessus, modifiez les chemins d'accès dans le même fichier build.properties.

2. Créez la bibliothèque:

Accédez au sous-répertoire build-src du fichier et saisissez l'un des éléments suivants:

  • ant datasource : crée la bibliothèque de sources de données
  • ant example : crée les exemples.
  • ant : crée à la fois une source de données et des exemples
  • ant test : crée et exécute les tests de la bibliothèque de sources de données. Très utile lorsque vous modifiez la bibliothèque.

Contribution au projet Open Source

Si vous souhaitez apporter des modifications au projet Open Source, vous devez obtenir les autorisations d'envoi au projet. Envoyez un e-mail à l'adresse google-visualization-api@googlegroups.com pour demander votre autorisation et des instructions sur l'envoi de modifications.