Servertec

Logger

Documentation

Conventions

Command Line

Java API

AccessLogEntry

Codecs

DString

ErrorLogEntry

EventLogEntry

iws

iwsStorage

Logger

ServletManager

Utils

Servlet API

Servlets

Config Files

Log Files

Classes

Directory Tree

Return

java.lang.Object
 |
 +--stec.iws.Logger

public abstract class Logger implement Runnable

Defines methods used by Servertec Internet Server Logger service.

Methods

Method	Description
init	Called by Servertec Internet Server 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 Servertec Internet Server when stopping Logger service.

init

Called to log an access, event or error log entry.

Syntax

public void init(Hashtable parameters) throws Exception

Parameters

parameters

a hashtable containing parameters parsed from basedir/config/logger.ini.

Returns

Nothing

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 void log(AccessLogEntry accessEntry)
public void log(Throwable exception)
public void log(Throwable exception, String message)
public 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

Nothing

Throws

Nothing

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

Nothing

Throws

Exception

any exception thrown.

Example

public void output(AccessLogEntry entry) throws Exception
{
  logAccess(entry);
}

destroy

Called by Servertec Internet Server when stopping Logger service.

Syntax

public void destroy()

Parameters

None

Returns

Nothing

Throws

Nothing

Example

public destroy()
{
  super.destroy();
  close_files();
}

top of page