com.opencloud.rhino.facilities.sas

Class InvokingTrailAccessor

java.lang.Object

com.opencloud.rhino.facilities.sas.InvokingTrailAccessor

public final class InvokingTrailAccessor
extends Object

Provides access to the InvokingTrail. The InvokingTrail is the SAS trail attached to the activity owning the current event, at the time the event is delivered.

Since:

Rhino 2.6.0

Method Summary

Modifier and Type	Method and Description
static Trail	getInvokingTrail() Gets the InvokingTrail.
static void	remove() Removes the trail object from the current Thread.
static void	setInvokingTrail(Trail trail) Provides set access to the InvokingTrail.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInvokingTrail

public static Trail getInvokingTrail()

Gets the InvokingTrail. Subsequent changes to trail attachment will not be reflected in InvokingTrail for the duration of event processing.

Returns:

The trail attached to the activity owning the current event, or the NULL_TRAIL

setInvokingTrail

public static void setInvokingTrail(Trail trail)

Provides set access to the InvokingTrail. Normally this should not need to be invoked by service or RA code.

In some rare cases, where interacting with not yet SAS enabled code it may be necessary to manually set a real trail, as the code creating the activity has not attached a trail.

Parameters:

trail - to set as the invoking trail

remove

public static void remove()

Removes the trail object from the current Thread. After the call to remove, the NULL_TRAIL will be returned by subsequent gets This is called internally by Rhino, and should never need to be called by deployed code.