se.entra.phantom.server

Class ServerThread

java.lang.Object

java.lang.Thread

se.entra.phantom.server.ServerThread

All Implemented Interfaces:

Runnable

public final class ServerThread
extends Thread

The ServerThread class extends the Java Thread class and provides logging a facility in case of a faulty or errornous thread termination. It also keeps track of the thread usage and to what session they belong to.

Each new thread will be set to Thread.NORM_PRIORITY even if the calling thread has a higher priority.

Do not extend from ServerThread, always use it together with a class that implements the Runnable interface.

Nested Class Summary

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

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
ServerThread(ClientConnectionData clientConnectionData, Runnable runnable, String name) Creates a new client-related thread instance for a class implementing the Runnable interface.
ServerThread(Runnable runnable, String name) Creates a new server-related thread instance for a class implementing the Runnable interface.

Method Summary

Modifier and Type	Method and Description
static ServerThread	createSystemThread(Runnable runnable, String name) Creates a system thread without "ClientConnectionData".
ClientConnectionData	getClientConnectionData() Gets the client connection data.
static long	getNextID() Gets the ID for the new instance of the thread.
static long	getRunningThreadCount() Gets the count of started threads.
long	getServerThreadID() Gets the ID of this thread.
String	getServerThreadName() Gets the name of this thread.
static Enumeration<ServerThread>	getServerThreads() Gets an enumeration of all running threads.
static ClientConnectionData	locateClientConnectionData(ClientConnectionData ccd, boolean doLocateCCD) Locates the ClientConnectionData from the current input depending on the flag and if not found, gets it from the current thread or the thread group.
void	run() Overrides the Thread.run method in order to provide event support.

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

Constructor Detail

ServerThread

public ServerThread(Runnable runnable,
                    String name)

Creates a new server-related thread instance for a class implementing the Runnable interface.

The name parameter is the name of the thread that appears in the trace and event output. Please use a maximum of 8 characters.

ServerThread

public ServerThread(ClientConnectionData clientConnectionData,
                    Runnable runnable,
                    String name)

Creates a new client-related thread instance for a class implementing the Runnable interface.

The name parameter is the name of the thread that appears in the trace and event output. Please use a maximum of 8 characters.

Method Detail

getNextID

public static final long getNextID()

Gets the ID for the new instance of the thread.

createSystemThread

public static final ServerThread createSystemThread(Runnable runnable,
                                                    String name)

Creates a system thread without "ClientConnectionData". This call should only be used by NetPhantom system threads and NOT by any others.

getRunningThreadCount

public static final long getRunningThreadCount()

Gets the count of started threads.

getServerThreads

public static final Enumeration<ServerThread> getServerThreads()

Gets an enumeration of all running threads.

Returns:

an enumeration of ServerThread objects.

locateClientConnectionData

public static final ClientConnectionData locateClientConnectionData(ClientConnectionData ccd,
                                                                    boolean doLocateCCD)

Locates the ClientConnectionData from the current input depending on the flag and if not found, gets it from the current thread or the thread group.

getServerThreadID

public final long getServerThreadID()

Gets the ID of this thread.

getServerThreadName

public final String getServerThreadName()

Gets the name of this thread.

run

public final void run()

Overrides the Thread.run method in order to provide event support. This method cannot be overridden in turn.

Specified by:

run in interface Runnable

Overrides:

run in class Thread

getClientConnectionData

public final ClientConnectionData getClientConnectionData()

Gets the client connection data.

Returns:

null if there is no client connection, i.e. that this client session isn't disposed for caching purposes.