Docs For Class LoggerAppenderSkeleton

Class LoggerAppenderSkeleton

Description

Abstract superclass of the other appenders in the package.

Abstract superclass of the other appenders in the package. This class provides the code for common functionality, such as support for threshold filtering and support for general filters.

abstract:
version: $Revision: 1.8 $
author: Sergio Strampelli <mailto:sergio@ascia.net>
author: VxR <mailto:vxr@vxr.it>

Located in Program_Root/log4php/LoggerAppenderSkeleton.php (line 43)

LoggerAppender
   |
   --LoggerAppenderSkeleton

Direct descendents

Class	Description
LoggerAppenderConsole	ConsoleAppender appends log events to STDOUT or STDERR using a layout specified by the user.
LoggerAppenderDb	Appends log events to a db table using PEAR::DB class.
LoggerAppenderEcho	LoggerAppenderEcho uses http://www.php.net/echo function to output events.
LoggerAppenderFile	FileAppender appends log events to a file.
LoggerAppenderMail	Appends log events to mail using php function http://www.php.net/mail.
LoggerAppenderMailEvent	Log events to an email address.
LoggerAppenderNull	A NullAppender merely exists, it never outputs a message to any device.
LoggerAppenderPhp	Log events using php http://www.php.net/trigger_error function and a LoggerLayoutTTCC default layout.
LoggerAppenderSocket	Serialize events and send them to a network socket.
LoggerAppenderSyslog	Log events using php http://www.php.net/syslog function.

Variable Summary

boolean $closed

object unused $errorHandler

LoggerFilter $headFilter

LoggerLayout $layout

string $name

boolean $requiresLayout

LoggerFilter $tailFilter

LoggerLevel $threshold

Method Summary

LoggerAppenderSkeleton LoggerAppenderSkeleton (string $name)

void activateOptions ()

void addFilter (LoggerFilter $newFilter)

void append (LoggerLoggingEvent $event)

void clearFilters ()

void close ()

void doAppend (LoggerLoggingEvent $event)

void finalize ()

object Returns &getErrorHandler ()

Filter &getFilter ()

Filter &getFirstFilter ()

LoggerLayout &getLayout ()

string getName ()

LoggerLevel getThreshold ()

boolean isAsSevereAsThreshold (LoggerLevel $priority)

boolean requiresLayout ()

void setErrorHandler (object $errorHandler)

void setLayout (LoggerLayout $layout)

void setName (string $name)

void setThreshold (LoggerLevel $threshold)

Variables

boolean $closed (line 48)

var: closed appender flag

object unused $errorHandler (line 53)

LoggerFilter $headFilter = null (line 59)

The first filter in the filter chain

LoggerLayout $layout = null (line 65)

LoggerLayout for this appender.

LoggerLayout for this appender. It can be null if appender has its own layout

string $name (line 70)

var: Appender name

boolean $requiresLayout = false (line 86)

var: needs a layout formatting ?

Redefined in descendants as:

LoggerFilter $tailFilter = null (line 76)

The last filter in the filter chain

LoggerLevel $threshold = null (line 81)

var: There is no level threshold filtering by default.

Methods

Constructor LoggerAppenderSkeleton (line 97)

Constructor

LoggerAppenderSkeleton LoggerAppenderSkeleton (string $name)

string $name: appender name

activateOptions (line 125)

Called after the appender paramters are set with setter methods.

Called after the appender paramters are set with setter methods. Subclasses of LoggerAppenderSkeleton should implement this method to perform proper options setup. By default id does nothing.

void activateOptions ()

Redefined in descendants as:

LoggerAppenderConsole::activateOptions()
LoggerAppenderDb::activateOptions() : Setup db connection.
LoggerAppenderEcho::activateOptions()
LoggerAppenderFile::activateOptions()
LoggerAppenderMail::activateOptions()
LoggerAppenderMailEvent::activateOptions()
LoggerAppenderNull::activateOptions()
LoggerAppenderPhp::activateOptions()
LoggerAppenderSocket::activateOptions() : Create a socket connection using defined parameters
LoggerAppenderSyslog::activateOptions()

addFilter (line 108)

Add a filter to the end of the filter list.

void addFilter (LoggerFilter $newFilter)

LoggerFilter $newFilter: add a new LoggerFilter

append (line 136)

Subclasses of LoggerAppenderSkeleton should implement this method to perform actual logging.

see: LoggerAppenderSkeleton::doAppend()

void append (LoggerLoggingEvent $event)

LoggerLoggingEvent $event

Redefined in descendants as:

clearFilters (line 144)

Clear the list of filters by removing all the filters in it.

void clearFilters ()

close (line 155)

Release any resources allocated.

Release any resources allocated. Subclasses of LoggerAppenderSkeleton should implement this method to perform proper closing procedures.

void close ()

Redefined in descendants as:

doAppend (line 247)

This method performs threshold checks and invokes filters before delegating actual logging to the subclasses specific append() method.

void doAppend (LoggerLoggingEvent $event)

LoggerLoggingEvent $event

finalize (line 164)

Finalize this appender by calling the derived class' close() method.

void finalize ()

getErrorHandler (line 177)

Do not use this method.

return: the ErrorHandler for this appender.

object Returns &getErrorHandler ()

getFilter (line 187)

Return the first filter in the filter chain for this Appender.

Return the first filter in the filter chain for this Appender. The return value may be null if no is filter is set.

Filter &getFilter ()

getFirstFilter (line 197)

Return the first filter in the filter chain for this Appender.

Return the first filter in the filter chain for this Appender. The return value may be null if no is filter is set.

Filter &getFirstFilter ()

getLayout (line 206)

Returns this appender layout.

LoggerLayout &getLayout ()

getName (line 215)

Get the name of this appender.

string getName ()

getThreshold (line 225)

Returns this appenders threshold level.

Returns this appenders threshold level. See the setThreshold() method for the meaning of this option.

LoggerLevel getThreshold ()

isAsSevereAsThreshold (line 237)

Check whether the message level is below the appender's threshold.

Check whether the message level is below the appender's threshold. If there is no threshold set, then the return value is always true.

boolean isAsSevereAsThreshold (LoggerLevel $priority)

LoggerLevel $priority

requiresLayout (line 275)

Configurators call this method to determine if the appender requires a layout.

boolean requiresLayout ()

setErrorHandler (line 285)

Set the ErrorHandler for this appender.

void setErrorHandler (object $errorHandler)

object $errorHandler

setLayout (line 301)

Set the Layout for this appender.

void setLayout (LoggerLayout $layout)

LoggerLayout $layout

setName (line 312)

Set the name of this appender.

void setName (string $name)

string $name

setThreshold (line 322)

Set the threshold level of this appender.

void setThreshold (LoggerLevel $threshold)

LoggerLevel $threshold: a string representation of a level or a level constant.

Inherited Methods

Inherited From LoggerAppender

LoggerAppender::factory()
LoggerAppender::singleton()

Documentation generated on Wed, 10 Sep 2003 22:44:27 +0200 by phpDocumentor 1.2.2