com.kdgregory.logging.aws.sns

Class SNSLogWriter

java.lang.Object

com.kdgregory.logging.aws.internal.AbstractLogWriter<SNSWriterConfig,SNSWriterStatistics>

com.kdgregory.logging.aws.sns.SNSLogWriter

All Implemented Interfaces:

LogWriter, Runnable

public class SNSLogWriter
extends AbstractLogWriter<SNSWriterConfig,SNSWriterStatistics>

Writes log messages to an SNS topic. Optionally creates the topic at startup, but will fail if the topic is deleted during operation.

Field Summary

Fields

Modifier and Type	Field and Description
protected RetryManager2	createRetry
protected RetryManager2	describeRetry
protected Duration	describeTimeout

Fields inherited from class com.kdgregory.logging.aws.internal.AbstractLogWriter

config, logger, stats

Constructor Summary

Constructors

Constructor and Description
SNSLogWriter(SNSWriterConfig config, SNSWriterStatistics stats, InternalLogger logger, SNSFacade facade)

Method Summary

Modifier and Type	Method and Description
protected int	effectiveSize(LogMessage message) Calculates the effective size of the message.
protected boolean	ensureDestinationAvailable() Verifies that the logging destination is available (which may involve creating it).
int	maxMessageSize() Returns the maximum allowed UTF-8 message size for the destination.
protected List<LogMessage>	sendBatch(List<LogMessage> currentBatch) Sends a batch of messages.
protected void	stopAWSClient() This is called when the logwriter is stopped, to explicitly close the AWS service client.
protected boolean	withinServiceLimits(int batchBytes, int numMessages) Determines whether the provided batch size or number of messages would exceed the service's limits.

Methods inherited from class com.kdgregory.logging.aws.internal.AbstractLogWriter

addMessage, buildBatch, getBatchCount, getBatchDelay, initialize, isRunning, isSynchronous, keepRunning, processBatch, reportError, run, setBatchDelay, setDiscardAction, setDiscardThreshold, stop, waitUntilInitialized, waitUntilStopped

Methods inherited from class java.lang.Object

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

Field Detail

describeTimeout

protected Duration describeTimeout

describeRetry

protected RetryManager2 describeRetry

createRetry

protected RetryManager2 createRetry

Constructor Detail

SNSLogWriter

public SNSLogWriter(SNSWriterConfig config,
                    SNSWriterStatistics stats,
                    InternalLogger logger,
                    SNSFacade facade)

Method Detail

maxMessageSize

public int maxMessageSize()

Description copied from interface: LogWriter

Returns the maximum allowed UTF-8 message size for the destination.

ensureDestinationAvailable

protected boolean ensureDestinationAvailable()

Description copied from class: AbstractLogWriter

Verifies that the logging destination is available (which may involve creating it). Return true if successful, false if not (which will cause the appender to stop running).

Specified by:

ensureDestinationAvailable in class AbstractLogWriter<SNSWriterConfig,SNSWriterStatistics>

sendBatch

protected List<LogMessage> sendBatch(List<LogMessage> currentBatch)

Description copied from class: AbstractLogWriter

Sends a batch of messages. The subclass is responsible for returning any messages that weren't sent, in order, so that they can be requeued.

Specified by:

sendBatch in class AbstractLogWriter<SNSWriterConfig,SNSWriterStatistics>

effectiveSize

protected int effectiveSize(LogMessage message)

Description copied from class: AbstractLogWriter

Calculates the effective size of the message. This includes the message bytes plus any overhead. It is used to calculate the number of bytes the message will add to a batch.

Specified by:

effectiveSize in class AbstractLogWriter<SNSWriterConfig,SNSWriterStatistics>

withinServiceLimits

protected boolean withinServiceLimits(int batchBytes,
                                      int numMessages)

Description copied from class: AbstractLogWriter

Determines whether the provided batch size or number of messages would exceed the service's limits.

Specified by:

withinServiceLimits in class AbstractLogWriter<SNSWriterConfig,SNSWriterStatistics>

stopAWSClient

protected void stopAWSClient()

Description copied from class: AbstractLogWriter

This is called when the logwriter is stopped, to explicitly close the AWS service client. It must be implemented by the subclass because we don't know the actual type and there's no abstract super-interface.

Specified by:

stopAWSClient in class AbstractLogWriter<SNSWriterConfig,SNSWriterStatistics>