cern.laser.client.services.selection

Class AlarmSelectionHandler

java.lang.Object

cern.laser.client.services.selection.AlarmSelectionHandler

Direct Known Subclasses:

AlarmSelectionHandlerImpl

public abstract class AlarmSelectionHandler
extends java.lang.Object

Provides the services to define and perform an alarm selection.

Author:

F.Calderini

See Also:

AlarmBrowsingHandler, CategoryBrowsingHandler, AlarmReductionHandler

Constructor Summary

Constructors

Constructor and Description
AlarmSelectionHandler()

Method Summary

Modifier and Type	Method and Description
abstract void	close() Close and deallocate resources.
abstract Selection	createSelection() Creates a new selection
static AlarmSelectionHandler	get(org.omg.CORBA.ORB orb, AcsLogger logger) Factory method.
abstract void	resetSelection() Reset the selection.
abstract void	search(Selection selection, int nbOfRows, AlarmSearchListener searchListener) Starts the asynchronous alarm search.
abstract java.util.Map	select(Selection selection, AlarmSelectionListener listener) Starts the asynchronous alarm selection.

Methods inherited from class java.lang.Object

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

Constructor Detail

AlarmSelectionHandler

public AlarmSelectionHandler()

Method Detail

get

public static AlarmSelectionHandler get(org.omg.CORBA.ORB orb,
                                        AcsLogger logger)
                                 throws LaserConnectionException,
                                        LaserException

Factory method.

Returns:

an instance of the implementation class

Throws:

LaserException - if the request can not be served

LaserConnectionException

createSelection

public abstract Selection createSelection()

Creates a new selection

Returns:

the selection instance

select

public abstract java.util.Map select(Selection selection,
                                     AlarmSelectionListener listener)
                              throws LaserException,
                                     LaserTimeOutException

Starts the asynchronous alarm selection. The selected alarms which are currently active will be asynchronously received as well as any change that may occur to their status.

Parameters:

selection - the alarm selection instance

listener - the selection listener instance

Returns:

the selected alarms currently active

Throws:

LaserConnectionException - if the client cannot connect to the BL

LaserTimeOutException - if the selection times out

LaserException - if the system is unable to perform the selection

resetSelection

public abstract void resetSelection()
                             throws LaserException

Reset the selection.

Throws:

LaserException - if the system is unable to reset the selection

close

public abstract void close()
                    throws LaserException

Close and deallocate resources.

Throws:

LaserException - if the system is unable to close properly

search

public abstract void search(Selection selection,
                            int nbOfRows,
                            AlarmSearchListener searchListener)
                     throws LaserException,
                            LaserTimeOutException

Starts the asynchronous alarm search. The found alarms will be asynchronously received.

Parameters:

selection - the alarm selection instance

nbOfRows - the number of rows to return

searchListener - the search listener instance

Throws:

LaserConnectionException - if the client cannot connect to the BL

LaserTimeOutException - if the selection times out

LaserException - if the system is unable to perform the selection