org.ocap.hn.upnp.server

Interface UPnPActionHandler

public interface UPnPActionHandler

This class represents an action handler an application can use to receive action requests and respond to them. A UPnPActionHandler must be provided with the service description in a call to UPnPDeviceManager.createService(), or in a call to UPnPManagedService.setActionHandler() .

Method Summary

Methods

Modifier and Type	Method and Description
void	notifyActionHandlerReplaced(UPnPActionHandler replacement) Notifies an application registered as an action handler that it has been replaced by another UPnPActionHandler.
UPnPResponse	notifyActionReceived(UPnPActionInvocation action) Notifies an application registered as an action handler that an action invocation has been received for the UPnPManagedService it is associated with.

Method Detail

notifyActionReceived

UPnPResponse notifyActionReceived(UPnPActionInvocation action)

Notifies an application registered as an action handler that an action invocation has been received for the UPnPManagedService it is associated with. The handler must respond with a properly-formed UPnPResponse, per the UPnP Device Architecture specification.

Parameters:

action - The UPnP action invocation received.

Returns:

The response to the action: either a UPnPActionResponse or a UPnPErrorResponse. A null return indicates the action was not handled.

notifyActionHandlerReplaced

void notifyActionHandlerReplaced(UPnPActionHandler replacement)

Notifies an application registered as an action handler that it has been replaced by another UPnPActionHandler.

Parameters:

replacement - The replacement UPnPActionHandler.