Class RandomAccessFileManager

java.lang.Object

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

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

org.apache.logging.log4j.core.appender.RandomAccessFileManager

All Implemented Interfaces:

AutoCloseable, ByteBufferDestination

public class RandomAccessFileManager
extends OutputStreamManager

Extends OutputStreamManager 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

Modifier and Type	Class	Description
private static class	RandomAccessFileManager.FactoryData	Factory Data.
private static class	RandomAccessFileManager.RandomAccessFileManagerFactory	Factory to create a RandomAccessFileManager.

Nested classes/interfaces inherited from class AbstractManager

AbstractManager.AbstractFactoryData

Field Summary

Fields

Modifier and Type	Field	Description
private final String	advertiseURI
(package private) static final int	DEFAULT_BUFFER_SIZE
private static final RandomAccessFileManager.RandomAccessFileManagerFactory	FACTORY
private final RandomAccessFile	randomAccessFile

Fields inherited from class OutputStreamManager

byteBuffer, layout

Fields inherited from class AbstractManager

count, LOGGER

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RandomAccessFileManager(LoggerContext loggerContext, RandomAccessFile file, String fileName, OutputStream os, int bufferSize, String advertiseURI, Layout<? extends Serializable> layout, boolean writeHeader)

Method Summary

Modifier and Type	Method	Description
boolean	closeOutputStream()
void	flush()	Flushes any buffers.
int	getBufferSize()	Returns the buffer capacity.
Map<String,String>	getContentFormat()	Gets this FileManager's content format specified by:
static RandomAccessFileManager	getFileManager(String fileName, boolean append, boolean immediateFlush, int bufferSize, String advertiseURI, Layout<? extends Serializable> layout, Configuration configuration)	Returns the RandomAccessFileManager.
String	getFileName()	Returns the name of the File being managed.
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.
protected void	writeToDestination(byte[] bytes, int offset, int length)	Writes the specified section of the specified byte array to the stream.

Methods inherited from class OutputStreamManager

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

Methods inherited from class AbstractManager

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

Methods inherited from class Object

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

Field Details

DEFAULT_BUFFER_SIZE

static final int DEFAULT_BUFFER_SIZE

See Also:

• Constant Field Values

FACTORY

private static final RandomAccessFileManager.RandomAccessFileManagerFactory FACTORY

advertiseURI

private final String advertiseURI

randomAccessFile

private final RandomAccessFile randomAccessFile

Constructor Details

RandomAccessFileManager

protected RandomAccessFileManager(LoggerContext loggerContext,
 RandomAccessFile file,
 String fileName,
 OutputStream os,
 int bufferSize,
 String advertiseURI,
 Layout<? extends Serializable> layout,
 boolean writeHeader)

Method Details

getFileManager

public static RandomAccessFileManager getFileManager(String fileName,
 boolean append,
 boolean immediateFlush,
 int bufferSize,
 String advertiseURI,
 Layout<? extends Serializable> layout,
 Configuration configuration)

Returns the RandomAccessFileManager.

Parameters:

fileName - The name of the file to manage.

append - true if the file should be appended to, false if it should be overwritten.

immediateFlush - true if the contents should be flushed to disk on every write

bufferSize - The buffer size.

advertiseURI - the URI to use when advertising the file

layout - The layout.

configuration - The configuration.

Returns:

A RandomAccessFileManager for the File.

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.

writeToDestination

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

Description copied from class: OutputStreamManager

Writes the specified section of the specified byte array to the stream.

Overrides:

writeToDestination in class OutputStreamManager

Parameters:

bytes - the array containing data

offset - from where to write

length - how many bytes to write

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

getFileName

public String getFileName()

Returns the name of the File being managed.

Returns:

The name of the File being managed.

getBufferSize

public int getBufferSize()

Returns the buffer capacity.

Returns:

the buffer size

getContentFormat

public Map<String,String> getContentFormat()

Gets this FileManager's content format specified by:

Key: "fileURI" Value: provided "advertiseURI" param.

Overrides:

getContentFormat in class AbstractManager

Returns:

Map of content format keys supporting FileManager