Web Service Control Template
Introduction
Use the web service control template (located at <BeehiveRoot>/samples/controls-webservices-blank) as a starting point for your web service control.
A web service control makes it easy for other applications to become clients of the target web service.
Generating a Service Control
To generate a service control you will need a WSDL file from the target web service.
Drop the WSDL file (along with any other schemas required by the web service) into the schemas directory (<BeehiveRoot>/samples/controls-webservices-blank/schemas).
Run the ant target ant build to generate a JAR for the service control. The build generates the types used by the web service along with the control interfaces and compiles them into a JAR file. The final service control JAR is saved in the build directory.
The controls-webservice-blank sample contains the WSDL file for the EnhancedAddressBookWS sample, but the web service doesn't need to be running to generate its service control.
Junit Testing
The controls-webservice-blank shows how to write junit tests for the service control, but it is not mandatory to have junit tests for a control.
The junit tests call the web service using the control interfaces generated based on the WSDL. The tests add an entry and retrieve it to verify the web service. To run the junit tests make sure you have the EnhancedAddressBookWS (or whichever target web service) up and running.
To run the junit tests run the target: ant run.junit