public interface IRequestSubsystem
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
SUB_ID |
Modifier and Type | Method and Description |
---|---|
void |
createRequestQueue(java.lang.String name)
Creates a new request queue.
|
IRequestQueue |
getRequestQueue(java.lang.String name,
int increment,
IPolicy p,
IService s,
INotify n)
Retrieves a request queue.
|
IRequestQueue |
getRequestQueue(java.lang.String name,
int increment,
IPolicy p,
IService s,
INotify n,
INotify pendingNotifier)
Retrieves a request queue.
|
static final java.lang.String SUB_ID
void createRequestQueue(java.lang.String name) throws EBaseException
name
- The name of the queue object. This name can be used
in getRequestQueue to retrieve the queue later.EBaseException
- failed to create request queueIRequestQueue getRequestQueue(java.lang.String name, int increment, IPolicy p, IService s, INotify n) throws EBaseException
WARNING: retrieving the same queue twice with result in multi-thread race conditions.
name
- the name of the request queue. (Ex: "ca" "ra")p
- A policy enforcement module. This object is called to make
adjustments to the request, and decide whether it needs agent
approval.s
- The service object. This object actually performs the request
after it is finalized and approved.n
- A notifier object (optional). The notify() method of this object
is invoked when the request is completed (COMPLETE, REJECTED or
CANCELED states).EBaseException
- failed to retrieve request queueIRequestQueue getRequestQueue(java.lang.String name, int increment, IPolicy p, IService s, INotify n, INotify pendingNotifier) throws EBaseException
WARNING: retrieving the same queue twice with result in multi-thread race conditions.
name
- the name of the request queue. (Ex: "ca" "ra")p
- A policy enforcement module. This object is called to make
adjustments to the request, and decide whether it needs agent
approval.s
- The service object. This object actually performs the request
after it is finalized and approved.n
- A notifier object (optional). The notify() method of this object
is invoked when the request is completed (COMPLETE, REJECTED or
CANCELED states).pendingNotifier
- A notifier object (optional). Like the 'n' argument, except the
notification happens if the request is made PENDING. May be the
same as the 'n' argument if desired.EBaseException
- failed to retrieve request queue