java.lang.Object
|
+--stec.iws.Logger
public abstract class Logger implement Runnable
Defines methods used by iServer Logger service.
Methods
Method
|
Description
|
init
|
Called by iServer to initialize Logger service.
|
log
|
Used to log messages, exceptions or an access, event or error log entry.
|
output
|
Called by Logger service to output an access, event or error log entry.
|
destroy
|
Called by iServer when stopping Logger service.
|
init
Called to log an access, event or error log entry.
Syntax
public void init(Hashtable parameters)
Parameters
parameters
|
a hashtable containing parameters parsed from basedir/config/logger.ini.
|
Returns
Throws
Exception
|
any exception thrown.
|
Example
public void init(Hashtable parameters) throws Exception
{
super.init(parameters);
Object filename = parameters.get("file_name");
if(filename == null)
{
filename = "log.dat";
}
open_files((String)file_name);
}
log
Used to log messages, exceptions or an access, event or error log entry.
Syntax
public synchronized void log(AccessLogEntry accessEntry)
public synchronized void log(ErrorLogEntry errorEntry)
public synchronized void log(EventLogEntry eventEntry)
public synchronized void log(Throwable exception)
public synchronized void log(Throwable exception, String message)
public synchronized void log(String message)
Parameters
accessEntry
|
an access log entry.
|
errorEntry
|
an error log entry.
|
eventEntry
|
an event log entry.
|
exception
|
an Error or Exception object.
|
message
|
event message to log.
|
Returns
Throws
Example
log(msg);
output
Called by Logger service to output an access, event or error log entry.
Syntax
public abstract void output(AccessLogEntry accessEntry) throws Exception
public abstract void output(EventLogEntry eventEntry) throws Exception
public abstract void output(ErrorLogEntry errorEntry) throws Exception
Parameters
accessEntry
|
an access log entry.
|
eventEntry
|
an event log entry.
|
errorEntry
|
an error log entry.
|
Returns
Throws
Exception
|
any exception thrown.
|
Example
public void output(AccessLogEntry entry) throws Exception
{
logAccess(entry);
}
destroy
Called by iServer when stopping Logger service.
Syntax
public synchronized void destroy()
Parameters
Returns
Throws
Example
public synchronized destroy()
{
super.destroy();
close_files();
}
|