Package org.apache.logging.log4j.core.appender.rolling

Class RollingRandomAccessFileManager

java.lang.Object

org.apache.logging.log4j.core.appender.AbstractManager

org.apache.logging.log4j.core.appender.OutputStreamManager

org.apache.logging.log4j.core.appender.FileManager

org.apache.logging.log4j.core.appender.rolling.RollingFileManager

org.apache.logging.log4j.core.appender.rolling.RollingRandomAccessFileManager

All Implemented Interfaces:

AutoCloseable, ByteBufferDestination

public class RollingRandomAccessFileManager
extends RollingFileManager

Extends RollingFileManager but instead of using a buffered output stream, this class uses a ByteBuffer and a RandomAccessFile to do the I/O.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.logging.log4j.core.appender.AbstractManager

AbstractManager.AbstractFactoryData

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_BUFFER_SIZE	The default buffer size.

Fields inherited from class org.apache.logging.log4j.core.appender.rolling.RollingFileManager

size

Fields inherited from class org.apache.logging.log4j.core.appender.OutputStreamManager

byteBuffer, layout

Fields inherited from class org.apache.logging.log4j.core.appender.AbstractManager

count, LOGGER

Constructor Summary

Constructors

Constructor	Description
RollingRandomAccessFileManager(LoggerContext loggerContext, RandomAccessFile raf, String fileName, String pattern, OutputStream os, boolean append, boolean immediateFlush, int bufferSize, long size, long time, TriggeringPolicy policy, RolloverStrategy strategy, String advertiseURI, Layout<? extends Serializable> layout, boolean writeHeader)	Deprecated.
RollingRandomAccessFileManager(LoggerContext loggerContext, RandomAccessFile raf, String fileName, String pattern, OutputStream os, boolean append, boolean immediateFlush, int bufferSize, long size, long initialTime, TriggeringPolicy policy, RolloverStrategy strategy, String advertiseURI, Layout<? extends Serializable> layout, String filePermissions, String fileOwner, String fileGroup, boolean writeHeader)

Method Summary

Modifier and Type	Method	Description
boolean	closeOutputStream()
protected void	createFileAfterRollover()
void	flush()	Flushes any buffers.
int	getBufferSize()	Returns the buffer capacity.
static RollingRandomAccessFileManager	getRollingRandomAccessFileManager(String fileName, String filePattern, boolean isAppend, boolean immediateFlush, int bufferSize, TriggeringPolicy policy, RolloverStrategy strategy, String advertiseURI, Layout<? extends Serializable> layout, String filePermissions, String fileOwner, String fileGroup, Configuration configuration)
Boolean	isEndOfBatch()	Deprecated. end-of-batch on the event is used instead.
void	setEndOfBatch(boolean endOfBatch)	Deprecated. end-of-batch on the event is used instead.
void	updateData(Object data)	Updates the RollingFileManager's data during a reconfiguration.
protected void	write(byte[] bytes, int offset, int length, boolean immediateFlush)	Some output streams synchronize writes while others do not.
protected void	writeToDestination(byte[] bytes, int offset, int length)	Overrides OutputStreamManager.writeToDestination(byte[], int, int) to add support for file locking.

Methods inherited from class org.apache.logging.log4j.core.appender.rolling.RollingFileManager

addRolloverListener, checkRollover, createParentDir, getFileExtension, getFileManager, getFileName, getFileSize, getFileTime, getPatternProcessor, getRolloverStrategy, getTriggeringPolicy, initialize, isDirectWrite, isRenameEmptyFiles, releaseSub, removeRolloverListener, rollover, rollover, setPatternProcessor, setRenameEmptyFiles, setRolloverStrategy, setTriggeringPolicy

Methods inherited from class org.apache.logging.log4j.core.appender.FileManager

createOutputStream, defineAttributeView, getContentFormat, getFileGroup, getFileManager, getFileOwner, getFilePermissions, isAppend, isAttributeViewEnabled, isCreateOnDemand, isLocking

Methods inherited from class org.apache.logging.log4j.core.appender.OutputStreamManager

drain, flushBuffer, flushDestination, getByteBuffer, getManager, getOutputStream, hasOutputStream, isOpen, setOutputStream, skipFooter, write, write, write, writeBytes, writeBytes, writeFooter, writeHeader

