de.uni_hildesheim.sse.monitoring.runtime.wrap

Class ShutdownMonitor

java.lang.Object

java.lang.Thread

de.uni_hildesheim.sse.monitoring.runtime.wrap.ShutdownMonitor

All Implemented Interfaces:

java.lang.Runnable

public class ShutdownMonitor
extends java.lang.Thread

Provides code to shutdown the monitoring framework. This is needed because javassist does not support inner or local classes.

Since:

1.00

Version:

1.00

Author:

Holger Eichelberger

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 static java.lang.Boolean	executeEndCode Stores whether the end code shall be executed.
private java.lang.String	invoke Stores the static method to be invoked at the end of monitoring.
private java.lang.ClassLoader	loader Stores the class loader for invoking invoke.
private boolean	printStatistics Whether final statistics shall be printed.

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
ShutdownMonitor(java.lang.ClassLoader loader, java.lang.String invoke) Creates a new monitor.
ShutdownMonitor(java.lang.ClassLoader loader, java.lang.String invoke, boolean printStatistics) Creates a new monitor.

Method Summary

Modifier and Type	Method and Description
static void	endMonitoring(boolean printStatistics, java.lang.ClassLoader loader, java.lang.String invoke) Ends the monitoring system properly.
static void	endSystemNotification() Notifies that final end of monitoring occured.
private static void	handleException(java.lang.String invoke, java.lang.Exception exception) Emits an exception.
void	run() Ends the monitoring.
static void	setWaitEndSystemNotification(boolean wait) Enables explicit waiting for end system notification (by endSystemNotification()).

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

executeEndCode

private static java.lang.Boolean executeEndCode

Stores whether the end code shall be executed. null means ignore, false wait, true execute.

invoke

private java.lang.String invoke

Stores the static method to be invoked at the end of monitoring.

loader

private java.lang.ClassLoader loader

Stores the class loader for invoking invoke.

printStatistics

private boolean printStatistics

Whether final statistics shall be printed.

Constructor Detail

ShutdownMonitor

public ShutdownMonitor(java.lang.ClassLoader loader,
                       java.lang.String invoke)

Creates a new monitor.

Parameters:

invoke - the static method to be invoked

loader - the related class loader for invocation

Since:

1.00

ShutdownMonitor

public ShutdownMonitor(java.lang.ClassLoader loader,
                       java.lang.String invoke,
                       boolean printStatistics)

Creates a new monitor.

Parameters:

invoke - the static method to be invoked

loader - the related class loader for invocation

printStatistics - whether statistics shall be printed

Since:

1.00

Method Detail

setWaitEndSystemNotification

public static void setWaitEndSystemNotification(boolean wait)

Enables explicit waiting for end system notification (by endSystemNotification()). This mechanism should not be used when this class is used as a JVM shutdown hook!

Parameters:

wait - if true end system notification is required to shut down monitoring, if false the system just exists

Since:

1.00

endSystemNotification

public static void endSystemNotification()

Notifies that final end of monitoring occured.

Since:

1.00

endMonitoring

public static void endMonitoring(boolean printStatistics,
                                 java.lang.ClassLoader loader,
                                 java.lang.String invoke)

Ends the monitoring system properly.

Parameters:

printStatistics - determines if statistics should be printed

loader - the class loader for invoke

invoke - a static method to be invoked after finishing monitoring (in the form fqn class name "." method name, no parameter)

Since:

1.00

handleException

private static void handleException(java.lang.String invoke,
                                    java.lang.Exception exception)

Emits an exception.

Parameters:

invoke - the method to invoke

exception - the caught exception

Since:

1.00

run

public void run()

Ends the monitoring.

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread