Deploy Your Web Service
When this project was created, a parameter named security.policy was supplied, for which the value of userNameAuthSymmetricKeys was explicitly passed. Therefore, for this example you must provide both a username and a password to your web service client.
To generate and deploy your web service, run the following commands:
% cd <Windchill>/prog_examples/MyProject/src
% ant
|
|
Windchill does not need to be active to run the Apache Ant script.
|
At this point start (or restart) Windchill to finish deployment.
When run with no arguments, the Apache Ant script packages, installs, and deploys your web service:
• The service is packaged, compiled, and installed in Windchill. In the case of an Info*Engine task-based service, your tasks are packaged into a PTCTAR file and installed. In this example, the resulting PTCTAR file is:
<Windchill>/prog_examples/jws/MyProject/dist_server/mathservice.ptctar
If your web service requires Java objects, then you can simply create the package hierarchy and source for those objects within the src directory. The script automatically compiles and package those classes for you. Classes associated with your web service are packaged in <Windchill>/codebase/WEB-INF/lib within a JAR file that reflects the servlet name of your service.
• The
<Windchill>/bin/adminTools/WebServices/build.xml script is then run to generate and compile the server-side artifacts, as well as secure and deploy the web service. This build script can also be run on its own, depending on your needs. For more information, see
Using the Web Service Deployment Build Script.
|
|
If you use the Apache Ant framework you should not need to run this build script manually. The Apache Ant framework can also be used to deploy an existing legacy web service that is already installed on your system. In this case the src directory contains only the build.xml script and no task source.
|
Now that your service is deployed and Windchill is running, you can review your web service WSDL by visiting a URL similar to the following:
http://<host>/Windchill/servlet/MathService?wsdl
If you are writing a Java client, as described in
Writing a Java-based Web Service Client, then you do not need to know how to access the WSDL. However, you must access it if you plan to integrate your service with another web service client.
