com.googlecode.jmxtrans.util

Class SignalInterceptor

java.lang.Object

com.googlecode.jmxtrans.util.SignalInterceptor

public abstract class SignalInterceptor
extends Object

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SignalInterceptor()

Method Summary

Modifier and Type	Method and Description
protected abstract boolean	handle(String signame) Handle the given signal (which you had previously registered for).
protected void	register(String signame) Register for the given signal.

Methods inherited from class java.lang.Object

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

Constructor Detail

SignalInterceptor

protected SignalInterceptor()

Method Detail

register

protected void register(String signame)
                 throws com.googlecode.jmxtrans.util.SignalInterceptor.SignalInterceptorException

Register for the given signal. Note that the signal name should not begin with SIG. For example, if you are interested in SIGTERM, you should call register("TERM").

If the registration fails for any reason, a SignalInterceptorException will be thrown. This is usually caused by one of the following conditions:

• The sun.misc.Signal* classes are not available (e.g. you are not using Sun's JVM).
• signame is not a valid trappable signal name on this OS (e.g. KILL can't be trapped, HUP does not exist on Windows)
• The JVM refuses to let you trap signame because it is already being used for some other important purpose (e.g. QUIT and/or BREAK cause the JVM to print diagnostic output).

Throws:

com.googlecode.jmxtrans.util.SignalInterceptor.SignalInterceptorException

handle

protected abstract boolean handle(String signame)

Handle the given signal (which you had previously registered for). If this method return false, or throws an exception, subsequent handlers in the chain will not be called.