Avril 2008
- Introduction
- Configurer Eclipse
- Installer les bibliothèques requises
- Créer une application
- Conclusion
Nouveau Plug-in Eclipse client Java des API Google Data : créez des projets en quelques secondes
En complément de cet article, un plug-in Eclipse est disponible afin de minimiser les frais liés à la configuration des dépendances Google Data. Elle crée également un code récurrent permettant d'interagir avec l'API qui vous intéresse. Cela vous permet de commencer facilement à développer avec les API Google Data.
- Vidéo de présentation
- Télécharger
- Installation du plug-in
- Démarrer un nouveau projet d'API Google Data
Introduction
Eclipse est un outil très pratique (et sans frais !) IDE qui occupe une place particulière dans de nombreux programmeurs Java. Il n'est donc pas surprenant que vous souhaitiez l'utiliser avec la bibliothèque cliente Java pour créer une application Java qui fonctionne avec l'une des API Google Data.
Configurer Eclipse
Si vous n'avez pas encore installé Eclipse, vous avez peut-être manqué l'atelier. Eclipse peut faciliter le développement Java en raison de sa capacité à suggérer des correctifs, à rechercher les importations manquantes et aux méthodes de saisie semi-automatique. Accédez à la page de téléchargements d'Eclipse.org pour obtenir le programme d'installation pour votre système d'exploitation. Pour exécuter Eclipse, vous devez avoir installé JRE, qui est accessible depuis la page de téléchargement d'Eclipse. Une fois Eclipse installé, vous devez créer un espace de travail. Ces exemples utilisent /usr/local/eclipse/workspace
.
Installer les bibliothèques requises
Comme Eclipse fournit de nombreuses fonctionnalités Java prêtes à l'emploi, cela devrait être facile. Commencez par récupérer la dernière version de la bibliothèque cliente Java sur la page des téléchargements du projet. Notez qu'il existe deux téléchargements distincts: un pour les exemples et un pour le code source. Téléchargez le fichier ZIP contenant les exemples, car il contient les fichiers JAR compilés de la bibliothèque cliente Java nécessaire à la création de vos propres programmes. Si vous souhaitez en savoir plus sur le fonctionnement de la bibliothèque cliente, vous pouvez télécharger le fichier ZIP source et l'examiner. Cela dépasse le cadre de cet article. Une fois que vous avez téléchargé les fichiers ZIP, décompressez le fichier dans un répertoire pratique où vous trouverez les fichiers. Les exemples utilisent /usr/local/eclipse
. Cela signifie que les fichiers JAR du projet devraient maintenant être accessibles sous /usr/local/eclipse/gdata/java/lib
.
Maintenant que vous avez installé la bibliothèque cliente, la prochaine étape consiste à télécharger des dépendances externes afin que nous puissions les inclure dans le chemin de compilation du projet. Le fichier INSTALL-samples.txt
contient la liste des fichiers JAR dont vous avez besoin et les emplacements où vous pouvez les télécharger. Voici la liste actuelle:
Nom de fichier | Emplacement |
---|---|
mail.jar | API JavaMail de Sun |
activation.jar | Framework d'activation Java Beans de Sun |
servlet-api.jar | Apache Tomcat |
Dans cet exemple, ces fichiers JAR sont téléchargés et copiés dans /usr/local/eclipse/gdata/third_party
.
Ouf ! Vous devriez maintenant disposer de tous les éléments nécessaires pour commencer à développer une application Java qui utilise l'une des API de données Google. Lisez la suite.
Créer une application
La première étape consiste à ouvrir Eclipse et à sélectionner "Nouveau > Projet Java" dans le menu "Fichier".
![Fenêtre du nouveau projet Eclipse](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=19&hl=fr)
Maintenant, cliquez sur "Suivant" et sélectionnez l'onglet "Bibliothèques". Ajoutez tous les fichiers JAR dépendants que vous avez téléchargés en cliquant sur "Ajouter des fichiers JAR externes".
![Ajouter des fichiers JAR de dépendance](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=19&hl=fr)
Vous devrez également ajouter les fichiers JAR à partir de la bibliothèque cliente Java. Ils se trouvent dans le sous-répertoire java/lib
de l'emplacement où vous avez extrait la bibliothèque cliente. Vous devrez toujours inclure les fichiers JAR suivants: gdata-client, gdata-client-meta, gdata-core et gdata-media.
![Ajouter des fichiers JAR GData](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=19&hl=fr)
Choisissez maintenant l'API que vous souhaitez utiliser. Cet exemple utilise l'API Google Documents List. Pour cela, vous devez ajouter les fichiers JAR appropriés: gdata-docs et gdata-docs-meta.
![Ajouter des fichiers JAR DocList](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=19&hl=fr)
Enfin, cliquez sur "Finish" (Terminer) et créez votre projet.
![Le nouveau projet](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=19&hl=fr)
Pour créer une application de test simple, créez une classe avec une méthode principale en sélectionnant "Nouveau > Classe" dans le menu "Fichier".
![Créer un cours](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=19&hl=fr)
Je vais maintenant coller du code issu du Guide du développeur pour l'API Documents List.
![Exemple de code comportant des erreurs](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=19&hl=fr)
Vous verrez de nombreuses erreurs jusqu'à ce que vous ajoutiez les instructions d'importation appropriées. Avec Eclipse, il vous suffit de cliquer sur les repères d'erreur sur la gauche pour faire apparaître un menu utile qui vous permet d'ajouter des importations.
![Le menu Quickfix](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=19&hl=fr)
Une fois les importations nettoyées, vous devez également gérer les exceptions qui peuvent être générées par notre code. Dans cet exemple, l'intégralité du code d'exemple est entourée d'un gestionnaire d'exceptions très rudimentaire.
![Exemple de code fonctionnel](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=19&hl=fr)
En supposant que vous remplaçiez le nom d'utilisateur et le mot de passe par un compte de test valide que vous avez créé, vous devriez maintenant pouvoir consulter une liste des documents appartenant à ce compte de test lorsque vous sélectionnez "Exécuter" dans le menu "Exécuter".
![Le résultat du programme](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=19&hl=fr)
Parfait !
Conclusion
Maintenant que vous disposez d'une instance de travail Eclipse et de tous les fichiers JAR requis, vous êtes prêt à créer une application Java efficace qui fonctionne avec l'une des API de données Google.
Étapes suivantes Voici quelques liens utiles:
- Plug-in Clients Java des API Google Data
- Documentation du protocole de données Google sur code.google.com
- Projet de bibliothèque cliente Java Google Data
- Guide de démarrage de la bibliothèque cliente Java
- Documentation JavaDoc
Java est une marque de Sun Microsystems, Inc. aux États-Unis et dans d'autres pays.