oracle.ifs.core.agents

Class EventHandlerAgent

java.lang.Object

oracle.ifs.core.runtime.Server

oracle.ifs.core.runtime.IfsServer

oracle.ifs.core.agents.EventHandlerAgent

All Implemented Interfaces:

IfsEventHandler, ServerInterface, TimerContext

public class EventHandlerAgent
extends IfsServer
implements IfsEventHandler

Executes AuditEventHandler implementations specified in custom AuditSpecification instances.

Author:

Dave Long, Luis Saenz

See Also:

AuditEventHandler, AuditEventHandlerContext

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	EventHandlerAgent.EventHandlerExecutor An Executor that performs notification tasks for EventHandlers and AuditEventHandlers.
class	EventHandlerAgent.InternalHandler Holds handler inforamtion about a registered AuditSpecification and manages the notifications to the associated custom internal handler.
class	EventHandlerAgent.RegisteredAuditSpecification RegisteredAuditSpecification holds information about a registered AuditSpecification and manages the notifications to the associated custom handler.

Nested classes/interfaces inherited from class oracle.ifs.core.runtime.IfsServer

IfsServer.ServerRequest

Field Summary

Fields

Modifier and Type	Field and Description
static int	REQUESTTYPE_ADD_AUDITSPECIFICATION An "Add AuditSpecification" request.
static int	REQUESTTYPE_DELETE_AUDITSPECIFICATION A "Delete AuditSpecification" request.

Fields inherited from class oracle.ifs.core.runtime.Server

LEVEL_HIGH, LEVEL_LOW, LEVEL_MEDIUM, LEVEL_OFF

Fields inherited from interface oracle.ifs.core.runtime.ServerInterface

SERVERSTATUS_DISPOSED, SERVERSTATUS_RUNNING, SERVERSTATUS_STARTING, SERVERSTATUS_STOPPED, SERVERSTATUS_STOPPING, SERVERSTATUS_SUSPENDED, SERVERSTATUS_UNKNOWN

Constructor Summary

Constructors

Constructor and Description
EventHandlerAgent() Constructs a EventHandlerAgent.

Method Summary

Modifier and Type	Method and Description
void	disableEventListening() Disable listening for events on AuditSpecification instances.
void	enableEventListening() Enable listening events on any AuditSpecification.
IfsLogger	getLogger() Gets the appropriate logger for this server.
protected AttributeValueTable	getTimerConfiguration() Gets the Timer Configuration.
void	handleEvent(IfsEvent event) Handles events.
protected void	handleRequest(IfsServer.ServerRequest request) Handles the specified pending request.
protected void	handleResumeRequest() Called when this Server is requested to resume.
protected void	handleStopRequest() Called when this Server is requested to stop.
protected void	handleSuspendRequest() Called when this Server is requested to suspend.
protected void	handleTimerExpired() Handles a generic timer expiration.
void	initialize() Perform one time initialization tasks upon loading.
boolean	isAgent() Gets whether this Server is an agent.
static void	main(String[] args) Runs an EventHandlerAgent in standalone mode.
void	postRun() Performs post-run tasks for this agent.
void	processEvent(IfsEvent event) Process the next event.
void	run() Runs this agent.
boolean	supportsSuspendResume() Gets whether this Server supports suspend/resume.

Methods inherited from class oracle.ifs.core.runtime.IfsServer

checkSession, connectSession, constructSession, convertTimerInterval, convertTimerInterval, convertTimerInterval, dispose, getLastTimerActivation, getNextTimerActivation, getService, getTimerActivationPeriod, getTimerClassName, handlePriorityChangeRequest, handlePropertyChangeRequest, handlePropertyChangeRequest, handleRequests, handleServerStateControllerRequest, isNonCompeting, isPropertyReadonly, isServiceAvailable, isTimerActive, isTokenNonCompeting, postCheckServerStateRequest, postRequest, preRun, processEvents, queueEvent, resetTimer, restart, resume, serviceAvailabilityCheckNeeded, setPriority, setProperty, setProperty, start, startTimer, stop, stopRequested, stopTimer, suspend, timerExpired, waitForServiceAvailability, waitServer

Methods inherited from class oracle.ifs.core.runtime.Server

acquireSession, constructLibrarySessionPool, createServerState, deregister, disconnectSession, getConfigurationOverridesTable, getConfigurationTable, getCredential, getDesiredStatus, getIfsHome, getInitialConfigurationTable, getLoggerForLegacyLogging, getName, getNode, getNodeName, getOracleHome, getParameterTable, getPriority, getProperties, getProperty, getServerConfigurationName, getServerState, getServerStateValue, getServerType, getServiceName, getSession, getStateTable, getStatus, getSystemUserCredential, handleServerConfigurationOverrideRequest, handleServerStateEvent, initialize, initialize, isDisposed, isInitialized, isLogged, log, log, log, releaseSession, releaseSession, setDesiredStatus, setDesiredStatus, setSessionTimeoutPrevented, setStateProperty, setStatus, startStandalone, startStandalone, supportsPriority, toStatusLabel, toStatusLabel, toStatusLabel, verifyNotDisposed, verifyNotDisposed

Methods inherited from class java.lang.Object

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

Field Detail

REQUESTTYPE_ADD_AUDITSPECIFICATION

