English

Web Data Service - WDS Java Toolkit 1.2.0

Revisé le : 2010-04-16

Historique

- 2010-04-16 Mise à jour de la documentation
- 2007-11-16 Dépôt de la version 1.2.0
- Nouvelle implantation de l'interface WDS (wds-1.0.0v1.0.4)
    - Correction de problèmes mineures
- Nouveau client java (wdsclient-1.0.0v1.4.0)
- Ajout de la méthode createMetadataHashmap()
- Ajout du support des sessions
- Nouveau gabarit pour la création de WDS (wds_service_template-1.0.0v1.1.0)
- Amélioration de la documentation
- Amélioration de la configuration pour les métadonnées
- Ajout du support des sessions
- 2007-06-08 Dépôt de la version 1.1
- Nouvelle implantation de l'interface WDS (wds1.0.0v1.0.3)
- Nouveau client java (wdsclient1.0.0v1.3.0)
- Nouveau gabarit pour la création de WDS  (wds_service_template-1.0.0v1.0.0)
- Ajout d'une extension pour le serveur OWS GeoServer
- 2006-04-01 Dépôt de la version 1.0

Introduction

Le toolkit est un ensemble d'outils pour l'environnement Java incluant toutes les composantes pour développer, diffuser et exploiter un service WDS avec le langage Java.


Architecture d'un serveur Web Data Service (WDS)

L'architecture est basée sur le serveur SOAP Axis, c'est un logiciel libre développé par le groupe Apache. Axis est une application Web Java conventionnelle. Un serveur d'applications Java est nécessaire pour exécuter Axis. Le serveur d'applications Java Tomcat du groupe Apache peut être utilisé, il est également libre.

Comment créer un WDS

La création d'un service WDS en Java a été simplifiée par l'ajout d'une librairie implémentant l'interface WDS et s'assurant du respect des règles énumérées dans le WDS COOKBOOK.  L'implantation de l'interface java WDS et le déploiement sur un serveur SOAP de celle-ci permet de mettre en ligne un service WDS. Afin de simplifier le développement, un gabarit WAR avec le serveur SOAP Axis est disponible.

Javadoc : html

Gabarit WAR

Le gabarit est un fichier war (zip) contenant un service WDS entièrement fonctionnel et déployable.  Les bonnes pratiques en développement y sont déjà disponibles.  Pour l'utiliser, il suffit de l'inclure dans un projet de l'IDE de son choix.  Consultez la classe WEB-INF/classes/Service.java afin de connaître les directives à suivre pour la personnalisation du service.

Gabarit : wds_service_template-1.0.0v1.1.0.war

IDE Eclipse

Le développement Web dans Eclipse nécessite le plugin Web Tools Plateform (WTP). Le serveur d'application Java Tomcat doit également être installé sur l'ordinateur et configuré dans Eclipse (Window/preferences/server/Installed Runtimes).  La vue Servers permet une bonne interaction avec Tomcat (Window/Show View/Other/Server/Servers).

Pour importer le projet dans Eclipse, il suffit de télécharger le gabarit et d'importer le projet WAR (File/Import/Web/WAR file).  Au cours de l'importation, il est important de définir le nom du projet.  Par défaut, Eclipse utilise le nom du fichier WAR.

Pour lancer le service, il suffit d'exécuter le projet (Run).  Un serveur Tomcat sera démarré,  l'administration s'effectue par le biais de la vue "Servers".  Dans cette vue cliquez avec le bouton droit de la souris sur le serveur Tomcat, sélectionnez "Add and Remove Projects" et ajoutez votre projet.  Voici quelques exemples avec un projet nommé "test" afin de vérifier la disponibilité de votre service en utilisant un navigateur Web et les fonctionnalités de Axis :

- Axis : http://localhost:8080/test
- Services disponibles : http://localhost:8080/test/services
- Votre service : http://localhost:8080/test/services/wds
- Methode getStatus(): http://localhost:8080/test/services/wds?method=getStatus

Comment se connecter à un WDS

La plupart des IDE Java sont en mesure de générer un client SOAP.