org.jwall.web.audit.io

Class AuditLogFileWriter

java.lang.Object

java.lang.Thread

org.jwall.web.audit.io.AuditLogFileWriter

All Implemented Interfaces:

Runnable, EventListener<AuditEvent>, AuditEventListener, AuditEventWriter

public class AuditLogFileWriter
extends Thread
implements AuditEventListener, AuditEventWriter

This is a persistence-thread which listens for events and writes them to a file. Writing to a file can also be configured to create a file for each set of events grouped together by the value of the Host-header field.

Author:

Christian Bockermann <chris@jwall.org>

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
static String	VERSION

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
AuditLogFileWriter(File dir, boolean hostBased, int logLevel)
AuditLogFileWriter(File dir, int logLevel, String groupBy) This constructor creates a new instance of this class which writes events to several files grouped by a request-property that is given by groupBy.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(AuditEvent evt)
void	add(Collection<AuditEvent> evts)
void	addAlias(String alias, String server) This method lets you specify an alias for a webserver so that events having this alias in their Host:-header will be written to the same file as the ones with the server-name in the Host-header.
void	addEventListener(AuditEventListener listener)
void	addEvents(Collection<AuditEvent> events)
void	close()
void	eventArrived(AuditEvent evt) this will block if the queue is full !
void	eventsArrived(Collection<AuditEvent> events) This method is called for notifying the listener of arrival of several events in a block.
int	eventsPending()
String[]	getColumnNames()
String	getFile()
double[]	getStatistics() Returns the number of events written since the last call of this method.
boolean	hasEventsPending()
int	left()
int	length()
void	run()
void	setSteadyWriter(boolean b) A writer not being steady just writes it queue on disk and exits.
void	writeEvent(AuditEvent evt)

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

VERSION

public static final String VERSION

See Also:

Constant Field Values

Constructor Detail

AuditLogFileWriter

public AuditLogFileWriter(File dir,
                  int logLevel,
                  String groupBy)

This constructor creates a new instance of this class which writes events to several files grouped by a request-property that is given by groupBy.

Parameters:

dir - The basic directory where the files are created.

logLevel - A log-level for debugging.

groupBy - The name of the property by which events should by grouped.

AuditLogFileWriter

public AuditLogFileWriter(File dir,
                  boolean hostBased,
                  int logLevel)

Method Detail

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

writeEvent

public void writeEvent(AuditEvent evt)
                throws IOException

Specified by:

writeEvent in interface AuditEventWriter

Throws:

IOException

eventArrived

public void eventArrived(AuditEvent evt)

this will block if the queue is full ! Needs fixing!

Specified by:

eventArrived in interface EventListener<AuditEvent>

Specified by:

eventArrived in interface AuditEventListener

Parameters:

evt - The event which arrived.

add

public void add(AuditEvent evt)

add

public void add(Collection<AuditEvent> evts)

addEventListener

public void addEventListener(AuditEventListener listener)

getStatistics

public double[] getStatistics()

Returns the number of events written since the last call of this method.

getColumnNames

public String[] getColumnNames()

getFile

public String getFile()

addAlias

public void addAlias(String alias,
            String server)

This method lets you specify an alias for a webserver so that events having this alias in their Host:-header will be written to the same file as the ones with the server-name in the Host-header.

Parameters:

alias -

server -

hasEventsPending

public boolean hasEventsPending()

eventsPending

public int eventsPending()

eventsArrived

public void eventsArrived(Collection<AuditEvent> events)

Description copied from interface: AuditEventListener

This method is called for notifying the listener of arrival of several events in a block. Usually, this method is implemented by calling AuditEventListener.eventArrived(AuditEvent) for each of the given events, but may be handled in a more efficient way by implementations capable of processing blocks of events.

Specified by:

eventsArrived in interface AuditEventListener

Parameters:

events - The block of events arrived.

addEvents

public void addEvents(Collection<AuditEvent> events)

length

public int length()

left

public int left()

setSteadyWriter

public void setSteadyWriter(boolean b)

A writer not being steady just writes it queue on disk and exits. A steady writer will wait for new events and then start writing again...

Parameters:

b -

close

public void close()