Package net.sf.basedb.core.signal
Class Signal
java.lang.Object
net.sf.basedb.core.signal.Signal
public class Signal extends Object
Represents a signal that can be sent to a class implementing the
SignalTarget
interface. Signals must be registered before they
can be used. Use getSignals()
to get a list of signals
that have been registered. A signal can only be registered once.- Version:
- 2.6
- Author:
- nicklas
- Last modified
- $Date: 2017-04-05 12:47:41 +0200 (on, 05 apr 2017) $
-
Field Summary
Fields Modifier and Type Field Description static Signal
ABORT
The ABORT signal, that requests that the receiver should clean up and die.private String
description
private String
id
private String
name
static Signal
PAUSE
The PAUSE signal, that requests that the receiver should update the pause whatever it is doing and return control to the system.static Signal
SHUTDOWN
The SHUTDOWN signal, that requests that the receiver should clean up and die.private static Map<String,Signal>
signals
Holds all registered signals.static Signal
STATUS
The STATUS signal, that requests that the receiver should update the status on the system. -
Constructor Summary
-
Method Summary
Modifier and Type Method Description boolean
equals(Object other)
Two signals are equal if they have the same ID.String
getDescription()
Get the description of the what the signal means and how receivers should behave when the signal is sent to themString
getId()
Get the signal ID.String
getName()
Get the short name of the signal.static Signal
getSignal(String id)
Get the signal with a given ID.static Collection<Signal>
getSignals()
Get all registered signals.int
hashCode()
The hashcode for a signal is the same as the hashcode for the ID.static Signal
registerSignal(String id, String name, String description)
Register a signal.String
toString()
-
Field Details
-
ABORT
The ABORT signal, that requests that the receiver should clean up and die. This signal is typically sent to a plug-in when the user manually requests that a job is aborted. It is also sent when the system is shutting down to plug-ins that doesn't support theSHUTDOWN
signal. -
SHUTDOWN
The SHUTDOWN signal, that requests that the receiver should clean up and die. When the system is up again the receiver may continue were it was stopped if supported. Otherwise, this signal should be treated asABORT
.- Since:
- 2.16
-
STATUS
The STATUS signal, that requests that the receiver should update the status on the system. This signal is typically sent to a job managed by an external job manager when someone on the BASE side want to have an update about the progress.- Since:
- 3.3
-
PAUSE
The PAUSE signal, that requests that the receiver should update the pause whatever it is doing and return control to the system.- Since:
- 3.11
-
signals
Holds all registered signals. -
id
-
name
-
description
-
-
Constructor Details
-
Signal
-
-
Method Details
-
registerSignal
Register a signal.- Parameters:
id
- The ID of the signal. This must be unique. If another signal with the same ID already exists, this method does nothing.name
- The short name of the signaldescription
- A description of the what the signal means and how receivers should behave when the signal is sent to them- Returns:
- The Signal object
-
getSignal
Get the signal with a given ID.- Parameters:
id
- The signal ID.- Returns:
- The Signal object, or null if no signal with the given ID has been registered
- See Also:
getSignals()
-
getSignals
Get all registered signals. The returned collection can't be modified.- Returns:
- A Collection with all registered signals
- See Also:
getSignal(String)
-
toString
-
equals
Two signals are equal if they have the same ID. -
hashCode
public int hashCode()The hashcode for a signal is the same as the hashcode for the ID. -
getId
Get the signal ID. The ID must be unique among all registered signals. -
getName
Get the short name of the signal. -
getDescription
Get the description of the what the signal means and how receivers should behave when the signal is sent to them
-