DCMTK  Version 3.6.1 20121102
OFFIS DICOM Toolkit
 All Classes Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions | List of all members
dcmtk::log4cplus::FileAppender Class Reference

Appends log events to a file. More...

+ Inheritance diagram for dcmtk::log4cplus::FileAppender:
+ Collaboration diagram for dcmtk::log4cplus::FileAppender:

Public Member Functions

 FileAppender (const tstring &filename, DCMTK_LOG4CPLUS_OPEN_MODE_TYPE mode=DCMTK_LOG4CPLUS_FSTREAM_NAMESPACE::ios::trunc, bool immediateFlush=true)
 
 FileAppender (const helpers::Properties &properties, tstring &error, DCMTK_LOG4CPLUS_OPEN_MODE_TYPE mode=DCMTK_LOG4CPLUS_FSTREAM_NAMESPACE::ios::trunc)
 
virtual void close ()
 
- Public Member Functions inherited from dcmtk::log4cplus::Appender
 Appender (const helpers::Properties properties)
 
void destructorImpl ()
 
void doAppend (const spi::InternalLoggingEvent &event)
 This method performs threshold checks and invokes filters before delegating actual logging to the subclasses specific append method.
 
virtual tstring getName ()
 Get the name of this appender. More...
 
virtual void setName (const tstring &name)
 Set the name of this appender. More...
 
virtual void setErrorHandler (OFauto_ptr< ErrorHandler > eh)
 Set the ErrorHandler for this Appender.
 
virtual ErrorHandlergetErrorHandler ()
 Return the currently set ErrorHandler for this Appender.
 
virtual void setLayout (OFauto_ptr< Layout > layout)
 Set the layout for this appender. More...
 
virtual LayoutgetLayout ()
 Returns the layout of this appender. More...
 
void setFilter (spi::FilterPtr f)
 Set the filter chain on this Appender.
 
spi::FilterPtr getFilter () const
 Get the filter chain on this Appender.
 
LogLevel getThreshold () const
 Returns this appenders threshold LogLevel. More...
 
void setThreshold (LogLevel th)
 Set the threshold LogLevel. More...
 
bool isAsSevereAsThreshold (LogLevel ll) const
 Check whether the message LogLevel is below the appender's threshold. More...
 
- Public Member Functions inherited from dcmtk::log4cplus::helpers::SharedObject
void addReference () const
 
void removeReference () const
 

Protected Member Functions

virtual void append (const spi::InternalLoggingEvent &event)
 
void open (DCMTK_LOG4CPLUS_OPEN_MODE_TYPE mode)
 
bool reopen ()
 

Protected Attributes

bool immediateFlush
 Immediate flush means that the underlying writer or output stream will be flushed at the end of each append operation. More...
 
int reopenDelay
 When any append operation fails, reopenDelay says for how many seconds the next attempt to re-open the log file and resume logging will be delayed. More...
 
tofstream out
 
tstring filename
 
helpers::Time reopen_time
 
- Protected Attributes inherited from dcmtk::log4cplus::Appender
OFauto_ptr< Layoutlayout
 The layout variable does not need to be set if the appender implementation has its own layout. More...
 
tstring name
 Appenders are named. More...
 
LogLevel threshold
 There is no LogLevel threshold filtering by default. More...
 
spi::FilterPtr filter
 The first filter in the filter chain. More...
 
OFauto_ptr< ErrorHandlererrorHandler
 It is assumed and enforced that errorHandler is never null. More...
 
bool closed
 Is this appender closed?
 

Private Member Functions

void init (const tstring &filename, DCMTK_LOG4CPLUS_OPEN_MODE_TYPE mode)
 
 FileAppender (const FileAppender &)
 
FileAppenderoperator= (const FileAppender &)
 

Additional Inherited Members

- Public Attributes inherited from dcmtk::log4cplus::helpers::SharedObject
DCMTK_LOG4CPLUS_MUTEX_PTR_DECLARE access_mutex
 

Detailed Description

Appends log events to a file.

Properties

File

This property specifies output file name.

ImmediateFlush

When it is set true, output stream will be flushed after each appended event.

Append

When it is set true, output file will be appended to instead of being truncated at opening.

ReopenDelay
This property sets a delay after which the appender will try to reopen log file again, after last logging failure. The default value is 1 second. Setting the delay to 0 makes the appender not to try reopening the stream.

Member Data Documentation

bool dcmtk::log4cplus::FileAppender::immediateFlush
protected

Immediate flush means that the underlying writer or output stream will be flushed at the end of each append operation.

Immediate flush is slower but ensures that each append request is actually written. If immediateFlush is set to false, then there is a good chance that the last few logs events are not actually written to persistent media if and when the application crashes.

The immediateFlush variable is set to true by default.

int dcmtk::log4cplus::FileAppender::reopenDelay
protected

When any append operation fails, reopenDelay says for how many seconds the next attempt to re-open the log file and resume logging will be delayed.

If reopenDelay is zero, each failed append operation will cause log file to be re-opened. By default, reopenDelay is 1 second.


The documentation for this class was generated from the following file:


Generated on Wed Sep 4 2013 for DCMTK Version 3.6.1 20121102 by Doxygen 1.8.4