ch.qos.logback.classic.android

Class SQLiteAppender

java.lang.Object

ch.qos.logback.core.spi.ContextAwareBase

ch.qos.logback.core.UnsynchronizedAppenderBase<ILoggingEvent>

ch.qos.logback.classic.android.SQLiteAppender

All Implemented Interfaces:

ch.qos.logback.core.Appender<ILoggingEvent>, ch.qos.logback.core.spi.ContextAware, ch.qos.logback.core.spi.FilterAttachable<ILoggingEvent>, ch.qos.logback.core.spi.LifeCycle

public class SQLiteAppender
extends ch.qos.logback.core.UnsynchronizedAppenderBase<ILoggingEvent>

SQLiteAppender is a logback appender optimized for Android SQLite. It requires no JDBC as it uses the built-in Android SQLite API.

Since:

1.0.11

Field Summary

Fields inherited from class ch.qos.logback.core.UnsynchronizedAppenderBase

name, started

Fields inherited from class ch.qos.logback.core.spi.ContextAwareBase

context

Constructor Summary

Constructors

Constructor and Description
SQLiteAppender()

Method Summary

Modifier and Type	Method and Description
void	append(ILoggingEvent eventObject)
protected void	finalize()
java.io.File	getDatabaseFile(java.lang.String filename) Gets a file object from a file path to a SQLite database
java.lang.String	getFilename() Gets the absolute path to the SQLite database
SQLiteLogCleaner	getLogCleaner() Gets the SQLiteLogCleaner in use.
java.lang.String	getMaxHistory() Get the maximum history in time duration of records to keep
long	getMaxHistoryMs() Gets the maximum history in milliseconds
void	setDbNameResolver(DBNameResolver dbNameResolver) Sets the database name resolver, used to customize the names of the table names and columns in the database.
void	setFilename(java.lang.String filename) Sets the path to the destination SQLite database
void	setLogCleaner(SQLiteLogCleaner logCleaner) Sets the SQLiteLogCleaner, invoked when maxHistory is exceeded at startup and in between logging events
void	setMaxHistory(java.lang.String maxHistory) Set the maximum history in time duration of records to keep
void	start()
void	stop()

Methods inherited from class ch.qos.logback.core.UnsynchronizedAppenderBase

addFilter, clearAllFilters, doAppend, getCopyOfAttachedFiltersList, getFilterChainDecision, getName, isStarted, setName, toString

Methods inherited from class ch.qos.logback.core.spi.ContextAwareBase

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, getDeclaredOrigin, getStatusManager, setContext

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface ch.qos.logback.core.spi.ContextAware

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, setContext

Constructor Detail

SQLiteAppender

public SQLiteAppender()

Method Detail

setDbNameResolver

public void setDbNameResolver(DBNameResolver dbNameResolver)

Sets the database name resolver, used to customize the names of the table names and columns in the database.

Parameters:

dbNameResolver - the desired database name resolver

getMaxHistory

public java.lang.String getMaxHistory()

Get the maximum history in time duration of records to keep

Returns:

max history in time duration (e.g., "1 day")

getMaxHistoryMs

public long getMaxHistoryMs()

Gets the maximum history in milliseconds

Returns:

the max history in milliseconds

setMaxHistory

public void setMaxHistory(java.lang.String maxHistory)

Set the maximum history in time duration of records to keep

Parameters:

maxHistory - max history in time duration (e.g., "2 days")

getFilename

public java.lang.String getFilename()

Gets the absolute path to the SQLite database

Returns:

setFilename

public void setFilename(java.lang.String filename)

Sets the path to the destination SQLite database

Parameters:

filename - absolute path to file

getDatabaseFile

public java.io.File getDatabaseFile(java.lang.String filename)

Gets a file object from a file path to a SQLite database

Parameters:

filename - absolute path to database file

Returns:

the file object if a valid file found; otherwise, null

start

public void start()

Specified by:

start in interface ch.qos.logback.core.spi.LifeCycle

Overrides:

start in class ch.qos.logback.core.UnsynchronizedAppenderBase<ILoggingEvent>

getLogCleaner

public SQLiteLogCleaner getLogCleaner()

Gets the SQLiteLogCleaner in use. Creates default if needed.

setLogCleaner

public void setLogCleaner(SQLiteLogCleaner logCleaner)

Sets the SQLiteLogCleaner, invoked when maxHistory is exceeded at startup and in between logging events

Parameters:

logCleaner -

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

stop

public void stop()

Specified by:

stop in interface ch.qos.logback.core.spi.LifeCycle

Overrides:

stop in class ch.qos.logback.core.UnsynchronizedAppenderBase<ILoggingEvent>

append

public void append(ILoggingEvent eventObject)

Specified by:

append in class ch.qos.logback.core.UnsynchronizedAppenderBase<ILoggingEvent>