com.goldencode.p2j.security

Class AssociatedThread

java.lang.Object

java.lang.Thread

com.goldencode.p2j.security.ContextAwareThread

com.goldencode.p2j.security.AssociatedThread

All Implemented Interfaces:

java.lang.Runnable

public class AssociatedThread
extends ContextAwareThread

Provides a thread which automatically inherits the security context of the thread that instantiates it. This means that the SAME context is used on both the instantiating thread and the new thread. All context-local data is accessible to both threads. When the thread exits, it will automatically cleanup the context (decrementing the reference counts and so forth). This makes it easy to implement additional threads which all share the same context, which means they have the same rights and have the same context-local data.

WARNING: Be very careful using this mechanism. Much (if not all of) the context-local data may not be thread-safe. Any data sharing between threads sharing a context must be made safe by the caller.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
private SecurityContext	context Any pending security context switch or null.

Fields inherited from class com.goldencode.p2j.security.ContextAwareThread

sm, stack

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
AssociatedThread(java.lang.Runnable core) Constructor which allows the core logic to be specified.

Method Summary

Modifier and Type	Method and Description
void	morphContextIfNeeded() Switch security contexts on the current thread if a switch is pending.
void	setPendingContextSwitch(java.lang.Object context) Save the given context as a pending context switch which will be processed later by the key reading thread.

Methods inherited from class com.goldencode.p2j.security.ContextAwareThread

needsSession, run

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

context

private SecurityContext context

Any pending security context switch or null.

Constructor Detail

AssociatedThread

public AssociatedThread(java.lang.Runnable core)
                 throws java.lang.NullPointerException

Constructor which allows the core logic to be specified.

Parameters:

core - The logic to execute when the thread is started. Must not be null.

Throws:

java.lang.NullPointerException - If the instantiating thread has no security context or if core is null.

Method Detail

setPendingContextSwitch

public void setPendingContextSwitch(java.lang.Object context)

Save the given context as a pending context switch which will be processed later by the key reading thread.

Parameters:

context - The security context to switch to (if non-null).

morphContextIfNeeded

public void morphContextIfNeeded()

Switch security contexts on the current thread if a switch is pending.