org.tanukisoftware.wrapper.jmx

Interface WrapperManagerMBean

public interface WrapperManagerMBean

Author: Leif Mortenson

Method Summary
StringgetBuildTime()
Obtain the build time of Wrapper.
booleangetHasShutdownHookBeenTriggered()
Returns true if the ShutdownHook for the JVM has already been triggered.
intgetJavaPID()
Returns the PID of the Java process.
intgetJVMId()
Returns the Id of the current JVM.
StringgetVersion()
Obtain the current version of Wrapper.
intgetWrapperPID()
Returns the PID of the Wrapper process.
booleanisControlledByNativeWrapper()
Returns true if the JVM was launched by the Wrapper application.
booleanisDebugEnabled()
Returns true if the wrapper.debug property, or any of the logging channels are set to DEBUG in the wrapper configuration file.
booleanisLaunchedAsService()
Returns true if the Wrapper was launched as an NT service on Windows or as a daemon process on UNIX platforms.
voidrequestThreadDump()
Requests that the current JVM process request a thread dump.
voidrestart()
Tells the native wrapper that the JVM wants to restart, then informs all listeners that the JVM is about to shutdown before killing the JVM.
voidsetConsoleTitle(String title)
Sets the title of the console in which the Wrapper is running.
voidstop(int exitCode)
Tells the native wrapper that the JVM wants to shut down, then informs all listeners that the JVM is about to shutdown before killing the JVM.

Method Detail

getBuildTime

public String getBuildTime()
Obtain the build time of Wrapper.

Returns: The time that the Wrapper was built.

getHasShutdownHookBeenTriggered

public boolean getHasShutdownHookBeenTriggered()
Returns true if the ShutdownHook for the JVM has already been triggered. Some code needs to know whether or not the system is shutting down.

Returns: True if the ShutdownHook for the JVM has already been triggered.

getJavaPID

public int getJavaPID()
Returns the PID of the Java process. A PID of 0 will be returned if the native library has not been initialized. This value can also be obtained using the 'wrapper.java.pid' system property.

Returns: The PID of the Java process.

getJVMId

public int getJVMId()
Returns the Id of the current JVM. JVM Ids increment from 1 each time the wrapper restarts a new one.

Returns: The Id of the current JVM.

getVersion

public String getVersion()
Obtain the current version of Wrapper.

Returns: The version of the Wrapper.

getWrapperPID

public int getWrapperPID()
Returns the PID of the Wrapper process. A PID of 0 will be returned if the JVM was launched standalone. This value can also be obtained using the 'wrapper.pid' system property.

Returns: The PID of the Wrpper process.

isControlledByNativeWrapper

public boolean isControlledByNativeWrapper()
Returns true if the JVM was launched by the Wrapper application. False if the JVM was launched manually without the Wrapper controlling it.

Returns: True if the current JVM was launched by the Wrapper.

isDebugEnabled

public boolean isDebugEnabled()
Returns true if the wrapper.debug property, or any of the logging channels are set to DEBUG in the wrapper configuration file. Useful for deciding whether or not to output certain information to the console.

Returns: True if the Wrapper is logging any Debug level output.

isLaunchedAsService

public boolean isLaunchedAsService()
Returns true if the Wrapper was launched as an NT service on Windows or as a daemon process on UNIX platforms. False if launched as a console. This can be useful if you wish to display a user interface when in Console mode. On UNIX platforms, this is not as useful because an X display may not be visible even if launched in a console.

Returns: True if the Wrapper is running as an NT service or daemon process.

requestThreadDump

public void requestThreadDump()
Requests that the current JVM process request a thread dump. This is the same as pressing CTRL-BREAK (under Windows) or CTRL-\ (under Unix) in the the console in which Java is running. This method does nothing if the native library is not loaded.

restart

public void restart()
Tells the native wrapper that the JVM wants to restart, then informs all listeners that the JVM is about to shutdown before killing the JVM.

The restart is actually performed in a background thread allowing JMX a chance to respond to the client.

setConsoleTitle

public void setConsoleTitle(String title)
Sets the title of the console in which the Wrapper is running. This is currently only supported on Windows platforms.

As an alternative, it is also possible to set the console title from within the wrapper.conf file using the wrapper.console.title property.

Parameters: title The new title. The specified string will be encoded to a byte array using the default encoding for the current platform.

stop

public void stop(int exitCode)
Tells the native wrapper that the JVM wants to shut down, then informs all listeners that the JVM is about to shutdown before killing the JVM.

The stop is actually performed in a background thread allowing JMX a chance to respond to the client.

Parameters: exitCode The exit code that the Wrapper will return when it exits.

Copyright 1999, 2006 Tanuki Software Inc., All Rights Reserved.