English

Web Data Service - WDS Java Toolkit 1.2.0

Reviewed: 2010-04-16

Revision History

- 2010-04-16 Reviewed documentation
- 2007-11-16 Version 1.2.0 release
- New implementation of WDS interface (wds-1.0.0v1.0.4)
- Correction minor problems
- New JAVA client (wdsclient-1.0.0v1.4.0)
- Addition of a method createMetadataHashmap()
- Addition of a support sessions
- New template for WDS creation (wds_service_template-1.0.0v1.1.0)
- Improved documentation
- Improved configuration for metadata
- Addition of a support sessions
- 2007-06-08 Version 1.1 release
- New implementation of WDS interface (wds1.0.0v1.0.2)
- New JAVA client (wdsclient1.0.0v1.3.0)
- New template for WDS creation
- Addition of an OWS GeoServer extention
- 2006-04-01 Version 1.0 release

Introduction

This toolkit, to be used in the Java environment, includes all components required for the development, the access and the exploitation of a Java WDS service.


WDS Server architecture

The architecture is based on the Axis SOAP server which is an open source software developed by Apache. A Java application server is required in order to execute Axis. The Tomcat Java application server from Apache can be used and is also open source.

How to create a Web Data Service

The creation of a JAVA WDS service has been simplified by the development of a library that implements the WDS interface and ensures that the WDS COOKBOOK rules are respected. The implementation of the JAVA WDS interface and its deployment on a SOAP server contributes to making a WDS service available on-line. In order to facilitate development, a WAR template with the AXIS SOAP server is available.

Javadoc: html

WAR Template

The template is a WAR (zip) file including a fully functional and deployable WDS service. To use it, include it in any IDE project. Consult the class WEB-INF/classes/Service.java to learn how to personalize the service.

Template: wds_service_template-1.0.0v1.1.0.war

Eclipse IDE

Web development in Eclipse requires the Web Tools Plateform (WTP) plugin. The JAVA Tomcat application server must also be installed on the computer and must be configured in Eclipse (Window/preferences/server/Installed Runtimes).  The Servers view allows for a good interaction with Tomcat (Window/Show View/Other/Server/Servers).

To import the project in Eclipse, download the template and import the WAR project (File/Import/Web/WAR file).  During the import, it is important to specify the project name. Eclipse uses the WAR file name as a default.

To run the service, execute the project (Run).  A Tomcat server will start; administration can be done using the "Servers" view. In this view, right-click on the Tomcat server, select "Add and Remove Projects" and add a project.
Below are a few examples using a project named “test” that can be used to verify the availability of a service using a Web browser and Axis functionalities:


- Axis: http://localhost:8080/test
- Available services: http://localhost:8080/test/services
- Your service : http://localhost:8080/test/services/wds
- Method getStatus(): http://localhost:8080/test/services/wds?method=getStatus

How to connect to a Web Date Service

Most JAVA IDE can generate a SOAP client.