Class QueryLoggerDispatcher<T>

java.lang.Object

org.refcodes.logger.QueryLoggerDispatcher<T>

Type Parameters:

T - The type of the Record instances managed by the Logger.

All Implemented Interfaces:

Flushable, Closable, ComponentComposite, Decomposable, Destroyable, Flushable, Initializable, LifecycleComponent, LinkComponent, Openable, Pausable, Resumable, Startable, Stoppable, LogDecorator, Logger<T>, QueryLogger<T>, Disposable, Resetable

public class QueryLoggerDispatcher<T>
extends Object
implements ComponentComposite

The QueryLoggerDispatcher is a ready to use implementation of a composite QueryLogger extending the AbstractQueryLoggerDispatcher.

See Also:

• AbstractQueryLoggerDispatcher

Nested Class Summary

Nested classes/interfaces inherited from interface Closable

Closable.CloseAutomaton, Closable.CloseBuilder<B>

Nested classes/interfaces inherited from interface ComponentComposite

ComponentComposite.ExtendedComponentComposite<CTX,CON>

Nested classes/interfaces inherited from interface Decomposable

Decomposable.DecomposeAutomaton

Nested classes/interfaces inherited from interface Destroyable

Destroyable.DestroyAutomaton

Nested classes/interfaces inherited from interface Flushable

Flushable.FlushBuilder<B>

Nested classes/interfaces inherited from interface Initializable

Initializable.InitializeAutomaton, Initializable.InitializeBuilder<B>, Initializable.UncheckedInitializable

Nested classes/interfaces inherited from interface LifecycleComponent

LifecycleComponent.LifecycleAutomaton, LifecycleComponent.UncheckedLifecycleComponent

Nested classes/interfaces inherited from interface LinkComponent

LinkComponent.LinkAutomaton, LinkComponent.LinkComponentBuilder<B>

Nested classes/interfaces inherited from interface Openable

Openable.OpenAutomaton, Openable.OpenBuilder<B>

Nested classes/interfaces inherited from interface Pausable

Pausable.PauseAutomaton, Pausable.PauseBuilder<B>, Pausable.UncheckedPausable

Nested classes/interfaces inherited from interface Resumable

Resumable.ResumeAutomaton, Resumable.ResumeBuilder<B>, Resumable.UncheckedResumable

Nested classes/interfaces inherited from interface Startable

Startable.StartAutomaton, Startable.StartBuilder<B>, Startable.UncheckedStartable

Nested classes/interfaces inherited from interface Stoppable

Stoppable.StopAutomaton, Stoppable.StopBuilder<B>, Stoppable.UncheckedStoppable

Constructor Summary

Constructors

Constructor	Description
QueryLoggerDispatcher(ExecutionStrategy aComponentExecutionStrategy, QueryLogger<T>... aLoggers)	Similar to the QueryLoggerDispatcher(QueryLogger...) with the additional option of determining the execution strategy of the state change request calls for the encapsulated QueryLogger instances (as of ComponentComposite).
QueryLoggerDispatcher(QueryLogger<T>... aLoggers)	Instantiates a new QueryLoggerDispatcher composed of the provided QueryLogger instances.

Method Summary

Modifier and Type	Method	Description
void	close()
void	decompose()
void	destroy()
void	dispose()
Records<T>	findLogs()	Retrieves all available Record instances being logged.
Records<T>	findLogs(int aLimit)	Retrieves all available Record instances being logged matching the given criteria and restrictions.
Records<T>	findLogs(Criteria aCriteria)	Retrieves all available Record instances being logged matching the given criteria and restrictions.
Records<T>	findLogs(Criteria aCriteria, int aLimit)	Retrieves all available Record instances being logged matching the given criteria and restrictions.
Records<T>	findLogs(Criteria aCriteria, Header<T> aHeader)	Retrieves all available Record instances being logged matching the given criteria and restrictions.
Records<T>	findLogs(Criteria aCriteria, Header<T> aHeader, int aLimit)	Retrieves all available Record instances being logged matching the given criteria and restrictions.
Records<T>	findLogs(Header<T> aHeader, int aLimit)	Retrieves all available Record instances being logged matching the given criteria and restrictions.
void	flush()
protected Collection<QueryLogger<T>>	getLoggers()	Gets the loggers.
void	initialize()
void	log(Record<? extends T> aRecord)	Logs a Record.
void	open()
void	pause()
void	reset()
void	resume()
void	start()
void	stop()

Methods inherited from class Object

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

Methods inherited from interface Closable

closeIn, closeQuietly, closeUnchecked

Methods inherited from interface Flushable

flushUnchecked, isFlushable

Methods inherited from interface Initializable

initializeUnchecked

Methods inherited from interface LogDecorator

printHead, printSeparator, printTail

Methods inherited from interface Logger

log

Methods inherited from interface Openable

openUnchecked

Methods inherited from interface Pausable

pauseUnchecked

Methods inherited from interface Resumable

resumeUnchecked

Methods inherited from interface Startable

startUnchecked

Methods inherited from interface Stoppable

stopUnchecked

Constructor Details

QueryLoggerDispatcher

@SafeVarargs
public QueryLoggerDispatcher(QueryLogger<T>... aLoggers)

Instantiates a new QueryLoggerDispatcher composed of the provided QueryLogger instances.

Parameters:

aLoggers - the Logger instances populating this composite.

See Also:

• AbstractQueryLoggerDispatcher(QueryLogger...)

QueryLoggerDispatcher

@SafeVarargs
public QueryLoggerDispatcher(ExecutionStrategy aComponentExecutionStrategy,
 QueryLogger<T>... aLoggers)

