ThreadContext API

For convenience and better performance, the ORB provides access to its thread level data structure for storing transaction context information.

package com.sssw.jbroker.api.transaction;
 
import java.util.EmptyStackException;
 
/**
 * The ThreadContext manages a stack of Transaction contexts 
 * at the Thread level. A context can be any arbitrary 
 * java.lang.Object.
 */
public interface ThreadContext
{
    /**
     * Push a transaction context for the current thread.
     */
    void pushContext(java.lang.Object context);
 
    /**
     * Pop the top transaction context for the current thread.
     */
    java.lang.Object popContext() throws EmptyStackException;
 
    /**
     * Get the top transation context for the current thread. If 
     * there is no context, null is returned.
     */
    java.lang.Object getContext();
 
    /**
     * Get the top transation context for the given thread. If there is
     * no context, null is returned.
     */
    java.lang.Object getContext(Thread thread);
}