Package org.ocap.hn.upnp.server

Provides UPnP server functionality, permitting management of devices and services in the local Host device.

See: Description

Interface Summary

Interface	Description
UPnPActionHandler	This class represents an action handler an application can use to receive action requests and respond to them.
UPnPManagedDevice	This interface represents a locally hosted UPnP device created when a privileged application uses UPnPDeviceManager.createDevice to create a device.
UPnPManagedDeviceListener	This interface represents a listener to UPnP local (server) device availability on a home network.
UPnPManagedService	This interface provides the server representation of a UPnP service created when a privileged application uses the UPnPDeviceManager in the local host.
UPnPManagedStateVariable	This interface provides the server representation of a UPnP state variable.
UPnPStateVariableHandler	This interface represents a handler for the evented UPnP state variables on a service.

Class Summary

Class	Description
UPnPDeviceManager	This class represents a manager that can create devices and services for devices.
UPnPManagedDeviceIcon	This class represents a UPnP Device Icon with associated binary data for a UPnPManagedDevice.

Package org.ocap.hn.upnp.server Description

Provides UPnP server functionality, permitting management of devices and services in the local Host device.

The UPnP Device Manager class (UPnPDeviceManager) provides the ability for an application to create devices and cause the Host device to expose them using the UPnP discovery process. Application created devices are UPnP compliant and may contain services with actions and state variables. An application uses the UPnPDeviceManager.createDevice method to create a device and passes in a UPnPManagedDevice object that contains a hierarcy of objects that represents all of the device information including service (UPnPManagedService) objects. The object hierarchy matches the UPnP device architecture definition, e.g. a device contains sub-devices, and services.

An application can set itself as an action handler by calling the UPnPManagedService.setActionHandler(UPnPActionHandler) method. The application will be notified when an action request is received for the managed service. The application will create a response and return it to the Host implementation which will send the UPnP response. Similarly, an application can set itself as a state variable handler by calling the UPnPManagedService.setHandler(UPnPManagedStateVariableHandler) method. The application will be notified when a control point subscribes to or unsubscribes from the service or has requested the value of a state variable through the QueryStateVariable action.