com.kdgregory.logging.aws.facade

Interface SNSFacade

public interface SNSFacade

Exposes the CloudWatch Logs APIs used by SNShLogWriter.

Instances are created by FacadeFactory, and are tied to a single writer's configuration.

All operations may throw SNSFacadeException. Callers are expected to catch this exception (it's checked), and take action based on the reason code that it exposes.

Method Summary

Modifier and Type	Method and Description
String	createTopic() Attempts to create a topic with the configured name.
String	lookupTopic() Attempts to match the configured topic ARN or name to an existing SNS topic in the configured account and region.
void	publish(LogMessage message) Attempts to publish the provided message, using configured topic and subject.
void	shutdown() Shuts down the underlying client.

Method Detail

lookupTopic

String lookupTopic()

Attempts to match the configured topic ARN or name to an existing SNS topic in the configured account and region. Returns the topic ARN if found, null if not found. Throws if unable to retrieve topic information for any reason, including throttling.

createTopic

String createTopic()

Attempts to create a topic with the configured name. Returns the topic's ARN if successful, throws on any failure.

Note: SNS silently succeeds if the topic already exists.

publish

void publish(LogMessage message)

Attempts to publish the provided message, using configured topic and subject.

Throws if unable, including throttling.

shutdown

void shutdown()

Shuts down the underlying client.