Similar to the QueryLoggerDispatcher(QueryLogger...) with the additional option of determining the execution strategy of the state change request calls for the encapsulated QueryLogger instances (as of ComponentComposite).

Parameters:

aComponentExecutionStrategy - The strategy to be used when invoking a component's (encapsulated QueryLogger instance's) state change request call (as of ComponentComposite).

aLoggers - the QueryLogger instances populating this composite.

Method Details

initialize

public void initialize()
                throws InitializeException

Specified by:

initialize in interface Initializable

Throws:

InitializeException

start

public void start()
           throws StartException

Specified by:

start in interface Startable

Throws:

StartException

pause

public void pause()
           throws PauseException

Specified by:

pause in interface Pausable

Throws:

PauseException

resume

public void resume()
            throws ResumeException

Specified by:

resume in interface Resumable

Throws:

ResumeException

stop

public void stop()
          throws StopException

Specified by:

stop in interface Stoppable

Throws:

StopException

decompose

public void decompose()

Specified by:

decompose in interface Decomposable

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Specified by:

flush in interface Flushable

Throws:

IOException

destroy

public void destroy()

Specified by:

destroy in interface Destroyable

reset

public void reset()

Specified by:

reset in interface Resetable

open

public void open()
          throws IOException

Specified by:

open in interface Openable

Throws:

IOException

close

public void close()

Specified by:

close in interface Closable

dispose

public void dispose()

Specified by:

dispose in interface Disposable

findLogs

public Records<T> findLogs()

Retrieves all available Record instances being logged.

Specified by:

findLogs in interface QueryLogger<L extends QueryLogger<T>>

Returns:

A Records instance containing all available Record instances being logged.

findLogs

public Records<T> findLogs(int aLimit)

Retrieves all available Record instances being logged matching the given criteria and restrictions.

Specified by:

findLogs in interface QueryLogger<L extends QueryLogger<T>>

Parameters:

aLimit - The maximum Record instances contained in the returned Records instance; there may be more Record instances which are not contained in the Records instance in case the Records instance's size is that of the specified limit.

Returns:

A Records instance containing all available Record instances being logged matching the given criteria and restrictions.

findLogs

public Records<T> findLogs(Criteria aCriteria)

Retrieves all available Record instances being logged matching the given criteria and restrictions.

Specified by:

findLogs in interface QueryLogger<L extends QueryLogger<T>>

Parameters:

aCriteria - The Criteria to be applied to the Record instances

Returns:

A Records instance containing all available Record instances being logged matching the given criteria and restrictions.

findLogs

public Records<T> findLogs(Header<T> aHeader,
 int aLimit)

Retrieves all available Record instances being logged matching the given criteria and restrictions.

Specified by:

findLogs in interface QueryLogger<L extends QueryLogger<T>>

Parameters:

aHeader - The Header used to restrict the "columns" (key/value entries) in the retrieved Record instances (provided by the Records instance).

aLimit - The maximum Record instances contained in the returned Records instance; there may be more Record instances which are not contained in the Records instance in case the Records instance's size is that of the specified limit.

Returns:

A Records instance containing all available Record instances being logged matching the given criteria and restrictions.

findLogs

public Records<T> findLogs(Criteria aCriteria,
 int aLimit)
                    throws BadCriteriaException

Retrieves all available Record instances being logged matching the given criteria and restrictions.

Specified by:

findLogs in interface QueryLogger<L extends QueryLogger<T>>

Parameters:

aCriteria - The Criteria to be applied to the Record instances

aLimit - The maximum Record instances contained in the returned Records instance; there may be more Record instances which are not contained in the Records instance in case the Records instance's size is that of the specified limit.

Returns:

A Records instance containing all available Record instances being logged matching the given criteria and restrictions.

Throws:

BadCriteriaException - thrown in case of problems related to some Criteria.

findLogs

public Records<T> findLogs(Criteria aCriteria,
 Header<T> aHeader)
                    throws BadCriteriaException

Retrieves all available Record instances being logged matching the given criteria and restrictions.

Specified by:

findLogs in interface QueryLogger<L extends QueryLogger<T>>

Parameters:

aCriteria - The Criteria to be applied to the Record instances

aHeader - The Header used to restrict the "columns" (key/value entries) in the retrieved Record instances (provided by the Records instance).

Returns:

A Records instance containing all available Record instances being logged matching the given criteria and restrictions.

Throws:

BadCriteriaException - thrown in case of problems related to some Criteria.

findLogs

public Records<T> findLogs(Criteria aCriteria,
 Header<T> aHeader,
 int aLimit)
                    throws BadCriteriaException

Retrieves all available Record instances being logged matching the given criteria and restrictions.

Specified by:

findLogs in interface QueryLogger<L extends QueryLogger<T>>

Parameters:

aCriteria - The Criteria to be applied to the Record instances

aHeader - The Header used to restrict the "columns" (key/value entries) in the retrieved Record instances (provided by the Records instance).

aLimit - The maximum Record instances contained in the returned Records instance; there may be more Record instances which are not contained in the Records instance in case the Records instance's size is that of the specified limit.

Returns:

A Records instance containing all available Record instances being logged matching the given criteria and restrictions.

Throws:

BadCriteriaException - thrown in case of problems related to some Criteria.

log

public void log(Record<? extends T> aRecord)

Logs a Record. The targeted data sink for the Record instances (where them are physically stored) depends on the implementation of the Logger. It can be a console, a file, a stream or a database.

Specified by:

log in interface Logger<L extends Logger<T>>

Parameters:

aRecord - The Record to be logged.

getLoggers

protected Collection<QueryLogger<T>> getLoggers()

Gets the loggers.

Returns:

the loggers