Methods inherited from class org.apache.logging.log4j.core.appender.AbstractManager

close, getCount, getLoggerContext, getManager, getName, getStrSubstitutor, hasManager, log, logDebug, logError, logger, logWarn, narrow, release, stop

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEFAULT_BUFFER_SIZE

public static final int DEFAULT_BUFFER_SIZE

The default buffer size.

See Also:

• Constant Field Values

Constructor Details

RollingRandomAccessFileManager

@Deprecated
public RollingRandomAccessFileManager(LoggerContext loggerContext,
 RandomAccessFile raf,
 String fileName,
 String pattern,
 OutputStream os,
 boolean append,
 boolean immediateFlush,
 int bufferSize,
 long size,
 long time,
 TriggeringPolicy policy,
 RolloverStrategy strategy,
 String advertiseURI,
 Layout<? extends Serializable> layout,
 boolean writeHeader)

Deprecated.

RollingRandomAccessFileManager

public RollingRandomAccessFileManager(LoggerContext loggerContext,
 RandomAccessFile raf,
 String fileName,
 String pattern,
 OutputStream os,
 boolean append,
 boolean immediateFlush,
 int bufferSize,
 long size,
 long initialTime,
 TriggeringPolicy policy,
 RolloverStrategy strategy,
 String advertiseURI,
 Layout<? extends Serializable> layout,
 String filePermissions,
 String fileOwner,
 String fileGroup,
 boolean writeHeader)

Since:

2.8.3

Method Details

getRollingRandomAccessFileManager

public static RollingRandomAccessFileManager getRollingRandomAccessFileManager(String fileName,
 String filePattern,
 boolean isAppend,
 boolean immediateFlush,
 int bufferSize,
 TriggeringPolicy policy,
 RolloverStrategy strategy,
 String advertiseURI,
 Layout<? extends Serializable> layout,
 String filePermissions,
 String fileOwner,
 String fileGroup,
 Configuration configuration)

isEndOfBatch

@Deprecated
public Boolean isEndOfBatch()

Deprecated.

end-of-batch on the event is used instead.

No longer used, the LogEvent.isEndOfBatch() attribute is used instead.

Returns:

Boolean.FALSE.

setEndOfBatch

@Deprecated
public void setEndOfBatch(boolean endOfBatch)

Deprecated.

end-of-batch on the event is used instead.

No longer used, the LogEvent.isEndOfBatch() attribute is used instead. This method is a no-op.

write

protected void write(byte[] bytes,
 int offset,
 int length,
 boolean immediateFlush)

Description copied from class: OutputStreamManager

Some output streams synchronize writes while others do not. Synchronizing here insures that log events won't be intertwined.

Overrides:

write in class RollingFileManager

Parameters:

bytes - The serialized Log event.

offset - The offset into the byte array.

length - The number of bytes to write.

immediateFlush - flushes immediately after writing.

writeToDestination

protected void writeToDestination(byte[] bytes,
 int offset,
 int length)

Description copied from class: FileManager

Overrides OutputStreamManager.writeToDestination(byte[], int, int) to add support for file locking.

Overrides:

writeToDestination in class RollingFileManager

Parameters:

bytes - the array containing data

offset - from where to write

length - how many bytes to write

createFileAfterRollover

protected void createFileAfterRollover()
                                throws IOException

Overrides:

createFileAfterRollover in class RollingFileManager

Throws:

IOException

flush

public void flush()

Description copied from class: OutputStreamManager

Flushes any buffers.

Overrides:

flush in class OutputStreamManager

closeOutputStream

public boolean closeOutputStream()

Overrides:

closeOutputStream in class OutputStreamManager

getBufferSize

public int getBufferSize()

Returns the buffer capacity.

Overrides:

getBufferSize in class FileManager

Returns:

the buffer size

updateData

public void updateData(Object data)

Updates the RollingFileManager's data during a reconfiguration. This method should be considered private. It is not thread safe and calling it outside of a reconfiguration may lead to errors. This method may be made protected in a future release.

Overrides:

updateData in class RollingFileManager

Parameters:

data - The data to update.