Installer la bibliothèque Java de la 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.

Sommaire

  1. Conditions requises
  2. Dépendances
  3. Utiliser la bibliothèque telle qu'elle est 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 Google Visualization, vous devez disposer des composants suivants:

  • Un conteneur de servlet et l'API servlet, version 2.4 ou ultérieure. Apache Tomcat est l'un des conteneurs de servlet les plus couramment utilisés. Il inclut l'API servlet. Pour télécharger le binaire de la version 5.5, consultez la page http://tomcat.apache.org/download-55.cgi. Vous n'avez besoin d'installer que le module principal. Vous aurez également besoin de Tomcat pour suivre les sections du tutoriel: Premiers pas, Utiliser un data store externe et Définir des 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 la version 5.0 du JDK. Cependant, 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 de l'annotation @Override dans la version 6.0 du JDK.

Dépendances

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

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

Non inclus dans la source ou 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 connaître les versions téléchargeables, consultez la page http://www.mysql.com/products/connector/j/.

Utiliser la bibliothèque telle qu'elle est 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 visualisation avec les paramètres suivants:

  • ID du groupe: com.google.visualization
  • ID de l'artefact: Visualization-datasource
  • Numéro de version: utilisez le dernier numéro de version 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. Les instructions relatives à l'exécution des exemples sont fournies sur la page Premiers pas.

Modifier la bibliothèque

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

Voici les étapes à suivre pour télécharger et créer la bibliothèque:

  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 votre projet au format Maven, utilisez le fichier pom.xml fourni avec la source. Si vous effectuez la compilation avec Apache Ant, suivez les instructions ci-dessous. Notez que le code a été testé avec Ant version 1.7.0. Si vous disposez d'une version antérieure d'Ant, vous devrez peut-être effectuer une mise à niveau.

Instructions de fabrication avec fourmi

1. Modifiez les propriétés de compilation:

  1. Accédez au sous-répertoire build-src du répertoire d'installation de votre choix.
  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 du fichier, même si vous utilisez 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 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.

Contribuer au projet Open Source

Si vous souhaitez apporter des modifications au projet Open Source, vous devez obtenir des autorisations d'envoi pour ce projet. Envoyez un e-mail à google-visualization-api@googlegroups.com pour demander votre autorisation et obtenir des instructions sur la manière d'envoyer des modifications.