Sun Java System Portal Server 7.1 Technical Reference

SimpleWebServiceProvider

SimpleWebServiceProvider, an extension of JSPProvider, makes simple web services available to an end user channel. SimpleWebServiceProvider dynamically constructs a user interface given a Web Services Description Language (WSDL) URL and a web service method name.

Using the URL, SimpleWebServiceProvider fetches the WSDL document, parses and validates it. Based on its content, SimpleWebServiceProvider generates input parameters to the method that return the information from the web service. The information is then displayed in the channel content window.

SimpleWebServiceProvider can generate channels that use the same web service, and the same method, so default parameter values can be stored using the Edit function.

SimpleWebServiceProvider supports basic data types such as String, int, and float as defined in the WSDL specification. It supports Complex Types if they are made up of only basic types (one level of nesting). There is no support for arrays.

SimpleWebServiceProvider can provide WSDL parsing for any other provider that needs it. SimpleWebServiceProvider is designed for stock quote or currency exchange rate content.

The list of properties specific to SimpleWebServiceProvider and their description are:

String name="wsdlURL"

Specifies the URL to web service WSDL.

String name="methodName"

Specifies the web service method name that is going to be executed.

Boolean name="isDefaultShowOutput"

Specifies the default value. If true, the channel uses the default input value. If false, the channel uses the user input value.

String name="contentPage"

Specifies the JSP that is used to generate the channel content (by using the getContent() method).

String name="editPage"

Specifies the JSP that is used to generate the Edit page content (by using the getEdit() method).

Boolean name="showExceptions"

If true, makes SimpleWebServiceProvider show exceptions generated while processing the JSP as the channel output for the getContent() and getEdit() methods. This can be useful for developing and troubleshooting your portal.

Boolean name="isDefaultAvailable"

If true, the default value is available from the profile database.

Collection name="defaultInput"

Specifies the default input value.

SimpleWebServiceConfigurableProvider

SimpleWebServiceConfigurableProvider is similar to SimpleWebServiceProvider, except that it permits users to use the Edit function to change URLs and methods, hence, it is configurable.

The list of properties specific to SimpleWebServiceConfigurableProvider and their description are:

String name="wsdlURL"

Specifies the URL to web service WSDL.

String name="methodName"

Specifies the web service method name that is going to be executed.

Boolean name="isDefaultShowOutput"

Specifies the default value. If true, the channel uses the default input value. If false, the channel uses the user input value.

String name="contentPage"

Specifies the JSP that is used to generate the channel content (by using the getContent() method).

String name="editPage"

Specifies the JSP that is used to generate the Edit page content (by using the getEdit() method).

Boolean name="showExceptions"

If true, makes SimpleWebServiceConfigurableProvider show exceptions generated while processing the JSP as the channel output for the getContent() and getEdit() methods. This can be useful for developing and troubleshooting your portal.

Boolean name="isDefaultAvailable"

If true, the default value is available from the profile database.

Collection name="defaultInput"

Specifies the default input value.