org.irenical.fetchy.service.factory.soap

Class ServiceClient<ENDPOINT extends Service,PORT>

java.lang.Object

org.irenical.fetchy.service.factory.soap.ServiceClient<ENDPOINT,PORT>

Type Parameters:

ENDPOINT - the SOAP service endpoint to use with this client (must extend Service)

PORT - the class that acts as an entry point for the port methods (a JAX-WS client proxy)

public class ServiceClient<ENDPOINT extends Service,PORT>
extends Object

Class that helps you initialize JAX-WS services and ports. Enables two main features, namely:

• Applying a set of "filters" to the endpoint and retrieved ports; these are classes that perform arbitrary actions on the endpoint and port objects upon their initialization. There are various filters available for commonly used features, such as enabling logging or setting options for proper MTOM/XOP transmission. Filters must extend from ServiceClientFilter.

• service/example/url - URL of the remote WSDL for the service being initialized. String type. Required.
• service/example/filters - Comma separated list of filter class names to load. Fully qualified names are required for filters outside the org.irenical.fetchy.service.factory.soap package. String type. Optional.

See Also:

ServiceClientFilter

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_FILTER_PACKAGE

Constructor Summary

Constructors

Constructor and Description
ServiceClient(Class<ENDPOINT> endpointClass, Class<PORT> portClass, String soapURLProperty, String filtersProperty, ServiceClientFilter... filters)
ServiceClient(Class<ENDPOINT> endpointClass, Class<PORT> portClass, URI soapURL, ServiceClientFilter... filters)

Method Summary

Modifier and Type	Method and Description
void	addSOAPFeature(WebServiceFeature feature) Add a SOAP WebServiceFeature directly.
void	addSOAPHandler(Handler handler) Add a SOAP Handler directly.
ENDPOINT	getEndpoint()
PORT	getPort()
PORT	getPort(ServiceClientPortFilter... portFilters)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_FILTER_PACKAGE

public static final String DEFAULT_FILTER_PACKAGE

See Also:

Constant Field Values

Constructor Detail

ServiceClient

public ServiceClient(Class<ENDPOINT> endpointClass,
                     Class<PORT> portClass,
                     URI soapURL,
                     ServiceClientFilter... filters)

ServiceClient

public ServiceClient(Class<ENDPOINT> endpointClass,
                     Class<PORT> portClass,
                     String soapURLProperty,
                     String filtersProperty,
                     ServiceClientFilter... filters)

Method Detail

addSOAPHandler

public void addSOAPHandler(Handler handler)

Add a SOAP Handler directly. Using this method directly is discouraged and it should be used primarily from within ServiceClientFilters.

Parameters:

handler - the SOAP handler to be added to the service endpoint

addSOAPFeature

public void addSOAPFeature(WebServiceFeature feature)

Add a SOAP WebServiceFeature directly. Using this method directly is discouraged and it should be used primarily from within ServiceClientFilters.

Parameters:

feature - the SOAP WebServiceFeature to be added to the service endpoint

getEndpoint

public ENDPOINT getEndpoint()

getPort

public PORT getPort(ServiceClientPortFilter... portFilters)

getPort

public PORT getPort()