uCosminexus Application Server, Web Service Development Guide
This subsection describes the support range of the client APIs.
The following table describes the support range of the javax.xml.ws.BindingProvider interface. For details, see the JAX-WS 2.2 specifications.
Table 19-4 Support range of the javax.xml.ws.BindingProvider interface
| No. | Return value type | Method name/ Explanation | Support | |
|---|---|---|---|---|
| 1 | Binding | getBinding() | Y | |
| Description | Acquires binding of this binding provider. | |||
| 2 | EndpointReference | getEndpointReference() | N | |
| 3 | <T extends EndpointReference> T | getEndpointReference (java.lang.Class<T> clazz) | N | |
| 4 | java.util.Map <java.lang.String, java.lang.Object> | getRequestContext() | Y | |
| Explanation | Obtains the context used for initializing the message context of the request message. | |||
| 5 | java.util.Map <java.lang.String, java.lang.Object> | getResponseContext() | Y | |
| Explanation | Obtains the context acquired by the processing of the response message. If this method is invoked before the response message is processed, null is returned.Do not call this method for one-way operations as response messages are not available. Operation is not guerenteed if you use this method in the one-way operations. | |||
The following table describes the support range of the javax.xml.ws.Dispatch interface. For details, see the JAX-WS 2.2 specifications.
Table 19-5 Support range of the javax.xml.ws.Dispatch interface
| No. | Return value type | Method name | Support |
|---|---|---|---|
| 1 | T | invoke(T msg) | Y |
| 2 | Response<T> | invokeAsync(T msg) | N |
| 3 | java.util.concurrent.Future<?> | invokeAsync(T msg, AsyncHandler<T> handler) | N |
| 4 | void | invokeOneWay(T msg) | Y |
The following table describes the support range of the javax.xml.ws.EndpointReference class. For details, see the JAX-WS 2.2 specifications.
Table 19-6 Support range of the javax.xml.ws.EndpointReference class
| No. | Return value type | Method name | Support |
|---|---|---|---|
| 1 | -- | EndpointReference() | Y |
| 2 | <T> T | getPort (java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features) | N |
| 3 | static EndpointReference | readFrom (javax.xml.transform.Source eprInfoset) | Y |
| 4 | java.lang.String | toString() | N |
| 5 | abstract void | writeTo(javax.xml.transform.Result result) | N |
The following table describes the support range of the javax.xml.ws.Service class. For details, see the JAX-WS 2.2 specifications.
Table 19-7 Support range of the javax.xml.ws.Service class
| No. | Return value type | Method name/ Explanation | Support | |
|---|---|---|---|---|
| 1 | -- | Service(java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName) | Y | |
| Explanation | Constructor that generates the Service instance. | |||
| Argument |
|
|||
| Exception |
|
|||
| 2 | void | addPort(javax.xml.namespace.QName portName, java.lang.String bindingId, java.lang.String endpointAddress) | Y | |
| Note | You must specify the same QName for portName when you invoke createDispatch(). You cannot specify null. If you specify null in bindingId, the SOAP1.1/HTTP binding ID is set up. |
|||
| 3 | static Service | create(javax.xml.namespace.QName serviceName) | Y | |
| 4 | static Service | create(javax.xml.namespace.QName serviceName, javax.xml.ws.WebServiceFeature ... features) | N | |
| 5 | static Service | create(java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName) | Y | |
| Explanation | Generates the Service instance. | |||
| Argument |
|
|||
| Exception |
|
|||
| 6 | static Service | create(java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName, javax.xml.ws.WebServiceFeature ... features) | N | |
| 7 | <T> Dispatch<T> | createDispatch (EndpointReference endpointReference, java.lang.Class<T> type, Service.Mode mode, WebServiceFeature... features) | N | |
| 8 | Dispatch <java.lang.Object> | createDispatch (EndpointReference endpointReference, javax.xml.bind.JAXBContext context, Service.Mode mode, WebServiceFeature... features) | N | |
| 9 | <T> Dispatch<T> | createDispatch (javax.xml.namespace.QName portName, java.lang.Class<T> type, Service.Mode mode) | Y | |
| Note | In portName, you must specify the same port name as the name specified in the arguments of addPort(). You cannot specify null. | |||
| 10 | <T> Dispatch<T> | createDispatch (javax.xml.namespace.QName portName, java.lang.Class<T> type, Service.Mode mode, WebServiceFeature... features) | N | |
| 11 | Dispatch <java.lang.Object> | createDispatch (javax.xml.namespace.QName portName, javax.xml.bind.JAXBContext context, Service.Mode mode) | Y | |
| Note | In portName, you must specify the same port name as the name specified in the arguments of addPort(). You cannot specify null. | |||
| 12 | Dispatch <java.lang.Object> | createDispatch (javax.xml.namespace.QName portName, javax.xml.bind.JAXBContext context, Service.Mode mode, WebServiceFeature... features) | N | |
| 13 | java.util.concurrent.Executor | getExecutor() | N | |
| 14 | HandlerResolver | getHandlerResolver() | Y | |
| Explanation | Returns the HandlerResolver instance used by this Service instance. If the HandlerResolver instance does not exist, returns null. | |||
| 15 | <T> T | getPort (java.lang.Class<T> serviceEndpointInterface) | Y | |
| Explanation | Returns port (proxy for accessing the service). | |||
| Argument |
|
|||
| Exception |
|
|||
| 16 | <T> T | getPort (java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features) | N | |
| 17 | <T> T | getPort(EndpointReference endpointReference, java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features) | Y# | |
| Explanation | Returns port (proxy for accessing the service). | |||
| Argument |
|
|||
| Exception |
|
|||
| 18 | <T> T | getPort(javax.xml.namespace.QName portName, java.lang.Class<T> serviceEndpointInterface) | Y | |
| Explanation | Returns port (proxy for accessing the service). | |||
| Argument |
|
|||
| Exception |
|
|||
| 19 | <T> T | getPort(javax.xml.namespace.QName portName, java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features) | N | |
| 20 | java.util.Iterator <javax.xml.namespace.QName> | getPorts() | Y | |
| Explanation | Returns the Iterator of the QName list indicating the service end point (port included in WSDL (wsdl:port element)). | |||
| Exception |
|
|||
| 21 | javax.xml.namespace.QName | getServiceName() | Y | |
| Explanation | Returns this service name (WSDL service name (name attribute value of the wsdl:service element)). | |||
| 22 | java.net.URL | getWSDLDocumentLocation() | Y | |
| Explanation | Returns the location of the WSDL file for this service. Returns null when the Service.create() method is invoked for the Service instance generated by specifying null in the argument wsdlDocumentLocation. | |||
| 23 | void | setExecutor (java.util.concurrent.Executor executor) | N | |
| 24 | void | setHandlerResolver (HandlerResolver handlerResolver) | Y | |
| Explanation | Set the HandlerResolver instance of this Service instance. | |||
Table 19-8 Specification methods and operations for the variable length arguments
| No. | Specification method | Specification example | Operation |
|---|---|---|---|
| 1 | Argument is omitted | getPort(epr, sei) | Operation is performed considering that no variable length argument is specified. |
| 2 | One argument is specified | getPort(epr, sei, new FooFeatures()) | Operation is performed considering that one variable length argument is specified. |
| 3 | Two arguments are specified | getPort(epr, sei, new FooFeatures(), new BarFeatures()) |
Operation is performed considering that two variable length arguments are specified. |
| 4 | null is specified in the argument | getPort(epr, sei, null) | Operation is performed considering that no variable length argument is specified. |
| 5 | null is specified in the argument and cast in the WebServiceFeature type array | getPort(epr, sei, (WebServiceFeature) null) |
Operation is performed considering that a variable length argument with null is specified, and the exception NullPointerException occurs. |
| 6 | null is specified in the argument and cast in the WebServiceFeature type array | getPort(epr, sei, (WebServiceFeature[]) null) |
Operation is performed considering that no variable length argument is specified. |
The following table describes the support range of the javax.xml.ws.wsaddressing.W3CEndpointReference class. For details, see the JAX-WS 2.2 specifications.
Table 19-9 Support range of the javax.xml.ws.wsaddressing.W3CEndpointReference class
| No. | Return value type | Method name | Support |
|---|---|---|---|
| 1 | -- | W3CEndpointReference() | Y |
| 2 | -- | W3CEndpointReference (javax.xml.transform.Source source) | Y |
| 3 | void | writeTo(javax.xml.transform.Result result) | N |
All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.