oracle.ifs.core.agents

Class AuditEventDispatchAgent

java.lang.Object

oracle.ifs.core.runtime.Server

oracle.ifs.core.runtime.IfsServer

oracle.ifs.core.runtime.ClusteredServer

oracle.ifs.core.agents.AuditEventDispatchAgent

All Implemented Interfaces:

ServerInterface, TimerContext

public class AuditEventDispatchAgent
extends ClusteredServer

AuditEventDispatchAgent is a time-critical agent that dispatches raw Audit events to other Audit histories.

This agent continuously polls for new raw audit events, and copies them to all registered audit histories (via registered AuditSpecification instances).

Author:

Dave Long

Nested Class Summary

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

IfsServer.ServerRequest

Field Summary

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
AuditEventDispatchAgent() Constructs a AuditEventDispatchAgent.

Method Summary

Modifier and Type	Method and Description
IfsLogger	getLogger() Gets the appropriate logger for this server.
protected void	handlePropertyChangeRequest(AttributeValue av) Handles updates to dynamic properties.
protected void	handleResumeRequest() handle the resume request.
protected void	handleStopRequest() Handle the stop request.
protected void	handleSuspendRequest() handle the suspend request.
protected void	handleTimerExpired() Handles a timer expiration.
void	initialize() Perform one time initialization tasks upon loading.
boolean	isAgent() Gets whether this Server is an agent.
boolean	isPropertyReadonly(String name) Returns true if the property name specified is readonly.
static void	main(String[] args) This is used to run the AuditEventDispatchAgent in the standalone mode.
void	postRun() Performs post-run tasks for this agent.
void	run() Runs this agent.
boolean	supportsSuspendResume() Gets whether suspend/resume is supported.

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

cancelRegistration, checkRegistration, deriveAgentIdentifier, deriveRunningServerIdentifier, getAgentIdentifier, getAgentIdentifierPrefix, getRegistrationPeriod, getRunningNodeIdentifier, getRunningNodeName, getRunningServerIdentifier, initializeRegistration, isRegistered, isServerRunning, isTokenNonCompeting

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

checkSession, connectSession, constructSession, convertTimerInterval, convertTimerInterval, convertTimerInterval, dispose, getLastTimerActivation, getNextTimerActivation, getService, getTimerActivationPeriod, getTimerClassName, getTimerConfiguration, handlePriorityChangeRequest, handlePropertyChangeRequest, handleRequest, handleRequests, handleServerStateControllerRequest, isNonCompeting, isServiceAvailable, isTimerActive, postCheckServerStateRequest, postRequest, preRun, processEvent, 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

Constructor Detail

AuditEventDispatchAgent

public AuditEventDispatchAgent()
                        throws IfsException

Constructs a AuditEventDispatchAgent.

Throws:

IfsException - if the operation fails

Method Detail

main

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

This is used to run the AuditEventDispatchAgent in the 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

isPropertyReadonly

public boolean isPropertyReadonly(String name)
                           throws IfsException

Returns true if the property name specified is readonly.

Specified by:

isPropertyReadonly in interface ServerInterface

Overrides:

isPropertyReadonly in class IfsServer

Parameters:

name - name of the property

Returns:

true if property is readonly; false otherwise

Throws:

IfsException - if the operation fails

handlePropertyChangeRequest

protected void handlePropertyChangeRequest(AttributeValue av)
                                    throws Exception

Handles updates to dynamic properties.

Overrides:

handlePropertyChangeRequest in class IfsServer

Parameters:

av - the property that was changed

Throws:

Exception - if the operation fails

isAgent

public boolean isAgent()
                throws IfsException

Gets whether this Server is an agent.

This method is called by administration tools to group together servers that are agents in administration user interfaces.

Specified by:

isAgent in interface ServerInterface

Overrides:

isAgent in class Server

Returns:

true

Throws:

IfsException - no exception is thrown

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

Handle the stop request.

Overridden here to include logging.

Overrides:

handleStopRequest in class IfsServer

Throws:

Exception - if operation fails

(Published)

supportsSuspendResume

public boolean supportsSuspendResume()

Gets whether suspend/resume is supported.

Specified by:

supportsSuspendResume in interface ServerInterface

Overrides:

supportsSuspendResume in class Server

Returns:

true

handleSuspendRequest

protected void handleSuspendRequest()
                             throws Exception

handle the suspend request. Subclasses can override this to perform custom tasks as part of a Suspend request.

Overrides:

handleSuspendRequest in class IfsServer

Throws:

Exception - if the operation fails

handleResumeRequest

protected void handleResumeRequest()
                            throws Exception

handle the resume request. Subclasses can override this to perform custom tasks as part of a Resume request.

Overrides:

handleResumeRequest in class IfsServer

Throws:

Exception - if the operation fails

handleTimerExpired

protected void handleTimerExpired()
                           throws Exception

Handles a timer expiration.

Overrides:

handleTimerExpired in class IfsServer

Throws:

Exception - if the operation fails