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();
}
|