Package org.ws4d.java.service

Defines local and remote Devices, Services and Operations (actions supported by the service).

See:
          Description

Interface Summary
Device DPWS Device.
InvokeDelegate Instances of this interface can be used within an OperationStub to implement the actual business logic of a service's operation.
LocalDevice Interface of local devices.
LocalService DPWS service.
OperationDescription Common Interface of operations and event sources.
ProxyFactory This factory allows to create proxies for devices and services.
Service Interface of service classes representing "DPWS Hosted Services"
 

Class Summary
DefaultDevice Implementation of a local DPWS device.
DefaultEventSource Events are the source of server-side notifications to which interested clients may subscribe.
DefaultProxyFactory  
DefaultService Default implementation of a DPWS service.
DeviceCommons Class represents the common part of a proxy/local DPWS device also known as Hosting Service.
Fault Faults are the web-services correspondents to exceptions from the Java world.
Operation An operation is an abstraction of executable code.
OperationCommons This class is the common base for both Operations and DefaultEventSources within the DPWS framework.
OperationStub Instances of this class are used during dynamic creation of a service via the method DefaultService.define(org.ws4d.java.types.URI).
ProxyDevice Proxy class of a (remote) dpws device
ProxyService Proxy class of a dpws service.
ServiceCommons Class represents the common part of a proxy/local DPWS device.
ServiceCommons.OperationSignature  
ServiceCommons.PortType  
ServiceSubscription Instances of this class hold essential information about an event subscription as seen from the server-side.
 

Exception Summary
InvocationException Exceptions of this class are thrown to indicate the occurrence of a user-defined fault during the invocation of a operation or the dispatching of a DefaultEventSource.
TypeMismatchException  
 

Package org.ws4d.java.service Description

Defines local and remote Devices, Services and Operations (actions supported by the service).

The interface Device defines a DPWS Device, that is a "hosting service" A device can be discovered via probing from clients and be subscribed to. Each device can host a number of services. This interface defines the following information about the device

A device can be either local or remote (proxy device). The class DeviceCommnons modelises the common part of both local and proxy devices (notably, obtaining the metadata of the device), whilst the interface LocalDevice modelises the part specific to a local device (obtaining the Discovery Data).

The interface Service defines a DPWS Service, that is a "hosted service". The interface defines the following information about the service

A service can be either local or remote(proxy).The class ServiceCommon modelises the common part of both local and proxy devices. The class LocalDevice modelises the part specific to a local service.

Each service hosts a number of operations. Operations are abstractions of executable code and allow the service to "perform" actions. They have a name and a specific Port Type. Operations can be of type:

The input/output to these operations consist in elements defined by Element (see org.ws4d.java.schema) Request-response operations can output a fault (modelised by the class Fault)

The interface OperationDescription defines an interface for both operations and event sources (WSL compliant operations), whilst the implementing class OperationCommons implements the shared parts , and its extending class Operation, the part specific to Operations.