When you deploy a Web service in a servlet container or the Novell exteNd WSSDK Server (jwebserv), a default HTML page is provided when you hit the endpoint URL for the service in the browser. The screen shot below shows this page for the Hello World Web service:
As can be seen, this page has three links on it:
The first one is the WSDL document, which shows you the WSDL implemented by the service.
The second one is the Remote interface, which shows the Java remote interface generated for WSDL.
The fourth one is Test service, which produces HTML forms at runtime to invoke operations defined in the WSDL or in the remote interface.
If the deployed service has type mappings, there will be an additional link named Type mappings, which will show you which XML types are mapped to which Java classes.
If you click the link for the WSDL document, the WSDL file itself is returned:
Note that the WSDL file is automatically generated with default parameters if the
WSDL document is not packaged in the server's WAR file. The Web service's init
method would do the following to specify the WSDL file:
_setProperty("xmlrpc.wsdl", "my.wsdl");
The above code fragment will assume the WSDL is located in the WEB-INF/classes
directory of the WAR.
If you click the link for the Remote interface, the following page is displayed:
This page is generated by reflecting on the Java interface.
The test page allows you to enter information for the operation parameters and once all the information is collected, it invokes the operation and displays the results. After clicking the link a page with a list of operations is displayed:
After selecting an operation, the parameters must be entered. In this case there are no parameters and only the invoke button is shown:
When pressing invoke the result is displayed:
You have an option to disable this feature for security purposes. The
wssdk.test.disable
parameter in the deployment descriptor of the servlet
should be set to false in order to disable service testing.
The default GET behavior can be overridden by writing a doGet
method in the
servlet in the implementation. Please note that implementing doGet
will not
override the default GET behavior if you deploy the service in Novell exteNd WSSDK Server.
Copyright © 2003, 2004 Novell, Inc. All rights reserved. Copyright © 2001, 2002, 2003 SilverStream Software, LLC. All rights reserved.