Class JdbcAppender

  extended by org.apache.logging.log4j.core.AbstractLifeCycle
      extended by org.apache.logging.log4j.core.filter.AbstractFilterable
          extended by org.apache.logging.log4j.core.appender.AbstractAppender
              extended by org.apache.logging.log4j.core.appender.db.AbstractDatabaseAppender<JdbcDatabaseManager>
                  extended by org.apache.logging.log4j.core.appender.db.jdbc.JdbcAppender
All Implemented Interfaces:
Appender, Filterable, LifeCycle

public final class JdbcAppender
extends AbstractDatabaseAppender<JdbcDatabaseManager>

This Appender writes logging events to a relational database using standard JDBC mechanisms. It takes a list of ColumnConfigs with which it determines how to save the event data into the appropriate columns in the table. A ConnectionSource plugin instance instructs the appender (and JdbcDatabaseManager) how to connect to the database. This appender can be reconfigured at run time.

See Also:
ColumnConfig, ConnectionSource

Nested Class Summary
Nested classes/interfaces inherited from interface org.apache.logging.log4j.core.LifeCycle
Field Summary
Fields inherited from class org.apache.logging.log4j.core.AbstractLifeCycle
Method Summary
static JdbcAppender createAppender(String name, String ignore, Filter filter, ConnectionSource connectionSource, String bufferSize, String tableName, ColumnConfig[] columnConfigs)
          Factory method for creating a JDBC appender within the plugin manager.
 String toString()
Methods inherited from class org.apache.logging.log4j.core.appender.db.AbstractDatabaseAppender
append, getLayout, getManager, replaceManager, start, stop
Methods inherited from class org.apache.logging.log4j.core.appender.AbstractAppender
error, error, error, getHandler, getName, ignoreExceptions, parseInt, setHandler
Methods inherited from class org.apache.logging.log4j.core.filter.AbstractFilterable
addFilter, getFilter, hasFilter, isFiltered, removeFilter
Methods inherited from class org.apache.logging.log4j.core.AbstractLifeCycle
getState, isInitialized, isStarted, isStarting, isStopped, isStopping, setStarted, setStarting, setState, setStopped, setStopping
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.apache.logging.log4j.core.LifeCycle
isStarted, isStopped

Method Detail


public String toString()
toString in class AbstractAppender


public static JdbcAppender createAppender(@PluginAttribute(value="name")
                                                        String name,
                                                        String ignore,
                                                        Filter filter,
                                                        ConnectionSource connectionSource,
                                                        String bufferSize,
                                                        String tableName,
                                                        ColumnConfig[] columnConfigs)
Factory method for creating a JDBC appender within the plugin manager.

name - The name of the appender.
ignore - If "true" (default) exceptions encountered when appending events are logged; otherwise they are propagated to the caller.
filter - The filter, if any, to use.
connectionSource - The connections source from which database connections should be retrieved.
bufferSize - If an integer greater than 0, this causes the appender to buffer log events and flush whenever the buffer reaches this size.
tableName - The name of the database table to insert log events into.
columnConfigs - Information about the columns that log event data should be inserted into and how to insert that data.
a new JDBC appender.

Copyright © 1999-2014 Apache Software Foundation. All Rights Reserved.
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, the Apache Logging project logo, and the Apache Log4j logo are trademarks of The Apache Software Foundation.