log4cxx::rolling::FixedWindowRollingPolicy Class Reference

When rolling over, FixedWindowRollingPolicy renames files according to a fixed window algorithm as described below. More...

#include <fixedwindowrollingpolicy.h>

Inheritance diagram for log4cxx::rolling::FixedWindowRollingPolicy:

Public Member Functions
	FixedWindowRollingPolicy ()
	~FixedWindowRollingPolicy ()
void	activateOptions (helpers::Pool &p) override
void	setOption (const LogString &option, const LogString &value) override
	Set option to value.
void	rollover ()
int	getMaxIndex () const
int	getMinIndex () const
void	setMaxIndex (int newVal)
void	setMinIndex (int newVal)
RolloverDescriptionPtr	initialize (const LogString &currentActiveFile, bool append, helpers::Pool &p) override
	Deprecated The pool parameter is not used and will be removed in a future version. Implement this method for now, but plan to migrate to initialize() without a helpers::Pool parameter.
RolloverDescriptionPtr	rollover (const LogString &currentActiveFile, bool append, helpers::Pool &p) override
	Deprecated The pool parameter is not used and will be removed in a future version. Implement this method for now, but plan to migrate to rollover() without a helpers::Pool parameter.
RolloverDescriptionPtr	initialize (const LogString &currentActiveFile, bool append)
	Initialize the policy and return any initial actions for rolling file appender.
RolloverDescriptionPtr	rollover (const LogString &currentActiveFile, bool append)
	Prepare for a rollover.
Public Member Functions inherited from log4cxx::rolling::RollingPolicyBase
	RollingPolicyBase ()
virtual	~RollingPolicyBase ()
void	activateOptions (helpers::Pool &p) override
void	setOption (const LogString &option, const LogString &value) override
	Set option to value.
void	setFileNamePattern (const LogString &fnp)
	Set file name pattern.
LogString	getFileNamePattern () const
	Get file name pattern.
bool	getCreateIntermediateDirectories () const
void	setCreateIntermediateDirectories (bool createIntermediate)
PatternConverterList	getPatternConverterList () const
void	activateOptions ()
Public Member Functions inherited from log4cxx::rolling::RollingPolicy
virtual	~RollingPolicy ()
RolloverDescriptionPtr	initialize (const LogString &currentActiveFile, bool append)
	Initialize the policy and return any initial actions for rolling file appender.
RolloverDescriptionPtr	rollover (const LogString &currentActiveFile, bool append)
	Prepare for a rollover.
Public Member Functions inherited from log4cxx::spi::OptionHandler
virtual	~OptionHandler ()
void	activateOptions ()
Public Member Functions inherited from log4cxx::helpers::Object
virtual	~Object ()
virtual const helpers::Class &	getClass () const =0
virtual bool	instanceof (const Class &clazz) const =0
virtual const void *	cast (const Class &clazz) const =0

Protected Member Functions
log4cxx::pattern::PatternMap	getFormatSpecifiers () const override
	A map from "i" and "index" to a integer conversion formatter.
Protected Member Functions inherited from log4cxx::rolling::RollingPolicyBase
	RollingPolicyBase (LOG4CXX_PRIVATE_PTR(RollingPolicyBasePrivate) priv)
void	parseFileNamePattern ()
	Parse file name pattern.
void	formatFileName (const helpers::ObjectPtr &obj, LogString &buf) const
	Format file name.
log4cxx::pattern::PatternConverterPtr	getIntegerPatternConverter () const
log4cxx::pattern::PatternConverterPtr	getDatePatternConverter () const
void	formatFileName (const helpers::ObjectPtr &obj, LogString &buf, helpers::Pool &p) const

Detailed Description

When rolling over, FixedWindowRollingPolicy renames files according to a fixed window algorithm as described below.

The ActiveFileName property, which is required, represents the name of the file where current logging output will be written. The FileNamePattern option represents the file name pattern for the archived (rolled over) log files. If present, the FileNamePattern option must include an integer token, that is the string "%i" somwhere within the pattern.

