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:

Appender<ILoggingEvent>, ContextAware, FilterAttachable<ILoggingEvent>, LifeCycle

public class SQLiteAppender
extends 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()
File	getDatabaseFile(String filename) Gets a file object from a file path to a SQLite database
String	getFilename()
SQLiteLogCleaner	getLogCleaner() Gets the SQLiteLogCleaner in use.
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(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(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 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(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 String getFilename()

Returns:

the absolute path to the SQLite database

setFilename

public void setFilename(String filename)

Sets the path to the destination SQLite database

Parameters:

filename - absolute path to file

getDatabaseFile

public File getDatabaseFile(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 LifeCycle

Overrides:

start in class 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 Throwable

Overrides:

finalize in class Object

Throws:

Throwable

stop

public void stop()

Specified by:

stop in interface LifeCycle

Overrides:

stop in class UnsynchronizedAppenderBase<ILoggingEvent>

append

public void append(ILoggingEvent eventObject)

Specified by:

append in class UnsynchronizedAppenderBase<ILoggingEvent>