org.tanukisoftware.wrapper.event

Class WrapperControlEvent


public class WrapperControlEvent
extends WrapperEvent

WrapperControlEvent are used to notify the listener whenever the native wrapper code traps a system control signal against the Java process. It is up to the listener to take any actions necessary.

The Wrapper will send this event to any registered listeners first, then it will pass the control code to the WrapperListener.controlEvent method. If the consume method is called, it will still be passed to other WrapperEventListeners, but will not be passed to the WrapperListener.controlEvent method. Other WrapperEventListeners should check the isConsumed method to decide whether or not the even has already been handled.

If the wrapper.ignore_signals property is set to true then the event will still be fired, but its isConsumed() method will return true initially.

Possible values are:

Version:
$Revision: 1.2 $
Author:
Leif Mortenson

Constructor Summary

WrapperControlEvent(int controlEvent, String controlEventName)
Creates a new WrapperControlEvent.

Method Summary

void
consume()
Mark the event as consumed.
int
getControlEvent()
Returns the system control event.
String
getControlEventName()
Returns the name of the control event.
long
getFlags()
Returns a set of event flags for which the event should be fired.
boolean
isConsumed()
Returns true if the event has been consumed.
String
toString()
Returns a string representation of the event.

Methods inherited from class org.tanukisoftware.wrapper.event.WrapperEvent

getFlags

Constructor Details

WrapperControlEvent

public WrapperControlEvent(int controlEvent,
                           String controlEventName)
Creates a new WrapperControlEvent.
Parameters:
controlEvent - Service control event.
controlEventName - The name of the event.

Method Details

consume

public void consume()
Mark the event as consumed. This should be done if the event has been handled.

On Windows, some events are sent both to the JVM and Wrapper processes. Event if the CTRL-C event is ignored within the JVM, the Wrapper process may still initiate a shutdown.


getControlEvent

public int getControlEvent()
Returns the system control event.

Possible values are: WrapperManager.WRAPPER_CTRL_C_EVENT, WRAPPER_CTRL_CLOSE_EVENT, WRAPPER_CTRL_LOGOFF_EVENT, WRAPPER_CTRL_SHUTDOWN_EVENT, or WRAPPER_CTRL_TERM_EVENT.

Returns:
The system control event.

getControlEventName

public String getControlEventName()
Returns the name of the control event.
Returns:
The name of the control event.

getFlags

public long getFlags()
Returns a set of event flags for which the event should be fired. This value is compared with the mask supplied when when a WrapperEventListener is registered to decide which listeners should receive the event.

If a subclassed, the return value of the super class should usually be ORed with any additional flags.

Overrides:
getFlags in interface WrapperEvent
Returns:
a set of event flags.

isConsumed

public boolean isConsumed()
Returns true if the event has been consumed.
Returns:
True if the event has been consumed.

toString

public String toString()
Returns a string representation of the event.
Returns:
A string representation of the event.

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