se.entra.phantom.server

Class ServerThreadGroup

java.lang.Object

java.lang.ThreadGroup

se.entra.phantom.server.ServerThreadGroup

All Implemented Interfaces:

Thread.UncaughtExceptionHandler

public final class ServerThreadGroup
extends ThreadGroup

The ServerThreadGroup class extends the Java ThreadGroup class and provides logging a facility used by the Server Administration program.

Field Summary

Fields

Modifier and Type	Field and Description
static ThreadGroup	mainGroup The main thread group.

Method Summary

Modifier and Type	Method and Description
static void	dumpBasicThreadInfo(ThreadInfo ti, String linePrefix, String lineSuffix, StringBuilder buf) Gets basic thread information.
static void	dumpMainThreads(StringBuilder buf, long msElapseTime) Dumps the thread information for the ThreadGroup recursively.
static void	dumpThread(Thread t, StringBuilder buf, long t1, long t2, long elapsedTime, int nCPUs) Dumps thread information.
void	dumpThreads(StringBuilder buf, long msElapseTime) Dumps the thread information for the ThreadGroup recursively.
static void	dumpThreads(ThreadGroup tg, StringBuilder buf, long msElapseTime) Dumps the thread information for the ThreadGroup recursively.
ClientConnectionData	getClientConnectionData() Gets the client connection data.
static ThreadMXBean	getThreadMXBean() Gets the ThreadMXBean instance.
static ClientConnectionData	killClientSessionThreadsCCD(long id) Kills all threads belonging to a client session.
static boolean	stopClientSessionThreads(long id) Stops all threads belonging to a client session.
static boolean	stopClientSessionThreads(String id) Stops all processes in a thread group.
static ClientConnectionData	stopClientSessionThreadsCCD(long id) Stops all threads belonging to a client session.
static boolean	timeEnableThreadCPU(boolean on) Try enabling time for dumping threads.
void	uncaughtException(Thread t, Throwable e) Called by the Java Virtual Machine when a thread in this thread group stops because of an uncaught exception.

Methods inherited from class java.lang.ThreadGroup

activeCount, activeGroupCount, allowThreadSuspension, checkAccess, destroy, enumerate, enumerate, enumerate, enumerate, getMaxPriority, getName, getParent, interrupt, isDaemon, isDestroyed, list, parentOf, resume, setDaemon, setMaxPriority, stop, suspend, toString

Methods inherited from class java.lang.Object

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

Field Detail

mainGroup

public static final ThreadGroup mainGroup

The main thread group.

Method Detail

getThreadMXBean

public static ThreadMXBean getThreadMXBean()

Gets the ThreadMXBean instance.

stopClientSessionThreads

public static boolean stopClientSessionThreads(String id)

Stops all processes in a thread group.

This method then calls the stop method on all the threads in this thread group and in all of its subgroups.

This means that all threads in the group are stopped with the method Thread.stop which is said to be unsafe. So calling this method MUST be done with care.

Returns:

false if the session is not found, true otherwise.

stopClientSessionThreads

public static boolean stopClientSessionThreads(long id)

Stops all threads belonging to a client session.

This means that all threads in the group are stopped with the method Thread.stop which is said to be unsafe. So calling this method MUST be done with care.

Returns:

false if the session is not found, true otherwise.

stopClientSessionThreadsCCD

public static ClientConnectionData stopClientSessionThreadsCCD(long id)

Stops all threads belonging to a client session.

This means that all threads in the group are stopped with the method Thread.stop which is said to be unsafe. So calling this method MUST be done with care.

Returns:

The ClientConnectionData of the session, null if not found.

killClientSessionThreadsCCD

public static ClientConnectionData killClientSessionThreadsCCD(long id)

Kills all threads belonging to a client session.

Returns:

false if the session is not found, true otherwise.

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.

uncaughtException

public void uncaughtException(Thread t,
                              Throwable e)

Called by the Java Virtual Machine when a thread in this thread group stops because of an uncaught exception.

The uncaughtException method of ThreadGroup does the following:

• If this thread group has a parent thread group, the uncaughtException method of that parent is called with the same two arguments.
• Otherwise, this method determines if the Throwable argument is an instance of ThreadDeath. If so, nothing special is done. Otherwise, the Throwable's printStackTrace method is called to print a stack back-trace to the standard error stream.

Specified by:

uncaughtException in interface Thread.UncaughtExceptionHandler

Overrides:

uncaughtException in class ThreadGroup

dumpMainThreads

public static void dumpMainThreads(StringBuilder buf,
                                   long msElapseTime)

Dumps the thread information for the ThreadGroup recursively.

Parameters:

buf - The string buffer to fill.

msElapseTime - The time to elapse between measurements in milliseconds, zero not to measure time (i.e. CPU consumption).

dumpThreads

public void dumpThreads(StringBuilder buf,
                        long msElapseTime)

Dumps the thread information for the ThreadGroup recursively.

Parameters:

buf - The string buffer to fill.

msElapseTime - The time to elapse between measurements in milliseconds, zero not to measure time (i.e. CPU consumption).

timeEnableThreadCPU

public static boolean timeEnableThreadCPU(boolean on)

Try enabling time for dumping threads.

Returns:

true for successful, false otherwise.

dumpThreads

public static void dumpThreads(ThreadGroup tg,
                               StringBuilder buf,
                               long msElapseTime)

Dumps the thread information for the ThreadGroup recursively.

Parameters:

buf - The string buffer to fill.

msElapseTime - The time to elapse between measurements in milliseconds, zero not to measure time (i.e. CPU consumption).

dumpThread

public static void dumpThread(Thread t,
                              StringBuilder buf,
                              long t1,
                              long t2,
                              long elapsedTime,
                              int nCPUs)

Dumps thread information.

dumpBasicThreadInfo

public static void dumpBasicThreadInfo(ThreadInfo ti,
                                       String linePrefix,
                                       String lineSuffix,
                                       StringBuilder buf)

Gets basic thread information.