org.apache.log4j.nt
Class NTEventLogAppender

java.lang.Object
  extended by org.apache.log4j.AppenderSkeleton
      extended by org.apache.log4j.nt.NTEventLogAppender
All Implemented Interfaces:
Appender, OptionHandler

public class NTEventLogAppender
extends AppenderSkeleton

Append to the NT event log system.

WARNING This appender can only be installed and used on a Windows system.

Do not forget to place NTEventLogAppender.dll, NTEventLogAppender.amd64.dll, NTEventLogAppender.ia64.dll or NTEventLogAppender.x86.dll as appropriate in a directory that is on the PATH of the Windows system. Otherwise, you will get a java.lang.UnsatisfiedLinkError.

Author:
Chris Taylor, Jim Cakalic

Field Summary
 
Fields inherited from class org.apache.log4j.AppenderSkeleton
closed, errorHandler, headFilter, layout, name, tailFilter, threshold
 
Constructor Summary
NTEventLogAppender()
           
NTEventLogAppender(Layout layout)
           
NTEventLogAppender(String source)
           
NTEventLogAppender(String source, Layout layout)
           
NTEventLogAppender(String server, String source)
           
NTEventLogAppender(String server, String source, Layout layout)
           
 
Method Summary
 void activateOptions()
          Derived appenders should override this method if option structure requires it.
 void append(LoggingEvent event)
          Subclasses of AppenderSkeleton should implement this method to perform actual logging.
 void close()
          Release any resources allocated within the appender such as file handles, network connections, etc.
 void finalize()
          Finalize this appender by calling the derived class' close method.
 String getSource()
           
 boolean requiresLayout()
          The NTEventLogAppender requires a layout.
 void setSource(String source)
          The Source option which names the source of the event.
 
Methods inherited from class org.apache.log4j.AppenderSkeleton
addFilter, clearFilters, doAppend, getErrorHandler, getFilter, getFirstFilter, getLayout, getName, getThreshold, isAsSevereAsThreshold, setErrorHandler, setLayout, setName, setThreshold
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

NTEventLogAppender

public NTEventLogAppender()

NTEventLogAppender

public NTEventLogAppender(String source)

NTEventLogAppender

public NTEventLogAppender(String server,
                          String source)

NTEventLogAppender

public NTEventLogAppender(Layout layout)

NTEventLogAppender

public NTEventLogAppender(String source,
                          Layout layout)

NTEventLogAppender

public NTEventLogAppender(String server,
                          String source,
                          Layout layout)
Method Detail

close

public void close()
Description copied from interface: Appender
Release any resources allocated within the appender such as file handles, network connections, etc.

It is a programming error to append to a closed appender.


activateOptions

public void activateOptions()
Description copied from class: AppenderSkeleton
Derived appenders should override this method if option structure requires it.

Specified by:
activateOptions in interface OptionHandler
Overrides:
activateOptions in class AppenderSkeleton

append

public void append(LoggingEvent event)
Description copied from class: AppenderSkeleton
Subclasses of AppenderSkeleton should implement this method to perform actual logging. See also AppenderSkeleton.doAppend method.

Specified by:
append in class AppenderSkeleton

finalize

public void finalize()
Description copied from class: AppenderSkeleton
Finalize this appender by calling the derived class' close method.

Overrides:
finalize in class AppenderSkeleton

setSource

public void setSource(String source)
The Source option which names the source of the event. The current value of this constant is Source.


getSource

public String getSource()

requiresLayout

public boolean requiresLayout()
The NTEventLogAppender requires a layout. Hence, this method always returns true.



Copyright © 1999-2012 Apache Software Foundation. All Rights Reserved.