org.apache.logging.log4j.core.util

Interface Builder<T>

Type Parameters:

T - This builder creates instances of this class.

All Known Subinterfaces:

AppenderComponentBuilder, AppenderRefComponentBuilder, ComponentBuilder<T>, CompositeFilterComponentBuilder, ConfigurationBuilder<T>, CustomLevelComponentBuilder, FilterableComponentBuilder<T>, FilterComponentBuilder, LayoutComponentBuilder, LoggableComponentBuilder<T>, LoggerComponentBuilder, RootLoggerComponentBuilder, ScriptComponentBuilder, ScriptFileComponentBuilder

All Known Implementing Classes:

AppenderSet.Builder, AsyncAppender.Builder, BurstFilter.Builder, ConsoleAppender.Builder, DefaultAppenderComponentBuilder, DefaultAppenderRefComponentBuilder, DefaultComponentAndConfigurationBuilder, DefaultComponentBuilder, DefaultCompositeFilterComponentBuilder, DefaultConfigurationBuilder, DefaultCustomLevelComponentBuilder, DefaultFilterComponentBuilder, DefaultLayoutComponentBuilder, DefaultLoggerComponentBuilder, DefaultRootLoggerComponentBuilder, DefaultScriptComponentBuilder, DefaultScriptFileComponentBuilder, FileAppender.Builder, HtmlLayout.Builder, KeyValuePair.Builder, Log4jLogEvent.Builder, MarkerPatternSelector.Builder, MemoryMappedFileAppender.Builder, MimeMessageBuilder, OutputStreamAppender.Builder, PatternLayout.Builder, PatternLayout.SerializerBuilder, PatternMatch.Builder, PluginBuilder, PropertiesConfigurationBuilder, RandomAccessFileAppender.Builder, RollingFileAppender.Builder, RollingRandomAccessFileAppender.Builder, Routes.Builder, RoutingAppender.Builder, ScriptAppenderSelector.Builder, ScriptPatternSelector.Builder, SocketAddress.Builder, SocketAppender.Builder, SocketOptions, SocketPerformancePreferences, SyslogAppender.Builder, SyslogLayout.Builder, WriterAppender.Builder

public interface Builder<T>

A type of builder that can be used to configure and create a instances using a Java DSL instead of through a configuration file. These builders are primarily useful for internal code and unit tests, but they can technically be used as a verbose alternative to configuration files.

When creating plugin builders, it is customary to create the builder class as a public static inner class called Builder. For instance, the builder class for PatternLayout would be PatternLayout.Builder.

Method Summary

Modifier and Type	Method and Description
T	build() Builds the object after all configuration has been set.

Method Detail

build

T build()

Builds the object after all configuration has been set. This will use default values for any unspecified attributes for the object.

Returns:

the configured instance.

Throws:

ConfigurationException - if there was an error building the object.