Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Annotation Interfaces
• Fields
• Methods
• Constructors
• Enum Constants

Terminally Deprecated Elements

Element	Description
org.apache.logging.log4j.core.config.ConfigurationFactory.getInstance()
org.apache.logging.log4j.core.config.plugins.PluginAliases	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginAttribute	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginBuilderAttribute	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginBuilderFactory	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginElement	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginFactory	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginNode	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginValue	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginAttributeFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginBuilderAttributeFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginElementFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginNodeFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginValueFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.PluginAliasesProvider
org.apache.logging.log4j.core.config.plugins.util.PluginAttributeNameProvider
org.apache.logging.log4j.core.config.plugins.util.PluginBuilderAttributeNameProvider
org.apache.logging.log4j.core.config.plugins.util.PluginElementNameProvider
org.apache.logging.log4j.core.config.plugins.util.PluginValueNameProvider
org.apache.logging.log4j.core.net.UrlConnectionFactory.createConnection(URL, long, SslConfiguration, AuthorizationProvider)
org.apache.logging.log4j.core.time.ClockFactory.clock(PropertyEnvironment)

Deprecated Interfaces

Interface	Description
org.apache.logging.log4j.core.util.Builder	Present only for compatibility with Log4j 2 2.x plugins. Use Builder from log4j-plugins.

Deprecated Classes

Class	Description
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginAttributeFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginBuilderAttributeFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginElementFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginNodeFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.LegacyPluginValueFactoryResolver
org.apache.logging.log4j.core.config.plugins.util.PluginAliasesProvider
org.apache.logging.log4j.core.config.plugins.util.PluginAttributeNameProvider
org.apache.logging.log4j.core.config.plugins.util.PluginBuilderAttributeNameProvider
org.apache.logging.log4j.core.config.plugins.util.PluginElementNameProvider
org.apache.logging.log4j.core.config.plugins.util.PluginValueNameProvider

Deprecated Annotation Interfaces

Annotation Interface	Description
org.apache.logging.log4j.core.config.plugins.PluginAliases	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginAttribute	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginBuilderAttribute	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginBuilderFactory	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginElement	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginFactory	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginNode	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.
org.apache.logging.log4j.core.config.plugins.PluginValue	Exists for compatibility with Log4j 2 2.x plugins. Not used for Log4j 2 3.x plugins.

Deprecated Fields

Field	Description
org.apache.logging.log4j.core.Core.CATEGORY_NAME
org.apache.logging.log4j.core.pattern.ThrowablePatternConverter.formatters	Kept for binary backward compatibility.

Deprecated Methods

Method	Description
org.apache.logging.log4j.core.config.ConfigurationFactory.authorizationProvider(PropertiesUtil)
org.apache.logging.log4j.core.config.ConfigurationFactory.getInstance()
org.apache.logging.log4j.core.config.LoggerConfig.Builder.setIncludeLocation(String)
org.apache.logging.log4j.core.config.LoggerConfig.RootLogger.Builder.setIncludeLocation(String)
org.apache.logging.log4j.core.ContextDataInjector.rawContextData()	Since 2.24.0 use ContextDataInjector.getValue(java.lang.String) instead.
org.apache.logging.log4j.core.impl.ReusableLogEventFactory.release(LogEvent)	use ReusableLogEventFactory.recycle(LogEvent)
org.apache.logging.log4j.core.layout.Rfc5424Layout.Rfc5424LayoutBuilder.setConfig(Configuration)	Since 2.24.0 use AbstractLayout.Builder.setConfiguration(org.apache.logging.log4j.core.config.Configuration) instead.
org.apache.logging.log4j.core.net.UrlConnectionFactory.createConnection(URL, long, SslConfiguration, AuthorizationProvider)
org.apache.logging.log4j.core.pattern.ThrowablePatternConverter.getSuffix(LogEvent)	Planned to be removed without a replacement
org.apache.logging.log4j.core.time.ClockFactory.clock(PropertyEnvironment)
org.apache.logging.log4j.core.time.ClockFactory.getClock()	use dependency injection instead to obtain a Clock instance

Deprecated Constructors

Constructor	Description
org.apache.logging.log4j.core.config.DefaultConfiguration()
org.apache.logging.log4j.core.config.NullConfiguration()
org.apache.logging.log4j.core.impl.JdkMapAdapterStringMap(Map<String, String>)	for performance reasons since 2.23. Use JdkMapAdapterStringMap(Map, boolean) instead.
org.apache.logging.log4j.core.net.ssl.KeyStoreConfiguration(String, char[], String, String)	use KeyStoreConfiguration(String, PasswordProvider, String, String) instead
org.apache.logging.log4j.core.net.ssl.KeyStoreConfiguration(String, String, String, String)	Use KeyStoreConfiguration(String, PasswordProvider, String, String) instead
org.apache.logging.log4j.core.net.ssl.TrustStoreConfiguration(String, char[], String, String)	Use TrustStoreConfiguration(String, PasswordProvider, String, String) instead
org.apache.logging.log4j.core.pattern.ThrowablePatternConverter(String, String, String[])	Use ThrowablePatternConverter(String, String, String[], Configuration, ThrowablePropertyRendererFactory, ThrowableStackTraceRendererFactory) instead.
org.apache.logging.log4j.core.pattern.ThrowablePatternConverter(String, String, String[], Configuration)	Use ThrowablePatternConverter(String, String, String[], Configuration, ThrowablePropertyRendererFactory, ThrowableStackTraceRendererFactory) instead.

Deprecated Enum Constants

Enum Constant	Description
org.apache.logging.log4j.core.pattern.AnsiEscape.BRIGHT	This attribute sets font-weight as "bold" and doesn't set color brightness. Use BOLD if you need to change font-weight and BRIGHT_* to use a bright color.