Let max and min represent the values of respectively the MaxIndex and MinIndex options. Let "foo.log" be the value of the ActiveFile option and "foo.%i.log" the value of FileNamePattern. Then, when rolling over, the file foo.max.log will be deleted, the file foo.max-1.log will be renamed as foo.max.log, the file foo.max-2.log renamed as foo.max-1.log, and so on, the file foo.min+1.log renamed as foo.min+2.log. Lastly, the active file foo.log will be renamed as foo.min.log and a new active file name foo.log will be created.

Given that this rollover algorithm requires as many file renaming operations as the window size, large window sizes are discouraged. The current implementation will automatically reduce the window size to 12 when larger values are specified by the user.

Constructor & Destructor Documentation

FixedWindowRollingPolicy()

log4cxx::rolling::FixedWindowRollingPolicy::FixedWindowRollingPolicy

(

)

~FixedWindowRollingPolicy()

log4cxx::rolling::FixedWindowRollingPolicy::~FixedWindowRollingPolicy

(

)

Member Function Documentation

activateOptions()

void log4cxx::rolling::FixedWindowRollingPolicy::activateOptions ( helpers::Pool & p )

overridevirtual

Logs a warning if an option is not valid.

See also

RollingPolicyBase::activateOptions()

Implements log4cxx::spi::OptionHandler.

getFormatSpecifiers()

log4cxx::pattern::PatternMap log4cxx::rolling::FixedWindowRollingPolicy::getFormatSpecifiers ( ) const

overrideprotectedvirtual

A map from "i" and "index" to a integer conversion formatter.

See also

IntegerPatternConverter

Implements log4cxx::rolling::RollingPolicyBase.

getMaxIndex()

int log4cxx::rolling::FixedWindowRollingPolicy::getMaxIndex

(

)

const

getMinIndex()

int log4cxx::rolling::FixedWindowRollingPolicy::getMinIndex

(

)

const

initialize() [1/2]

RolloverDescriptionPtr log4cxx::rolling::RollingPolicy::initialize	(	const LogString &	currentActiveFile,
		bool	append )

Initialize the policy and return any initial actions for rolling file appender.

Parameters

currentActiveFile	current value of RollingFileAppender.getFile().
append	current value of RollingFileAppender.getAppend().

Returns

Description of the initialization, may be null to indicate no initialization needed.

initialize() [2/2]

RolloverDescriptionPtr log4cxx::rolling::FixedWindowRollingPolicy::initialize ( const LogString & currentActiveFile, bool append, helpers::Pool & p )

overridevirtual

Deprecated

The pool parameter is not used and will be removed in a future version. Implement this method for now, but plan to migrate to initialize() without a helpers::Pool parameter.

Implements log4cxx::rolling::RollingPolicy.

rollover() [1/3]

void log4cxx::rolling::FixedWindowRollingPolicy::rollover

(

)

rollover() [2/3]

RolloverDescriptionPtr log4cxx::rolling::RollingPolicy::rollover	(	const LogString &	currentActiveFile,
		bool	append )

Prepare for a rollover.

This method is called prior to closing the active log file, performs any necessary preliminary actions and describes actions needed after close of current log file.

Parameters

currentActiveFile	file name for current active log file.
append	current value of the parent FileAppender.getAppend().

Returns

Description of pending rollover, may be null to indicate no rollover at this time.

rollover() [3/3]

RolloverDescriptionPtr log4cxx::rolling::FixedWindowRollingPolicy::rollover ( const LogString & currentActiveFile, bool append, helpers::Pool & p )

overridevirtual

Deprecated

The pool parameter is not used and will be removed in a future version. Implement this method for now, but plan to migrate to rollover() without a helpers::Pool parameter.

Implements log4cxx::rolling::RollingPolicy.

setMaxIndex()

void log4cxx::rolling::FixedWindowRollingPolicy::setMaxIndex

(

int

newVal

)

setMinIndex()

void log4cxx::rolling::FixedWindowRollingPolicy::setMinIndex

(

int

newVal

)

setOption()

void log4cxx::rolling::FixedWindowRollingPolicy::setOption ( const LogString & option, const LogString & value )

overridevirtual

Set option to value.

Supported options	Supported values	Default value
MinIndex	1-12	1
MaxIndex	1-12	7
ThrowIOExceptionOnForkFailure	True,False	True

See also

RollingPolicyBase::setOption()

Implements log4cxx::spi::OptionHandler.

---

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

• fixedwindowrollingpolicy.h