Class MemoryMappedFileAppender

All Implemented Interfaces:
Appender, Filterable, LocationAware, LifeCycle, LifeCycle2

@Plugin(name="MemoryMappedFile", category="Core", elementType="appender", printObject=true) public final class MemoryMappedFileAppender extends AbstractOutputStreamAppender<MemoryMappedFileManager>
Memory Mapped File Appender.
Since:
2.1
  • Method Details

    • stop

      public boolean stop(long timeout, TimeUnit timeUnit)
      Description copied from class: AbstractFilterable
      Cleanup the Filter.
      Specified by:
      stop in interface LifeCycle2
      Overrides:
      stop in class AbstractOutputStreamAppender<MemoryMappedFileManager>
      Parameters:
      timeout - the maximum time to wait
      timeUnit - the time unit of the timeout argument
      Returns:
      true if the receiver was stopped cleanly and normally, false otherwise.
    • getFileName

      public String getFileName()
      Returns the file name this appender is associated with.
      Returns:
      The File name.
    • getRegionLength

      public int getRegionLength()
      Returns the length of the memory mapped region.
      Returns:
      the length of the memory mapped region
    • createAppender

      @Deprecated public static <B extends MemoryMappedFileAppender.Builder<B>> MemoryMappedFileAppender createAppender(String fileName, String append, String name, String immediateFlush, String regionLengthStr, String ignore, Layout<? extends Serializable> layout, Filter filter, String advertise, String advertiseURI, Configuration config)
      Deprecated.
      Create a Memory Mapped File Appender.
      Parameters:
      fileName - The name and path of the file.
      append - "True" if the file should be appended to, "false" if it should be overwritten. The default is "true".
      name - The name of the Appender.
      immediateFlush - "true" if the contents should be flushed on every write, "false" otherwise. The default is "false".
      regionLengthStr - The buffer size, defaults to 33554432.
      ignore - If "true" (default) exceptions encountered when appending events are logged; otherwise they are propagated to the caller.
      layout - The layout to use to format the event. If no layout is provided the default PatternLayout will be used.
      filter - The filter, if any, to use.
      advertise - "true" if the appender configuration should be advertised, "false" otherwise.
      advertiseURI - The advertised URI which can be used to retrieve the file contents.
      config - The Configuration.
      Returns:
      The FileAppender.
    • newBuilder

      @PluginBuilderFactory public static <B extends MemoryMappedFileAppender.Builder<B>> B newBuilder()