org.jwall.web.audit.net
Class NetworkAuditEventSource

java.lang.Object
  extended by java.lang.Thread
      extended by org.jwall.web.audit.net.NetworkAuditEventSource
All Implemented Interfaces:
java.lang.Runnable, AuditEventSource
Direct Known Subclasses:
SSLNetworkAuditEventSource

public class NetworkAuditEventSource
extends java.lang.Thread
implements AuditEventSource

This class implements a network client-thread that will connect to a given host and then wait for audit-events to be read from that connection.

Author:
Christian Bockermann <chris@jwall.org>

Nested Class Summary
 
Nested classes/interfaces inherited from class java.lang.Thread
java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler
 
Field Summary
 
Fields inherited from class java.lang.Thread
MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY
 
Constructor Summary
protected NetworkAuditEventSource(java.net.Socket s)
           
  NetworkAuditEventSource(java.lang.String host, int port, boolean ssl)
           
 
Method Summary
 void addEventListener(AuditEventListener l)
           
 void close()
           
 boolean connect(java.lang.String login, java.lang.String pass)
           
 boolean hasNext()
          This method returns true if there is at least one more event pending, so if hasNext returns true, the next call to nextEvent should neither fail nor throw an exception.
 AuditEventImpl nextEvent()
          Returns the next available AuditEvent.
 void removeEventListener(AuditEventListener l)
           
 void run()
           
 void setFilter(AuditEventFilter f)
          This sets a filter on the source.
 
Methods inherited from class java.lang.Thread
activeCount, checkAccess, 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
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

NetworkAuditEventSource

protected NetworkAuditEventSource(java.net.Socket s)
                           throws java.lang.Exception
Throws:
java.lang.Exception

NetworkAuditEventSource

public NetworkAuditEventSource(java.lang.String host,
                               int port,
                               boolean ssl)
                        throws java.lang.Exception
Throws:
java.lang.Exception
Method Detail

addEventListener

public void addEventListener(AuditEventListener l)

removeEventListener

public void removeEventListener(AuditEventListener l)

hasNext

public boolean hasNext()
Description copied from interface: AuditEventSource
This method returns true if there is at least one more event pending, so if hasNext returns true, the next call to nextEvent should neither fail nor throw an exception.

Specified by:
hasNext in interface AuditEventSource
Returns:
true iff there is another event available.

nextEvent

public AuditEventImpl nextEvent()
Description copied from interface: AuditEventSource
Returns the next available AuditEvent. If no event is available null is returned.

Specified by:
nextEvent in interface AuditEventSource
Returns:
The next event.

setFilter

public void setFilter(AuditEventFilter f)
Description copied from interface: AuditEventSource
This sets a filter on the source. A source should only return events that match this filter or all events, if no filter is set. To disable filtering filter can be set to null.

Specified by:
setFilter in interface AuditEventSource
Parameters:
f - The filter that determines the events which are returned.

connect

public boolean connect(java.lang.String login,
                       java.lang.String pass)
                throws java.lang.Exception
Throws:
java.lang.Exception

run

public void run()
Specified by:
run in interface java.lang.Runnable
Overrides:
run in class java.lang.Thread

close

public void close()