org.refcodes.logger.alt.simpledb.impls

Class SimpleDbLoggerImpl<T>

java.lang.Object

org.refcodes.logger.alt.simpledb.impls.SimpleDbLoggerImpl<T>

Type Parameters:

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

All Implemented Interfaces:

Flushable, org.refcodes.component.Component, org.refcodes.component.Decomposeable, org.refcodes.component.Destroyable, org.refcodes.component.Initializable, org.refcodes.logger.Logger<T>

Direct Known Subclasses:

SimpleDbQueryLoggerImpl

public class SimpleDbLoggerImpl<T>
extends Object
implements org.refcodes.logger.Logger<T>, org.refcodes.component.Component, org.refcodes.component.Initializable, org.refcodes.component.Decomposeable, org.refcodes.component.Flushable

The SimpleDbLoggerImpl is the Amazon SimpleDB implementation of the Logger interface. As Amazon SimpleDB stores only String values (everything is a String), type information may be lost as inferencing from the String content may not be possible. The Record instances Column.toStorageString(Object) and Column.fromStorageString(String) methods are used to apply conversion.

ATTENTION: Logging field values exceeding the size of 1024 characters will be truncated and an error message is logged out. We assume not having fields longer than 1024 bytes with this implementation of the Logger.

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.component.Destroyable

org.refcodes.component.Destroyable.DestroyAutomaton

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.Decomposeable

org.refcodes.component.Decomposeable.DecomposeAutomaton

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.refcodes.logger.RuntimeLogger	LOGGER

Constructor Summary

Constructors

Constructor and Description
SimpleDbLoggerImpl(String aDomainName, String aAccessKey, String aSecretKey, org.refcodes.tabular.ColumnFactory<T> aColumnFactory) Constructs the SimpleDbLoggerImpl for a given SimpleDB domain.
SimpleDbLoggerImpl(String aDomainName, String aAccessKey, String aSecretKey, String aEndPoint, org.refcodes.tabular.ColumnFactory<T> aColumnFactory) Constructs the SimpleDbLoggerImpl for a given SimpleDB domain.

Method Summary

Modifier and Type	Method and Description
protected void	addHeaderColumn(String eKey) Adds a key to the dynamically created Header for reducing object creation overhead when massively logging data as no Column instances are created once the key was already added.
protected static void	clearDomain(com.amazonaws.services.simpledb.AmazonSimpleDBClient aAmazonSimpleDbClient, String aDomainName) Clears all content from the given Amazon SimpleDB domain.
void	decompose() Tears down this component, also removes external resources. ------------------------------------------------------------------------- ATTENTION: This method will also tear down the Amazon SimpleDB domain!
void	destroy()
void	flush() Flushes buffered log lines, when shutting down this component via the destroy() method, the buffer then is flushed automatically!
protected void	flushBuffer() Flushes the buffer with Records already encapsulated in Amazon SimpleDB's items.
protected com.amazonaws.services.simpledb.AmazonSimpleDBClient	getAmazonSimpleDbClient() Retrieves the amazon SimpleDB client to be used.
protected static com.amazonaws.services.simpledb.AmazonSimpleDBClient	getAmazonSimpleDbClient(File aConfigFile) Retrieves an AmazonSimpleDBClient from a configuration file containing the access- and the secret key.
protected String	getAmazonSimpleDbDomainName() Retrieves the domain name to be used.
protected static List<String>	getDomainNames(com.amazonaws.services.simpledb.AmazonSimpleDBClient aAmazonSimpleDbClient) Retrieves a list of domain names retrievable from the given AmazonSimpleDBClient.
protected org.refcodes.tabular.Header<T>	getHeader() Provides access to the Header member variable required for Record related operation.
protected static boolean	hasDomain(com.amazonaws.services.simpledb.AmazonSimpleDBClient aAmazonSimpleDbClient, String aDomainName) Tests whether the given domain exists in Amazon SimpleDB.
void	initialize()
protected static boolean	isRequestTimeoutException(Exception aException)
protected static boolean	isServiceUnavailableException(Exception aException)
void	log(org.refcodes.tabular.Record<? extends T> aRecord)
protected void	setAmazonSimpleDbDomainName(String aAmazonSimpleDbDomainName) Sets the domain name to be used.
protected static String	toMessage(Throwable aThrowable) Creates an Amazon AWS specific exception message from the given throwable containing additional information such as the AWS error code, the AWS error type, the request ID, the service name and the status code.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

protected static org.refcodes.logger.RuntimeLogger LOGGER

Constructor Detail

SimpleDbLoggerImpl

public SimpleDbLoggerImpl(String aDomainName,
                          String aAccessKey,
                          String aSecretKey,
                          org.refcodes.tabular.ColumnFactory<T> aColumnFactory)

Constructs the SimpleDbLoggerImpl for a given SimpleDB domain.

Parameters:

aDomainName - The name for the Amazon SimpleDB domain

aAccessKey - The Amazon access key for Amazon SimpleDB

aSecretKey - The Amazon secret key for Amazon SimpleDB

aColumnFactory - The ColumnFactory to create default Column instances for Record instances to be processed

Throws:

UnknownDomainAliasException - in case the campaigning domain alias cannot be resolved.

SimpleDbLoggerImpl

