4.3 Generating Signal Events

The example given in Listing 4.4 demonstrated the way in which signalable event handlers can be registered with a signal event object in order to receive signal event notifications. In that example, signal events are generated internally to the reactor core to provide notification of reactor shutdown. However, in the general case signal events will need to be generated by application code instead.

The way in which signal events may be generated by application code is shown in Listing 4.5. The full source code for this example is available in the signal examples package as SignalEventExample1.

% latex2html id marker 892\begin{small}\begin{verbatim}publi...
}\end{verbatim} \end{small}\caption{Generating Signal Events}

New signal event objects are created using the newSignal factory method on the Reactor interface. In common with the reactor shutdown signal in the previous example, signal event handlers may then be attached to the signal event object using its subscribe method. Once signal event handlers have been registered they will then receive any signal events which are generated by calling the signal method on the signal event object.

One feature of signal event generation demonstrated by Listing 4.5 is the passing of arbitrary data as part of signal event generation. In this example a handle on the reactor's control interface is passed, allowing the signal event handler to shut down the reactor when called. Java generics are used to enforce type safety, ensuring that the data type expected by the callback handler is consistent with the parameter data type passed by the signal event object.

In normal operation, signal handlers which implement the Signalable interface should not generate exceptions. There is no well defined way of propagating such error conditions, so any exceptions generated in this manner will just be caught by the reactor and logged as a warning. This may be demonstrated by adding a call to the signal method which passes an invalid parameter, as shown in 4.6. The full code for this example is included in the signal examples package as SignalEventExample2.

% latex2html id marker 910\begin{small}\begin{verbatim}...
...all}\caption{Generating Signal Events With Invalid Parameter Data}