...
- Constructor methods - the following forms of constructor are defined:
ServiceName(URL wsdlLocation, QName serviceName)
constructs a service object based on the data in the serviceName service in the WSDL contract that is obtainable from wsdlLocation.ServiceName()
is the default constructor, which constructs a service object based on the service name and WSDL contract that were provided at the time the stub code was generated (for example, when running the CeltiXfire CXF wsdl2java command). Using this constructor presupposes that the WSDL contract remains available at its original location.
get_PortName_()
methods - for every PortName port defined on the ServiceName service, CXF generates a correspondingget_PortName_()
method in Java. Therefore, awsdl:service
element that defines multiple ports will generate a service class with multipleget_PortName_()
methods.
...
The Client.main()
function proceeds as follows:</para>
- The CXF runtime is implicitly initialized - that is, provided the CXF runtime classes are loaded. Hence, there is no need to call a special function in order to initialize CXF.
- The client expects a single string argument that gives the location of the WSDL contract for HelloWorld. The WSDL location is stored in
wsdlURL
. - A new port object (which enables you to access the remote server endpoint) is created in two steps, as shown in the following code fragment:
To create a new port object, you first create a service object (passing in the WSDL location and service name) and then call the appropriateCode Block SOAPService ss = new SOAPService(wsdlURL, SERVICE_NAME); Greeter port = ss.getSoapPort();
get PortName ()
method to obtain an instance of the particular port you need. In this case, theSOAPService
service supports only theSoapPort
port, which is ofGreeter
type. - The client proceeds to call each of the methods supported by the
Greeter
service endpoint interface. - In the case of the
pingMe()
operation, the example code shows how to catch thePingMeFault
fault exception.
...
- Request context - on the client side, the request context enables you to set properties that affect outbound messages. Request context properties are applied to a specific port instance and, once set, the properties affect every subsequent operation invocation made on the port, until such time as a property is explicitly cleared. For example, you might use a request context property to set a connection timeout or to initialize data for sending in a header.</para>
- Response context - on the client side, you can access the response context to read the property values set by the inbound message from the last operation invocation. Response context properties are reset after every operation invocation. For example, you might access a response context property to read header information received from the last inbound message.
...
Code Block | ||
---|---|---|
| ||
<bindings xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" wsdlLocation="<at:var at:name="WSDL_LOCATION" />/hello_world_async.wsdl" xmlns="http://java.sun.com/xml/ns/jaxws"> <bindings node="wsdl:definitions"> <enableAsyncMapping>true</enableAsyncMapping> </bindings> </bindings> |
<para>Where Where AffectedWSDLContract specifies the URL of the WSDL contract that is affected by this binding declaration. The AffectedNode is an XPath value that specifies which node (or nodes) from the WSDL contract are affected by this binding declaration. You can set AffectedNode to wsdl:definitions
, if you want the entire WSDL contract to be affected. The {jaxws:enableAsyncMapping}} element is set to true
to enable the asynchronous invocation feature.
...