public SimpleDbLoggerImpl(String aDomainName,
                          String aAccessKey,
                          String aSecretKey,
                          String aEndPoint,
                          org.refcodes.tabular.ColumnFactory<T> aColumnFactory)

Constructs the SimpleDbLoggerImpl for a given SimpleDB domain.

Parameters:

aDomainName - The name for the Amazon SimpleDB domain

aAccessKey - The Amazon access key for Amazon SimpleDB

aSecretKey - The Amazon secret key for Amazon SimpleDB

aEndPoint - The end-point (Amazon region) to use (see AbstractSimpleDbClient's constructor documentation for possible values).

aColumnFactory - The ColumnFactory to create default Column instances for Record instances to be processed

Method Detail

log

public void log(org.refcodes.tabular.Record<? extends T> aRecord)
         throws org.refcodes.logger.IllegalRecordRuntimeException,
                org.refcodes.logger.UnexpectedLogRuntimeException

Specified by:

log in interface org.refcodes.logger.Logger<T>

Throws:

org.refcodes.logger.IllegalRecordRuntimeException

org.refcodes.logger.UnexpectedLogRuntimeException

initialize

public void initialize()
                throws org.refcodes.component.InitializeException

Specified by:

initialize in interface org.refcodes.component.Initializable

Throws:

org.refcodes.component.InitializeException

destroy

public void destroy()

Specified by:

destroy in interface org.refcodes.component.Destroyable

decompose

public void decompose()

Tears down this component, also removes external resources. ------------------------------------------------------------------------- ATTENTION: This method will also tear down the Amazon SimpleDB domain! -------------------------------------------------------------------------

Specified by:

decompose in interface org.refcodes.component.Decomposeable

flush

public void flush()
           throws org.refcodes.component.OpenException

Flushes buffered log lines, when shutting down this component via the destroy() method, the buffer then is flushed automatically! Especially useful when unit testing the SimpleDbLoggerImpl, then flushing can be forced by the test case.

Specified by:

flush in interface Flushable

Throws:

org.refcodes.component.OpenException

getHeader

protected org.refcodes.tabular.Header<T> getHeader()

Provides access to the Header member variable required for Record related operation.

Returns:

The Header.

addHeaderColumn

protected void addHeaderColumn(String eKey)

Adds a key to the dynamically created Header for reducing object creation overhead when massively logging data as no Column instances are created once the key was already added.

Parameters:

eKey - The key for which a Column is to be added.

flushBuffer

protected void flushBuffer()

Flushes the buffer with Records already encapsulated in Amazon SimpleDB's items.

getAmazonSimpleDbDomainName

protected String getAmazonSimpleDbDomainName()

Retrieves the domain name to be used.

Returns:

The domain name.

setAmazonSimpleDbDomainName

protected void setAmazonSimpleDbDomainName(String aAmazonSimpleDbDomainName)

Sets the domain name to be used.

Parameters:

The - domain name to be used.

getAmazonSimpleDbClient

protected com.amazonaws.services.simpledb.AmazonSimpleDBClient getAmazonSimpleDbClient()

Retrieves the amazon SimpleDB client to be used.

Returns:

The SimpleDB client to be used.

isRequestTimeoutException

protected static boolean isRequestTimeoutException(Exception aException)

isServiceUnavailableException

protected static boolean isServiceUnavailableException(Exception aException)

toMessage

protected static String toMessage(Throwable aThrowable)

Creates an Amazon AWS specific exception message from the given throwable containing additional information such as the AWS error code, the AWS error type, the request ID, the service name and the status code.

Parameters:

aThrowable - The throwable from which to generate the Amazon AWS specific exception message.

Returns:

The according exception message.

clearDomain

protected static void clearDomain(com.amazonaws.services.simpledb.AmazonSimpleDBClient aAmazonSimpleDbClient,
                                  String aDomainName)

Clears all content from the given Amazon SimpleDB domain.

Parameters:

aAmazonSimpleDbClient - The AmazonSimpleDBClient.

aDomainName - The domain name of the domain to be cleared.

getAmazonSimpleDbClient

protected static com.amazonaws.services.simpledb.AmazonSimpleDBClient getAmazonSimpleDbClient(File aConfigFile)
                                                                                       throws IOException

Retrieves an AmazonSimpleDBClient from a configuration file containing the access- and the secret key.

Parameters:

aConfigFile - The configuration file used to configure the AmazonSimpleDBClient.

Returns:

An AmazonSimpleDBClient.

Throws:

IOException - In case there were problems reading the configuration file.

getDomainNames

protected static List<String> getDomainNames(com.amazonaws.services.simpledb.AmazonSimpleDBClient aAmazonSimpleDbClient)

Retrieves a list of domain names retrievable from the given AmazonSimpleDBClient.

Parameters:

aAmazonSimpleDbClient - The AmazonSimpleDBClient.

Returns:

A list containing String instances representing the retrievable domain names.

hasDomain

protected static boolean hasDomain(com.amazonaws.services.simpledb.AmazonSimpleDBClient aAmazonSimpleDbClient,
                                   String aDomainName)

Tests whether the given domain exists in Amazon SimpleDB.

Parameters:

aAmazonSimpleDbClient - The AmazonSimpleDBClient.

aDomainName - The domain name to be tested.

Returns:

True in case the domain with the given name exists, else false.