Attach an SBB entity to the Activity Context. The SBB entity will subsequently begin to receive events that it is interested in that occur on the underlying activity. If the SBB has any
<event>
deployment descriptor elements with the
mask-on-attach
attribute set to
True, those events will automatically be masked from the SBB entity until the event mask is explicitly changed via the {@link SbbContext#maskEvent SbbContext.maskEvent} method.
If the specified SBB entity is already attached to the Activity Context, this method has no effect.
This method is a mandatory transactional method.
@param sbb the SBB local object of the SBB entity to attach.
@throws NullPointerException if sbb
is null
.
@throws TransactionRequiredLocalException if this method is invoked without a valid transactioncontext.
@throws TransactionRolledbackLocalException if sbb
does not referencea valid SBB entity.
@throws SLEEException if the SBB entity could not be attached due to a system-levelfailure.