com.eyro.mesosfer

Class MesosferLog

java.lang.Object

com.eyro.mesosfer.MesosferLog

public final class MesosferLog
extends java.lang.Object

The MesosferLog used to send analytic log based on beacon activity to the Mesosfer cloud.

Author:

Eyro Labs

Constructor Summary

Constructors

Constructor and Description
MesosferLog()

Method Summary

Modifier and Type	Method and Description
static MesosferLog	createLog() Constructs a new MesosferLog with no data in it.
void	sendAsync(SaveCallback callback) Saves this object to the server at some unspecified time in the future, even if Mesosfer is currently inaccessible.
MesosferLog	setBeacon(MesosferLog beacon) Sets beacon for log.
MesosferLog	setEvent(MesosferBeacon.Event event) Sets event for logging.
MesosferLog	setInterval(long interval) Sets interval between onEnter and onExit state.
MesosferLog	setModule(MesosferBeacon.Module type) Sets module for logging.

Methods inherited from class java.lang.Object

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

Constructor Detail

MesosferLog

public MesosferLog()

Method Detail

createLog

public static MesosferLog createLog()

Constructs a new MesosferLog with no data in it. A MesosferLog constructed in this way will not have an objectId and will not persist to the database until sendAsync(SaveCallback) is called.

Returns:

A new instance of MesosferLog

setBeacon

public MesosferLog setBeacon(MesosferLog beacon)

Sets beacon for log.

Parameters:

beacon - the MesosferBeacon object.

Returns:

the current instance for chaining method use.

setInterval

public MesosferLog setInterval(long interval)

Sets interval between onEnter and onExit state.

Parameters:

interval - the interval in milliseconds.

Returns:

the current instance for chaining method use.

setModule

public MesosferLog setModule(MesosferBeacon.Module type)

Sets module for logging.

Parameters:

type - the MesosferBeacon.Module type of beacon.

Returns:

the current instance for chaining method use.

setEvent

public MesosferLog setEvent(MesosferBeacon.Event event)

Sets event for logging.

Parameters:

event - the MesosferBeacon.Event event of beacon.

Returns:

the current instance for chaining method use.

sendAsync

public void sendAsync(SaveCallback callback)

Saves this object to the server at some unspecified time in the future, even if Mesosfer is currently inaccessible. Use this when you may not have a solid network connection, and don't need to know when the save completes. If there is some problem with the object such that it can't be saved, it will be silently discarded. Objects saved with this method will be stored locally in an on-disk cache until they can be delivered to Mesosfer. They will be sent immediately if possible. Otherwise, they will be sent the next time a network connection is available. Objects saved this way will persist even after the app is closed, in which case they will be sent the next time the app is opened. If more than 10MB of data is waiting to be sent, subsequent calls to #sendAsync() will cause old saves to be silently discarded until the connection can be re-established, and the queued objects can be saved.

Parameters:

callback - A callback which will be called if the save completes before the app exits.