org.ocap.hn.recording
Interface NetRecordingRequestManager

All Superinterfaces:

NetModule, RecordingNetModule

public interface NetRecordingRequestManager
extends RecordingNetModule

This interface represents a local RecordingNetModule. An instance of RecordingNetModule for which the isLocal() method returns true will also be an instance of NetRecordingRequestManager.

Field Summary

Fields inherited from interface org.ocap.hn.NetModule

CONTENT_LIST, CONTENT_MANAGER, CONTENT_RECORDER, CONTENT_RENDERER, CONTENT_SERVER, PROP_CONTROL_URL, PROP_DESCRIPTION_URL, PROP_EventSub_URL, PROP_NETMODULE_ID, PROP_NETMODULE_TYPE

Method Summary

NetRecordingEntry	createNetRecordingEntry() This method creates a local entry which represents a network visible collection of recording items.
void	setNetRecordingRequestHandler(NetRecordingRequestHandler handler) This method sets the specified NetRecordingRequestHandler that processes requests to schedule recordings from remote devices.

Methods inherited from interface org.ocap.hn.recording.RecordingNetModule

requestDelete, requestDeleteService, requestDisable, requestPrioritize, requestPrioritize, requestReschedule, requestSchedule

Methods inherited from interface org.ocap.hn.NetModule

addNetModuleEventListener, getDevice, getKeys, getNetModuleId, getNetModuleType, getProperty, isLocal, removeNetModuleEventListener

Method Detail

createNetRecordingEntry

NetRecordingEntry createNetRecordingEntry()
                                          throws IOException

This method creates a local entry which represents a network visible collection of recording items.

Throws:

IOException - if the isLocal() method of this object does not return true

SecurityException - if the caller does not have HomeNetPermission("recordinghandler")

setNetRecordingRequestHandler

void setNetRecordingRequestHandler(NetRecordingRequestHandler handler)

This method sets the specified NetRecordingRequestHandler that processes requests to schedule recordings from remote devices. Only one instance of NetRecordingRequestHandler can be set on a given RecordingNetModule at a time. A NetRecordingRequestHandler can only be set on an instance of RecordingNetModule that is local to the device.

Parameters:

handler - the handler to be set for this RecordingNetModule. If null is specified, the currently set handler will be removed, and no application notification will occur for recording requests.

Throws:

SecurityException - if the caller does not have HomeNetPermission("recordinghandler")