com.amazonaws.mobileconnectors.amazonmobileanalytics.internal.session

Class Session

java.lang.Object

com.amazonaws.mobileconnectors.amazonmobileanalytics.internal.session.Session

All Implemented Interfaces:

JSONSerializable

public class Session
extends java.lang.Object
implements JSONSerializable

A Session Object Mostly immutable, with the exception of its stop time. This session object tracks whether or not it has been paused by checking the status of it's stop time. A session's stop time is only set when the session has been paused, and is set to -1 if it is currently running. Can be serialized and restored for persistence.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	SESSION_ID_APPKEY_LENGTH
protected static java.lang.String	SESSION_ID_DATE_FORMAT
protected static char	SESSION_ID_DELIMITER
protected static char	SESSION_ID_PAD_CHAR
protected static java.lang.String	SESSION_ID_TIME_FORMAT
protected static int	SESSION_ID_UNIQID_LENGTH

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Session(AnalyticsContext context) CONSTRUCTOR - ACTUAL Used by DefaultSessionClient
protected	Session(java.lang.String sessionID, java.lang.String startTime, java.lang.String stopTime) CONSTRUCTOR - EXPLICIT Used by the

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	generateSessionID(AnalyticsContext context) Generates Session ID by concatenating present AppKey, UniqueID, and Timestamp more detail: https://w.amazon.com/index.php/GameLab:SessionEvents#Session_ID
java.lang.Long	getSessionDuration() Calculates and returns the session's duration Returns a duration of 0 if session is not paused or the system clock has been tampered with.
static Session	getSessionFromSerializedSession(java.lang.String serializedSession) Re-Generates a session object that has been serialized Returns null if the input is null
java.lang.String	getSessionID()
long	getStartTime()
java.lang.Long	getStopTime()
boolean	isPaused() Session is considered paused if stopTime is not null
static Session	newInstance(AnalyticsContext context) STATIC FACTORY
void	pause() Pauses the session object.
void	resume() Resumes the session object.
org.json.JSONObject	toJSONObject()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

SESSION_ID_DATE_FORMAT

protected static final java.lang.String SESSION_ID_DATE_FORMAT

See Also:

Constant Field Values

SESSION_ID_TIME_FORMAT

protected static final java.lang.String SESSION_ID_TIME_FORMAT

See Also:

Constant Field Values

SESSION_ID_DELIMITER

protected static final char SESSION_ID_DELIMITER

See Also:

Constant Field Values

SESSION_ID_PAD_CHAR

protected static final char SESSION_ID_PAD_CHAR

See Also:

Constant Field Values

SESSION_ID_APPKEY_LENGTH

protected static final int SESSION_ID_APPKEY_LENGTH

See Also:

Constant Field Values

SESSION_ID_UNIQID_LENGTH

protected static final int SESSION_ID_UNIQID_LENGTH

See Also:

Constant Field Values

Constructor Detail

Session

protected Session(AnalyticsContext context)

CONSTRUCTOR - ACTUAL Used by DefaultSessionClient

Parameters:

context -

Session

protected Session(java.lang.String sessionID,
       java.lang.String startTime,
       java.lang.String stopTime)

CONSTRUCTOR - EXPLICIT Used by the

Parameters:

sessionID -

startTime -

stopTime -

Method Detail

newInstance

public static Session newInstance(AnalyticsContext context)

STATIC FACTORY

Parameters:

context -

Returns:

new Session object

getSessionFromSerializedSession

public static Session getSessionFromSerializedSession(java.lang.String serializedSession)

Re-Generates a session object that has been serialized Returns null if the input is null

Parameters:

serializedSession - - a Session's serialization string.

Returns:

a session object identical to the one that was serialized

isPaused

public boolean isPaused()

Session is considered paused if stopTime is not null

Returns:

true iff session is currently paused

pause

public void pause()

Pauses the session object. Generates a stop time.

resume

public void resume()

Resumes the session object. Invalidates the stop time.

getSessionDuration

public java.lang.Long getSessionDuration()

Calculates and returns the session's duration Returns a duration of 0 if session is not paused or the system clock has been tampered with.

Returns:

session duration in milliseconds

generateSessionID

public java.lang.String generateSessionID(AnalyticsContext context)

Generates Session ID by concatenating present AppKey, UniqueID, and Timestamp more detail: https://w.amazon.com/index.php/GameLab:SessionEvents#Session_ID

Returns:

[String] SessionID

toJSONObject

public org.json.JSONObject toJSONObject()

Specified by:

toJSONObject in interface JSONSerializable

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getSessionID

public java.lang.String getSessionID()

getStartTime

public long getStartTime()

getStopTime

public java.lang.Long getStopTime()