io.monalabs.client

Class MonaClient

java.lang.Object

io.monalabs.client.MonaClient

All Implemented Interfaces:

Closeable, AutoCloseable

public class MonaClient
extends Object
implements Closeable

The default implementation for a Mona java client.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MonaClient.Builder

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MonaClient(org.komamitsu.fluency.Fluency fluency, String monaUserId)

Method Summary

Modifier and Type	Method and Description
void	close() Closes the inner connection socket to Mona's fluentd.
void	exportStandalone(String arcClass, org.json.JSONArray jsonArray) Export variant for using with a JSONArray.
void	exportStandalone(String arcClass, org.json.JSONObject jsonObject) Export variant for using with a JSONObject.
void	exportStandalone(String arcClass, List<Map<String,Object>> messages) Use this exportStandalone variant to send a batch (list) of unrelated messages to Mona.
void	exportStandalone(String arcClass, Map<String,Object> message) Shorthand for the above exportStandalone variant, leaving the contextId empty.
void	exportStandalone(String arcClass, String jsonString) Use this exportStandalone variant if the input is an actual json string.
void	exportStandalone(String arcClass, String contextId, org.json.JSONArray jsonArray) Same as above, allowing a contextId to be set as well.
void	exportStandalone(String arcClass, String contextId, org.json.JSONObject jsonObject) Same as above, allowing setting a contextId as well
void	exportStandalone(String arcClass, String contextId, List<Map<String,Object>> messages) Same as above, supporting setting contextId.
void	exportStandalone(String arcClass, String contextId, Map<String,Object> message) The main exporting mechanism.
void	exportStandalone(String arcClass, String contextId, String jsonString) Same as above, only allowing a contextId to be set as well.
long	getCurrentUnsentDataSize()

Methods inherited from class java.lang.Object

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

Constructor Detail

MonaClient

protected MonaClient(org.komamitsu.fluency.Fluency fluency,
                     String monaUserId)

Method Detail

close

public void close()

Closes the inner connection socket to Mona's fluentd.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

getCurrentUnsentDataSize

public long getCurrentUnsentDataSize()

exportStandalone

public void exportStandalone(String arcClass,
                             String contextId,
                             Map<String,Object> message)

The main exporting mechanism. Use this method, or any of its variants, to send context-free messages to Mona's system.

Parameters:

arcClass - A tag for the ARC class that will be sent using this exportStandalone method. Mona uses ARC classes to know which arcs belong together and should be compared. See Readme for explanation about ARCs. This string can have dots, which allows the use of sub-ARC-classes.

contextId - The ID to use for this context. Can be empty or null, in which case the client will create a random UUID as the context id. When using sub-ARCs (i.e., when the given arcClass param has dots in it), the context id may also contain dots (at most the amount of dots in the arcClass param), to infer the context ids for each sub-ARC.

message - A json-like object consisting of the actual message to send to Mona.

exportStandalone

public void exportStandalone(String arcClass,
                             Map<String,Object> message)

Shorthand for the above exportStandalone variant, leaving the contextId empty.

exportStandalone

public void exportStandalone(String arcClass,
                             List<Map<String,Object>> messages)

Use this exportStandalone variant to send a batch (list) of unrelated messages to Mona. Each message in the list will receive its own random context.

Parameters:

messages - a list of json-like messages to send to Mona

exportStandalone

public void exportStandalone(String arcClass,
                             String contextId,
                             List<Map<String,Object>> messages)

Same as above, supporting setting contextId.

exportStandalone

public void exportStandalone(String arcClass,
                             String jsonString)

Use this exportStandalone variant if the input is an actual json string. If the input string is a json object, this object will be considered as one ARC. If it's a json array, each object in the array will be considered one arc (unless one of the objects is an array itself, in that case, the logic is recursive).

Parameters:

jsonString - A valid json string (either object or array)

exportStandalone

public void exportStandalone(String arcClass,
                             String contextId,
                             String jsonString)

Same as above, only allowing a contextId to be set as well.

exportStandalone

public void exportStandalone(String arcClass,
                             org.json.JSONObject jsonObject)

Export variant for using with a JSONObject.

Parameters:

jsonObject -

exportStandalone

public void exportStandalone(String arcClass,
                             String contextId,
                             org.json.JSONObject jsonObject)

Same as above, allowing setting a contextId as well

exportStandalone

public void exportStandalone(String arcClass,
                             org.json.JSONArray jsonArray)

Export variant for using with a JSONArray.

Parameters:

jsonArray -

exportStandalone

public void exportStandalone(String arcClass,
                             String contextId,
                             org.json.JSONArray jsonArray)

Same as above, allowing a contextId to be set as well.