io.keen.client.java

Class RamEventStore

java.lang.Object

io.keen.client.java.RamEventStore

All Implemented Interfaces:

KeenAttemptCountingEventStore, KeenEventStore

public class RamEventStore
extends java.lang.Object
implements KeenAttemptCountingEventStore

Implementation of KeenEventStore which simply keeps a copy of each event in memory until it is explicitly removed.

NOTE: This implementation synchronizes all operations in order to ensure thread safety, but as a result it may perform poorly under high load. For applications that require high throughput, a custom KeenEventStore implementation is recommended.

Since:

2.0.0

Constructor Summary

Constructors

Constructor and Description
RamEventStore() Constructs a new RAM-based event store.

Method Summary

Modifier and Type	Method and Description
java.lang.String	get(java.lang.Object handle) Gets the event corresponding to the given handle.
java.lang.String	getAttempts(java.lang.String projectId, java.lang.String eventCollection) Gets the stored attempts String for a given project and collection.
java.util.Map<java.lang.String,java.util.List<java.lang.Object>>	getHandles(java.lang.String projectId) Retrieves a map from collection names to lists of handles currently stored under each collection.
void	remove(java.lang.Object handle) Removes the specified event from the store.
void	setAttempts(java.lang.String projectId, java.lang.String eventCollection, java.lang.String attemptsString) Set and stores the attempts String for a given project and collection.
void	setMaxEventsPerCollection(int maxEventsPerCollection) Sets the number of events that can be stored for a single collection before aging them out.
java.lang.Object	store(java.lang.String projectId, java.lang.String eventCollection, java.lang.String event) Stores the given event.

Methods inherited from class java.lang.Object

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

Constructor Detail

RamEventStore

public RamEventStore()

Constructs a new RAM-based event store.

Method Detail

store

public java.lang.Object store(java.lang.String projectId,
                              java.lang.String eventCollection,
                              java.lang.String event)
                       throws java.io.IOException

Stores the given event.

Specified by:

store in interface KeenEventStore

Parameters:

projectId - The ID of the project in which the event should be stored.

eventCollection - The name of the collection in which the event should be stored.

event - The serialized JSON for the event to store.

Returns:

A handle which can be used to retrieve or remove the event.

Throws:

java.io.IOException - If there is an error storing the event.

get

public java.lang.String get(java.lang.Object handle)
                     throws java.io.IOException

Gets the event corresponding to the given handle.

Specified by:

get in interface KeenEventStore

Parameters:

handle - A handle returned from a previous call to KeenEventStore.store(String, String, String) or KeenEventStore.getHandles(String).

Returns:

The serialized JSON for the event, or null if the handle is no longer present in the store.

Throws:

java.io.IOException - If there is an error retrieving the event.

remove

public void remove(java.lang.Object handle)
            throws java.io.IOException

Removes the specified event from the store.

Specified by:

remove in interface KeenEventStore

Parameters:

handle - A handle returned from a previous call to KeenEventStore.store(String, String, String) or KeenEventStore.getHandles(String).

Throws:

java.io.IOException - If there is an error removing the event.

getHandles

public java.util.Map<java.lang.String,java.util.List<java.lang.Object>> getHandles(java.lang.String projectId)
                                                                            throws java.io.IOException

Retrieves a map from collection names to lists of handles currently stored under each collection. This will be used by the KeenClient to retrieve the events to send in a batch to the Keen server, as well as to remove all successfully posted events after processing the response.

Specified by:

getHandles in interface KeenEventStore

Parameters:

projectId - The ID of the project for which to retrieve event handles.

Returns:

A map from collection names to lists of handles currently stored under each collection. If there are no events, an empty map will be returned.

Throws:

java.io.IOException - If there is an error retrieving the handles.

getAttempts

public java.lang.String getAttempts(java.lang.String projectId,
                                    java.lang.String eventCollection)

Gets the stored attempts String for a given project and collection.

Specified by:

getAttempts in interface KeenAttemptCountingEventStore

Parameters:

projectId - the project id

eventCollection - the collection name

Returns:

a String that was previously stored for this project and collection or null

setAttempts

public void setAttempts(java.lang.String projectId,
                        java.lang.String eventCollection,
                        java.lang.String attemptsString)

Set and stores the attempts String for a given project and collection.

Specified by:

setAttempts in interface KeenAttemptCountingEventStore

Parameters:

projectId - the project id

eventCollection - the collection name

attemptsString - the String to stored for this project and collection

setMaxEventsPerCollection

public void setMaxEventsPerCollection(int maxEventsPerCollection)

Sets the number of events that can be stored for a single collection before aging them out.

Parameters:

maxEventsPerCollection - The maximum number of events per collection.