WebService Data Provider

The WebService DataProvider that invokes a soap webservice using JAX-WS and returns the first org.w3c.dom.Element child of the body of the soap response.
Builds up the request based on the configuration of the DataControl in the DataControl.dcx.

The following parameters can be set on the Data Provider:

endPointUrl

The endpoint-url of the WebService.

endPointConnection

The URL Endpoint connection of the WebService.

soapAction

The (optional) SOAPAction http request header.

soapVersion

The (optional) soapVersion (1.1 or 1.2). When not specified the more common 1.1 will be used.

handlerResolverClass

Specifies an (optional) implementation of javax.xml.ws.handler.HandlerResolver which can be used to further customize the webservice request and/or response.

requestElement

The SOAP Body Request Element for the WebService call. This is typically not a fixed XML snippet but will contain some Dynamic Parameters.

headerElement

The (optional) SOAP Header Element for the WebService call.

soapHandlers

Specifies a list of SoapHandlers.

invocationType

The invocation-type (oneWay or Synchronous). When not specified the more common Synchronous will be used. 

connectTimeout

Specifies the connect timeout in milliseconds or -1 to disable timeout and wait forever. This is the maximum time allowed to setup the network connection with the server being invoked. See Default Parameters on how to set a default value for this parameter for each web service data control in your project without having to explicitly set this for each data control.

requestTimeout

Specify the total request timeout in milliseconds or -1 to disable timeout and wait forever. This is the maximum time allowed for the request to fully complete and respond with data. See Default Parameters on how to set a default value for this parameter for each web service data control in your project without having to explicitly set this for each data control.

 

Data Control
   <AdapterDataControl id="HrWSData" FactoryClass="oracle.adf.model.adapter.DataControlFactoryImpl"
                        ImplDef="org.adfemg.datacontrol.xml.DataControlDefinition" SupportsTransactions="false"
                        SupportsSortCollection="false" SupportsResetState="false" SupportsRangesize="false"
                        SupportsFindMode="false" SupportsUpdates="false"
                        Definition="org.adfemg.xmldc.demo.view.HrWSData" BeanClass="org.adfemg.xmldc.demo.view.HrWSData"
                        xmlns="http://xmlns.oracle.com/adfm/datacontrol">
        <Source>
            <definition xmlns="http://adfemg.org/adfm/datacontrol/configuration"
                        schema="http://xmldc-sample.appspot.com/HR.xsd" schema-root="DepartmentEmployeesResponse"
                        dc-operation="getDeptEmps">
                    <data-provider class="org.adfemg.datacontrol.xml.provider.data.WSDataProvider">
                        <parameters>
                            <parameter name="endPointUrl"
                                       value="http://xmldc-sample.appspot.com/HumanResourcesService"/>
                            <xml-parameter name="requestElement">
                            <![CDATA[
                               <hr:DepartmentEmployeesRequest xmlns:hr="http://adfemg.org/HR">
                                 <hr:departmentId>#{param.deptId}</hr:departmentId>
                               </hr:DepartmentEmployeesRequest>
                              ]]>
                            </xml-parameter>
                            <dynamic-parameter name="deptId" java-type="java.lang.Long"/>
                        </parameters>
                    </data-provider>
            </definition>
        </Source>
    </AdapterDataControl>