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

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.

Field Summary

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

count, LOGGER

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

byteBuffer, layout

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 isFlush, 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()
void	setEndOfBatch(boolean endOfBatch)
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 org.apache.logging.log4j.core.appender.AbstractManager

close, getCount, getLoggerContext, getName, hasManager, log, logDebug, logError, logWarn, narrow, release, stop, updateData

Methods inherited from class java.lang.Object

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

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

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

Constructor Detail

RandomAccessFileManager

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

Method Detail

getFileManager

public static RandomAccessFileManager getFileManager(String fileName,
                                                     boolean append,
                                                     boolean isFlush,
                                                     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.

isFlush - 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

public Boolean isEndOfBatch()

setEndOfBatch

public void setEndOfBatch(boolean endOfBatch)

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