java.lang.Object
org.refcodes.logger.QueryLoggerComposite<T>
- Type Parameters:
T
- The type of theRecord
instances managed by theLogger
.
- All Implemented Interfaces:
Flushable
,org.refcodes.component.Closable
,org.refcodes.component.ComponentComposite
,org.refcodes.component.Decomposable
,org.refcodes.component.Destroyable
,org.refcodes.component.Flushable
,org.refcodes.component.Initializable
,org.refcodes.component.LifecycleComponent
,org.refcodes.component.LinkComponent
,org.refcodes.component.Openable
,org.refcodes.component.Pausable
,org.refcodes.component.Resumable
,org.refcodes.component.Startable
,org.refcodes.component.Stoppable
,LogDecorator
,Logger<T>
,QueryLogger<T>
,org.refcodes.mixin.Disposable
,org.refcodes.mixin.Resetable
public class QueryLoggerComposite<T>
extends Object
implements org.refcodes.component.ComponentComposite
The
QueryLoggerComposite
is a ready to use implementation of a
composite QueryLogger
extending the
AbstractQueryLoggerComposite
.- See Also:
-
AbstractQueryLoggerComposite
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.refcodes.component.Closable
org.refcodes.component.Closable.CloseAutomaton, org.refcodes.component.Closable.CloseBuilder<B extends org.refcodes.component.Closable.CloseBuilder<B>>
Nested classes/interfaces inherited from interface org.refcodes.component.ComponentComposite
org.refcodes.component.ComponentComposite.ExtendedComponentComposite<CTX extends Object,
CON extends Object> Nested classes/interfaces inherited from interface org.refcodes.component.Decomposable
org.refcodes.component.Decomposable.DecomposeAutomaton
Nested classes/interfaces inherited from interface org.refcodes.component.Destroyable
org.refcodes.component.Destroyable.DestroyAutomaton
Nested classes/interfaces inherited from interface org.refcodes.component.Flushable
org.refcodes.component.Flushable.FlushBuilder<B extends org.refcodes.component.Flushable.FlushBuilder<B>>
Nested classes/interfaces inherited from interface org.refcodes.component.Initializable
org.refcodes.component.Initializable.InitializeAutomaton, org.refcodes.component.Initializable.InitializeBuilder<B extends org.refcodes.component.Initializable.InitializeBuilder<B>>, org.refcodes.component.Initializable.UncheckedInitializable
Nested classes/interfaces inherited from interface org.refcodes.component.LifecycleComponent
org.refcodes.component.LifecycleComponent.LifecycleAutomaton, org.refcodes.component.LifecycleComponent.UncheckedLifecycleComponent
Nested classes/interfaces inherited from interface org.refcodes.component.LinkComponent
org.refcodes.component.LinkComponent.LinkAutomaton, org.refcodes.component.LinkComponent.LinkComponentBuilder<B extends org.refcodes.component.LinkComponent.LinkComponentBuilder<B>>
Nested classes/interfaces inherited from interface org.refcodes.component.Openable
org.refcodes.component.Openable.OpenAutomaton, org.refcodes.component.Openable.OpenBuilder<B extends org.refcodes.component.Openable.OpenBuilder<B>>
Nested classes/interfaces inherited from interface org.refcodes.component.Pausable
org.refcodes.component.Pausable.PauseAutomaton, org.refcodes.component.Pausable.PauseBuilder<B extends org.refcodes.component.Pausable.PauseBuilder<B>>, org.refcodes.component.Pausable.UncheckedPausable
Nested classes/interfaces inherited from interface org.refcodes.component.Resumable
org.refcodes.component.Resumable.ResumeAutomaton, org.refcodes.component.Resumable.ResumeBuilder<B extends org.refcodes.component.Resumable.ResumeBuilder<B>>, org.refcodes.component.Resumable.UncheckedResumable
Nested classes/interfaces inherited from interface org.refcodes.component.Startable
org.refcodes.component.Startable.StartAutomaton, org.refcodes.component.Startable.StartBuilder<B extends org.refcodes.component.Startable.StartBuilder<B>>, org.refcodes.component.Startable.UncheckedStartable
Nested classes/interfaces inherited from interface org.refcodes.component.Stoppable
org.refcodes.component.Stoppable.StopAutomaton, org.refcodes.component.Stoppable.StopBuilder<B extends org.refcodes.component.Stoppable.StopBuilder<B>>, org.refcodes.component.Stoppable.UncheckedStoppable
-
Constructor Summary
ConstructorDescriptionQueryLoggerComposite
(org.refcodes.controlflow.ExecutionStrategy aComponentExecutionStrategy, QueryLogger<T>... aLoggers) Similar to theQueryLoggerComposite(QueryLogger...)
with the additional option of determining the execution strategy of the state change request calls for the encapsulatedQueryLogger
instances (as ofComponentComposite
).QueryLoggerComposite
(QueryLogger<T>... aLoggers) Instantiates a newQueryLoggerComposite
composed of the providedQueryLogger
instances. -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
void
void
destroy()
void
dispose()
org.refcodes.tabular.Records<T>
findLogs()
Retrieves all availableRecord
instances being logged.org.refcodes.tabular.Records<T>
findLogs
(int aLimit) Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.org.refcodes.tabular.Records<T>
findLogs
(org.refcodes.criteria.Criteria aCriteria) Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.org.refcodes.tabular.Records<T>
findLogs
(org.refcodes.criteria.Criteria aCriteria, int aLimit) Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.org.refcodes.tabular.Records<T>
Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.org.refcodes.tabular.Records<T>
findLogs
(org.refcodes.criteria.Criteria aCriteria, org.refcodes.tabular.Header<T> aHeader, int aLimit) Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.org.refcodes.tabular.Records<T>
Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.void
flush()
protected Collection<QueryLogger<T>>
Gets the loggers.void
void
Logs aRecord
.void
open()
void
pause()
void
reset()
void
resume()
void
start()
void
stop()
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.refcodes.component.Closable
closeIn, closeQuietly, closeUnchecked
Methods inherited from interface org.refcodes.component.Flushable
flushUnchecked, isFlushable
Methods inherited from interface org.refcodes.component.Initializable
initializeUnchecked
Methods inherited from interface org.refcodes.logger.LogDecorator
printHead, printSeparator, printTail
Methods inherited from interface org.refcodes.component.Openable
openUnchecked
Methods inherited from interface org.refcodes.component.Pausable
pauseUnchecked
Methods inherited from interface org.refcodes.component.Resumable
resumeUnchecked
Methods inherited from interface org.refcodes.component.Startable
startUnchecked
Methods inherited from interface org.refcodes.component.Stoppable
stopUnchecked
-
Constructor Details
-
QueryLoggerComposite
Instantiates a newQueryLoggerComposite
composed of the providedQueryLogger
instances.- Parameters:
aLoggers
- theLogger
instances populating this composite.- See Also:
-
AbstractQueryLoggerComposite(QueryLogger...)
-
QueryLoggerComposite
@SafeVarargs public QueryLoggerComposite(org.refcodes.controlflow.ExecutionStrategy aComponentExecutionStrategy, QueryLogger<T>... aLoggers) Similar to theQueryLoggerComposite(QueryLogger...)
with the additional option of determining the execution strategy of the state change request calls for the encapsulatedQueryLogger
instances (as ofComponentComposite
).- Parameters:
aComponentExecutionStrategy
- The strategy to be used when invoking a component's (encapsulatedQueryLogger
instance's) state change request call (as ofComponentComposite
).aLoggers
- theQueryLogger
instances populating this composite.
-
-
Method Details
-
initialize
public void initialize() throws org.refcodes.component.InitializeException- Specified by:
initialize
in interfaceorg.refcodes.component.Initializable
- Throws:
org.refcodes.component.InitializeException
-
start
public void start() throws org.refcodes.component.StartException- Specified by:
start
in interfaceorg.refcodes.component.Startable
- Throws:
org.refcodes.component.StartException
-
pause
public void pause() throws org.refcodes.component.PauseException- Specified by:
pause
in interfaceorg.refcodes.component.Pausable
- Throws:
org.refcodes.component.PauseException
-
resume
public void resume() throws org.refcodes.component.ResumeException- Specified by:
resume
in interfaceorg.refcodes.component.Resumable
- Throws:
org.refcodes.component.ResumeException
-
stop
public void stop() throws org.refcodes.component.StopException- Specified by:
stop
in interfaceorg.refcodes.component.Stoppable
- Throws:
org.refcodes.component.StopException
-
decompose
public void decompose()- Specified by:
decompose
in interfaceorg.refcodes.component.Decomposable
-
flush
- Specified by:
flush
in interfaceFlushable
- Specified by:
flush
in interfaceorg.refcodes.component.Flushable
- Throws:
IOException
-
destroy
public void destroy()- Specified by:
destroy
in interfaceorg.refcodes.component.Destroyable
-
reset
public void reset()- Specified by:
reset
in interfaceorg.refcodes.mixin.Resetable
-
open
- Specified by:
open
in interfaceorg.refcodes.component.Openable
- Throws:
IOException
-
close
public void close()- Specified by:
close
in interfaceorg.refcodes.component.Closable
-
dispose
public void dispose()- Specified by:
dispose
in interfaceorg.refcodes.mixin.Disposable
-
findLogs
Retrieves all availableRecord
instances being logged.- Specified by:
findLogs
in interfaceQueryLogger<L extends QueryLogger<T>>
- Returns:
- A
Records
instance containing all availableRecord
instances being logged.
-
findLogs
Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.- Specified by:
findLogs
in interfaceQueryLogger<L extends QueryLogger<T>>
- Parameters:
aLimit
- The maximumRecord
instances contained in the returnedRecords
instance; there may be moreRecord
instances which are not contained in theRecords
instance in case theRecords
instance's size is that of the specified limit.- Returns:
- A
Records
instance containing all availableRecord
instances being logged matching the given criteria and restrictions.
-
findLogs
Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.- Specified by:
findLogs
in interfaceQueryLogger<L extends QueryLogger<T>>
- Parameters:
aCriteria
- TheCriteria
to be applied to theRecord
instances- Returns:
- A
Records
instance containing all availableRecord
instances being logged matching the given criteria and restrictions.
-
findLogs
Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.- Specified by:
findLogs
in interfaceQueryLogger<L extends QueryLogger<T>>
- Parameters:
aHeader
- TheHeader
used to restrict the "columns" (key/value entries) in the retrievedRecord
instances (provided by theRecords
instance).aLimit
- The maximumRecord
instances contained in the returnedRecords
instance; there may be moreRecord
instances which are not contained in theRecords
instance in case theRecords
instance's size is that of the specified limit.- Returns:
- A
Records
instance containing all availableRecord
instances being logged matching the given criteria and restrictions.
-
findLogs
public org.refcodes.tabular.Records<T> findLogs(org.refcodes.criteria.Criteria aCriteria, int aLimit) throws org.refcodes.criteria.CriteriaException.BadCriteriaException Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.- Specified by:
findLogs
in interfaceQueryLogger<L extends QueryLogger<T>>
- Parameters:
aCriteria
- TheCriteria
to be applied to theRecord
instancesaLimit
- The maximumRecord
instances contained in the returnedRecords
instance; there may be moreRecord
instances which are not contained in theRecords
instance in case theRecords
instance's size is that of the specified limit.- Returns:
- A
Records
instance containing all availableRecord
instances being logged matching the given criteria and restrictions. - Throws:
org.refcodes.criteria.CriteriaException.BadCriteriaException
- thrown in case of problems related to someCriteria
.
-
findLogs
public org.refcodes.tabular.Records<T> findLogs(org.refcodes.criteria.Criteria aCriteria, org.refcodes.tabular.Header<T> aHeader) throws org.refcodes.criteria.CriteriaException.BadCriteriaException Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.- Specified by:
findLogs
in interfaceQueryLogger<L extends QueryLogger<T>>
- Parameters:
aCriteria
- TheCriteria
to be applied to theRecord
instancesaHeader
- TheHeader
used to restrict the "columns" (key/value entries) in the retrievedRecord
instances (provided by theRecords
instance).- Returns:
- A
Records
instance containing all availableRecord
instances being logged matching the given criteria and restrictions. - Throws:
org.refcodes.criteria.CriteriaException.BadCriteriaException
- thrown in case of problems related to someCriteria
.
-
findLogs
public org.refcodes.tabular.Records<T> findLogs(org.refcodes.criteria.Criteria aCriteria, org.refcodes.tabular.Header<T> aHeader, int aLimit) throws org.refcodes.criteria.CriteriaException.BadCriteriaException Retrieves all availableRecord
instances being logged matching the given criteria and restrictions.- Specified by:
findLogs
in interfaceQueryLogger<L extends QueryLogger<T>>
- Parameters:
aCriteria
- TheCriteria
to be applied to theRecord
instancesaHeader
- TheHeader
used to restrict the "columns" (key/value entries) in the retrievedRecord
instances (provided by theRecords
instance).aLimit
- The maximumRecord
instances contained in the returnedRecords
instance; there may be moreRecord
instances which are not contained in theRecords
instance in case theRecords
instance's size is that of the specified limit.- Returns:
- A
Records
instance containing all availableRecord
instances being logged matching the given criteria and restrictions. - Throws:
org.refcodes.criteria.CriteriaException.BadCriteriaException
- thrown in case of problems related to someCriteria
.
-
log
public void log(org.refcodes.tabular.Record<? extends T> aRecord) throws IllegalRecordRuntimeException, UnexpectedLogRuntimeException Logs aRecord
. The targeted data sink for theRecord
instances (where them are physically stored) depends on the implementation of theLogger
. It can be a console, a file, a stream or a database.- Specified by:
log
in interfaceLogger<L extends Logger<T>>
- Parameters:
aRecord
- TheRecord
to be logged.- Throws:
IllegalRecordRuntimeException
- Thrown in case the record cannot be logged as a specific implementation might expect some dedicatedColumn
instances to be contained in the provided Record.UnexpectedLogRuntimeException
- Thrown in case some other problems regarding logging occurred, e.g. the data sink (physical system where to log to) experiences problems.
-
getLoggers
Gets the loggers.- Returns:
- the loggers
-