Create a Project
Released with the web service framework are tools to simplify authoring new web services and clients.
This project example creates a simple web service that performs basic math operations.
|
|
This service is for illustration purposes only and is not the type of thing you would typically use Info*Engine to accomplish.
|
Create your project using the <Windchill>/bin/adminTools/WebServices/new-project.xml Apache Ant build script. This script can be used to create a client project, a service project, or both:
% cd <Windchill>
% mkdir prog_examples/jws/MyProject
% ant -Dproject.dir=<Windchill>/prog_examples/jws/MyProject -Dservlet.name=MathService
-Dsecurity.policy=userNameAuthSymmetricKeys -Dservice.type.id=org.myorg.MathService
-Dmain.class=org.myorg.MathClient
-f bin/adminTools/WebServices/new-project.xml create
|
|
The project.dir property is an absolute path so that the project is created in the appropriate location. To see what input options are supported by the new-project.xml build script, you should run it with no arguments. For example:
ant -f bin/adminTools/WebServices/new-project.xml
|
This creates the following structure within the prog_examples/jws/MyProject directory:
• src/
The base directory for your web service (server-side).
• src/build.xml
The build script used to build and deploy your web service.
• src/tasks/org/myorg/MathService
A subdirectory where you can create your Info*Engine tasks. This is only a suggestion; you can create another directory hierarchy that suits your needs if desired. The tools package your service using the type identifier you specified on the service.type.id property when creating the project.
• src_client/
The base directory for your web service client.
• src_client/build.xml
The build script used to build your web service client.
• src_client/org/myorg/MathClient.java
The beginnings of your web service client.
Review the contents of the two generated build.xml scripts to gain some understanding on how they work.
To further familiarize yourself with the framework from within the src and src_client directories, run the following ant commands:
% ant -p
% ant usage
The first command displays the public targets for the associated build script with their descriptions. The second command provides a detailed description of how you can tailor your build script if you find it necessary to do so. For most basic projects this should not be necessary.
