Class Constants

java.lang.Object
org.apache.logging.log4j.util.Constants

public final class Constants extends Object
Log4j API Constants.
Since:
2.6.2
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final byte[]
    The empty array.
    static final Object[]
    The empty array.
    static final boolean
    Kill switch for object pooling in ThreadLocals that enables much of the LOG4J2-1270 no-GC behaviour.
    static final boolean
    true if we think we are running in a web container, based on the boolean value of system property "log4j2.is.webapp", or (if this system property is not set) whether the javax.servlet.Servlet class is present in the classpath.
    static final int
    Java major version.
    static final String
    Name of the system property that will turn on TRACE level internal log4j2 status logging.
    static final int
    Maximum size of the StringBuilders used in RingBuffer LogEvents to store the contents of reusable Messages.
  • Method Summary

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • IS_WEB_APP

      public static final boolean IS_WEB_APP
      true if we think we are running in a web container, based on the boolean value of system property "log4j2.is.webapp", or (if this system property is not set) whether the javax.servlet.Servlet class is present in the classpath.
    • ENABLE_THREADLOCALS

      public static final boolean ENABLE_THREADLOCALS
      Kill switch for object pooling in ThreadLocals that enables much of the LOG4J2-1270 no-GC behaviour.

      True for non-web apps, disable by setting system property "log4j2.enable.threadlocals" to "false".

    • JAVA_MAJOR_VERSION

      public static final int JAVA_MAJOR_VERSION
      Java major version.
    • MAX_REUSABLE_MESSAGE_SIZE

      public static final int MAX_REUSABLE_MESSAGE_SIZE
      Maximum size of the StringBuilders used in RingBuffer LogEvents to store the contents of reusable Messages. After a large message has been delivered to the appenders, the StringBuilder is trimmed to this size.

      The default value is 518, which allows the StringBuilder to resize three times from its initial size. Users can override with system property "log4j.maxReusableMsgSize".

      Since:
      2.9
    • LOG4J2_DEBUG

      public static final String LOG4J2_DEBUG
      Name of the system property that will turn on TRACE level internal log4j2 status logging.

      If system property "log4j2.debug" is either defined empty or its value equals to true (ignoring case), all internal log4j2 logging will be printed to the console. The presence of this system property overrides any value set in the configuration's <Configuration status="<level>" ...> status attribute, as well as any value set for system property org.apache.logging.log4j.simplelog.StatusLogger.level.

      See Also:
    • EMPTY_OBJECT_ARRAY

      public static final Object[] EMPTY_OBJECT_ARRAY
      The empty array.
    • EMPTY_BYTE_ARRAY

      public static final byte[] EMPTY_BYTE_ARRAY
      The empty array.