Package org.somda.sdc.dpws.service.factory

Interface HostedServiceFactory

public interface HostedServiceFactory

Factory to create HostedService related} and HostedServiceProxy instances.

Method Summary

Modifier and Type	Method	Description
HostedService	createHostedService(String serviceId, List<QName> types, List<String> eprAddresses, WebService webService, byte[] wsdlDocument)	Creates a hosted service instance.
HostedService	createHostedService(String serviceId, List<QName> types, WebService webService, byte[] wsdlDocument)	Creates a hosted service metadata instance without available EPR addresses.
HostedServiceProxy	createHostedServiceProxy(HostedServiceType hostedServiceType, RequestResponseClient rrClient, String activeEprAddress, EventSink eventSink)	Creates a hosted service proxy instance.

Method Detail

createHostedService

HostedService createHostedService(String serviceId,
                                  List<QName> types,
                                  List<String> eprAddresses,
                                  WebService webService,
                                  byte[] wsdlDocument)

Creates a hosted service instance.

Parameters:

serviceId - the service id. It is good practice to use a relative URL part (e.g., "SampleService").

types - list of QNames that matches the QNames of the port types of the WSDL that comes with the hosted service.

eprAddresses - list of URLs where the hosted service can be requested from.

webService - interceptor to process incoming network requests.

wsdlDocument - byte array to expose the hosted service's WSDL document.

Returns:

hosted service instance used on the device side.

createHostedService

HostedService createHostedService(String serviceId,
                                  List<QName> types,
                                  WebService webService,
                                  byte[] wsdlDocument)

Creates a hosted service metadata instance without available EPR addresses.

This factory method can be used if EPR addresses shall be assigned automatically from a hosting service.

Parameters:

serviceId - the service id. It is good practice to use a relative URL part (e.g., "SampleService").

types - list of QNames that matches the QNames of the port types of the WSDL that comes with the hosted service.

webService - interceptor to process incoming network requests.

wsdlDocument - byte array to expose the hosted service's WSDL document.

Returns:

hosted service instance used on the device side.

createHostedServiceProxy

HostedServiceProxy createHostedServiceProxy(HostedServiceType hostedServiceType,
                                            RequestResponseClient rrClient,
                                            String activeEprAddress,
                                            EventSink eventSink)

Creates a hosted service proxy instance.

Parameters:

hostedServiceType - the hosted service WS-MetadataExchange response information.

rrClient - the request-response client to invoke service operations on.

activeEprAddress - the physical address that is actively being used to send network requests.

eventSink - the event sink client API to subscribe to notifications of a remote device.

Returns:

hosted service proxy instance used by on the client side.