public static final int REQUESTTYPE_ADD_AUDITSPECIFICATION

An "Add AuditSpecification" request.

See Also:

Constant Field Values

REQUESTTYPE_DELETE_AUDITSPECIFICATION

public static final int REQUESTTYPE_DELETE_AUDITSPECIFICATION

A "Delete AuditSpecification" request.

See Also:

Constant Field Values

Constructor Detail

EventHandlerAgent

public EventHandlerAgent()
                  throws IfsException

Constructs a EventHandlerAgent.

Throws:

IfsException - if the operation fails

Method Detail

main

public static void main(String[] args)
                 throws Exception

Runs an EventHandlerAgent in standalone mode.

Parameters:

args - command line args

Throws:

Exception - if the operation fails

getLogger

public IfsLogger getLogger()

Gets the appropriate logger for this server.

Typically overridden by subclasses to return the IfsLogger associatged with the specific server.

Overrides:

getLogger in class IfsServer

Returns:

the logger

initialize

public void initialize()
                throws Exception

Perform one time initialization tasks upon loading.

Overrides:

initialize in class IfsServer

Throws:

Exception - if the operation fails

isAgent

public boolean isAgent()
                throws IfsException

Description copied from class: Server

Gets whether this Server is an agent.

Returns false by default.

Specified by:

isAgent in interface ServerInterface

Overrides:

isAgent in class Server

Returns:

false

Throws:

IfsException - (IFS-45178) if the operation fails

run

public void run()

Runs this agent.

Specified by:

run in class IfsServer

postRun

public void postRun()

Performs post-run tasks for this agent.

Overrides:

postRun in class IfsServer

handleStopRequest

protected void handleStopRequest()
                          throws Exception

Description copied from class: IfsServer

Called when this Server is requested to stop.

This method is called by handleRequests. Override it to perform tasks upon a request to stop. If not overridden, this method simply causes subsequent calls to stopRequested to return true.

The handleRequests method will rethrow any exception thrown by this method.

Overrides:

handleStopRequest in class IfsServer

Throws:

Exception - if the operation fails

supportsSuspendResume

public boolean supportsSuspendResume()

Description copied from class: Server

Gets whether this Server supports suspend/resume.

If false, then suspend and resume will result in stop and start instead.

Specified by:

supportsSuspendResume in interface ServerInterface

Overrides:

supportsSuspendResume in class Server

Returns:

false; subclasses may override

handleSuspendRequest

protected void handleSuspendRequest()
                             throws Exception

Description copied from class: IfsServer

Called when this Server is requested to suspend.

This method is called by handleRequests. Override it to perform tasks upon a suspend request. Unless overridden, no operation is performed by this method.

If this method returns without throwing, the Server's status is set to SERVERSTATUS_SUSPENDED.

The handleRequests method will rethrow any exception thrown by this method.

Overrides:

handleSuspendRequest in class IfsServer

Throws:

Exception - if the operation fails

handleResumeRequest

protected void handleResumeRequest()
                            throws Exception

Description copied from class: IfsServer

Called when this Server is requested to resume.

This method is called by handleRequests. Override it to perform tasks upon a resume request. Unless overridden, no operation is performed by this method.

If this method returns without throwing, the Server's status is set to SERVERSTATUS_RUNNING.

The handleRequests method will rethrow any exception thrown by this method.

Overrides:

handleResumeRequest in class IfsServer

Throws:

Exception - if the operation fails

enableEventListening

public void enableEventListening()
                          throws IfsException

Enable listening events on any AuditSpecification.

Throws:

IfsException - if the operation fails

disableEventListening

public void disableEventListening()
                           throws IfsException

Disable listening for events on AuditSpecification instances.

Throws:

IfsException - if the operation fails

handleEvent

public void handleEvent(IfsEvent event)
                 throws IfsException

Handles events.

This queues requests for processing by the main agent thread. Unlike most agents, it does not queue event to be handled by processEvents.

Specified by:

handleEvent in interface IfsEventHandler

Parameters:

event - the event

Throws:

IfsException - if the operation fails

processEvent

public void processEvent(IfsEvent event)
                  throws IfsException

Process the next event.

Overrides:

processEvent in class IfsServer

Parameters:

event - The next event to process.

Throws:

IfsException - if the operation fails

handleTimerExpired

protected void handleTimerExpired()
                           throws Exception

Handles a generic timer expiration.

Overrides:

handleTimerExpired in class IfsServer

Throws:

Exception - if the operation fails

getTimerConfiguration

protected AttributeValueTable getTimerConfiguration()
                                             throws IfsException

Description copied from class: IfsServer

Gets the Timer Configuration.

Subclasses may override this to derive different values for the timer settings (see oracle.ifs.core.agents.AccessControlListIndexAgent).

Overrides:

getTimerConfiguration in class IfsServer

Returns:

the Timer configuration

Throws:

IfsException - if the operation fails

handleRequest

protected void handleRequest(IfsServer.ServerRequest request)
                      throws IfsException

Handles the specified pending request.

Overridden to handle the custom requests for this agent. Defers to super for the standard request types.

Overrides:

handleRequest in class IfsServer

Parameters:

request - the request to handle

Throws:

IfsException - if the operation fails