|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The Activity Context Naming Facility provides a global flat namespace for naming Activity Contexts. It allows an SBB entity to bind a name to an Activity Context, and other SBB entities to lookup the Activity Context by this name. An Activity Context can be bound to zero or more names.
This facility is transactional in nature. Naming operations only take effect once the enclosing transaction commits.
java:comp/env/slee/facilities/activitycontextnaming
Method Summary | |
void |
bind(ActivityContextInterface aci,
java.lang.String name)
Bind an Activity Context to a name. |
ActivityContextInterface |
lookup(java.lang.String name)
Get a reference to the Activity Context bound to a particular name. |
void |
unbind(java.lang.String name)
Unbind a bound name. |
Method Detail |
public void bind(ActivityContextInterface aci, java.lang.String name) throws java.lang.NullPointerException, java.lang.IllegalArgumentException, TransactionRequiredLocalException, NameAlreadyBoundException, FacilityException
This method is a mandatory transactional method.
aci
- an ActivityContextInterface
object that encapsulates
the Activity Context to bind.name
- the name to bind the Activity Context to.java.lang.NullPointerException
- if any argument is null
.java.lang.IllegalArgumentException
- if name
is zero-length.TransactionRequiredLocalException
- if this method is invoked without a
valid transaction context.NameAlreadyBoundException
- if the specified name is already bound to
some Activity Context.FacilityException
- if the activity context could not be bound due to
a system-level failure.public void unbind(java.lang.String name) throws java.lang.NullPointerException, TransactionRequiredLocalException, NameNotBoundException, FacilityException
This method is a mandatory transactional method.
name
- the name that should be unbound.java.lang.NullPointerException
- if name
is null
.TransactionRequiredLocalException
- if this method is invoked without a
valid transaction context.NameNotBoundException
- if the specified name is not currently bound
to an Activity Context.FacilityException
- if the name could not be unbound due to a
system-level failure.public ActivityContextInterface lookup(java.lang.String name) throws java.lang.NullPointerException, TransactionRequiredLocalException, FacilityException
This method is a mandatory transactional method.
name
- the name the Activity Context is bound to.ActivityContextInterface
object that encapsulates
the Activity Context bound to the specified name. If no Activity
Context is bound to the name, this method returns null
.java.lang.NullPointerException
- if name
is null
.TransactionRequiredLocalException
- if this method is invoked without a
valid transaction context.FacilityException
- if the lookup failed due to a system-level failure.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |