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:

java.lang.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.

Field Summary

Fields

Modifier and Type	Field	Description
static 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, java.io.RandomAccessFile raf, java.lang.String fileName, java.lang.String pattern, java.io.OutputStream os, boolean append, boolean immediateFlush, int bufferSize, long size, long time, TriggeringPolicy policy, RolloverStrategy strategy, java.lang.String advertiseURI, Layout<? extends java.io.Serializable> layout, boolean writeHeader)	Deprecated.
RollingRandomAccessFileManager(LoggerContext loggerContext, java.io.RandomAccessFile raf, java.lang.String fileName, java.lang.String pattern, java.io.OutputStream os, boolean append, boolean immediateFlush, int bufferSize, long size, long initialTime, TriggeringPolicy policy, RolloverStrategy strategy, java.lang.String advertiseURI, Layout<? extends java.io.Serializable> layout, java.lang.String filePermissions, java.lang.String fileOwner, java.lang.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(java.lang.String fileName, java.lang.String filePattern, boolean isAppend, boolean immediateFlush, int bufferSize, TriggeringPolicy policy, RolloverStrategy strategy, java.lang.String advertiseURI, Layout<? extends java.io.Serializable> layout, java.lang.String filePermissions, java.lang.String fileOwner, java.lang.String fileGroup, Configuration configuration)
java.lang.Boolean	isEndOfBatch()
void	setEndOfBatch(boolean endOfBatch)
void	updateData(java.lang.Object data)
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

checkRollover, getFileExtension, getFileManager, getFileName, getFileSize, getFileTime, getPatternProcessor, getRolloverStrategy, getTriggeringPolicy, initialize, isRenameEmptyFiles, releaseSub, 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

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

close, getCount, getLoggerContext, getManager, getName, 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 Detail

DEFAULT_BUFFER_SIZE

public static final int DEFAULT_BUFFER_SIZE

The default buffer size.

See Also:

Constant Field Values

Constructor Detail

RollingRandomAccessFileManager

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

Deprecated.

RollingRandomAccessFileManager

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

Since:

2.8.3

Method Detail

getRollingRandomAccessFileManager

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

isEndOfBatch

public java.lang.Boolean isEndOfBatch()

setEndOfBatch

public void setEndOfBatch(boolean endOfBatch)

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 java.io.IOException

Overrides:

createFileAfterRollover in class RollingFileManager

Throws:

java.io.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(java.lang.Object data)

Overrides:

updateData in class RollingFileManager