org.jwall.web.audit.session
Class Session

java.lang.Object
  org.jwall.web.audit.session.Session

All Implemented Interfaces:

Comparable<Session>, SessionContext

public class Session
extends Object
implements Comparable<Session>, SessionContext

This class implements a data storage of some key-value-pairs, all associated with a unique session-id.

Author:

Christian Bockermann <chris@jwall.org>

Field Summary

static int	COOKIE_BASED
static int	HEURISTIC_BASED
static int	PARAMETER_BASED

Constructor Summary

Session(int type, String id, AuditEvent evt)
Creates a new session with the given session-identifier and the first event of the session being evt.

Method Summary

void	addEvent(AuditEvent e)
int	compareTo(Session s) This compares the session to s.
boolean	equals(Object o)
Date	firstAccessed()
String	getId() This method returns an unique identifier that serves as a key to this session.
InetAddress	getInetAddress()
double	getScore()
int	getType() Returns wether this session context is tracked based on a Session-Id in Cookies, Parameters or just heuristically using ip, time and user-agent.
String	getVariable(String name) This method returns the string-value of the variable given by name.
Set<String>	getVariableNames() This method returns a set of variable names (strings) that are set within the session scope and did not expire yet.
int	hashCode()
void	increment(String var, int count) This method will increment the count of the variable var by the amount of count.
Date	lastAccessed()
void	removeVariable(String name) This method shall remove the variable with the given name from the session-context.
void	setInetAddress(InetAddress addr)
void	setScore(double d)
void	setVariable(String name, String value, Date expires) This method creates a new variable with the given name and initializes it to the value provided by value.
String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

COOKIE_BASED

public static final int COOKIE_BASED

See Also:

Constant Field Values

PARAMETER_BASED

public static final int PARAMETER_BASED

See Also:

Constant Field Values

HEURISTIC_BASED

public static final int HEURISTIC_BASED

See Also:

Constant Field Values

Constructor Detail

Session

public Session(int type,
               String id,
               AuditEvent evt)

Creates a new session with the given session-identifier and the first event of the session being evt. Start time of the session is the date for evt.

Parameters:

type - The type which denotes the kind of session-tracker by which the session is created.

Method Detail

getType

public int getType()

Returns wether this session context is tracked based on a Session-Id in Cookies, Parameters or just heuristically using ip, time and user-agent.

Returns:

The type of session-tracker that created this ession.

setInetAddress

public void setInetAddress(InetAddress addr)

Parameters:

addr -

getInetAddress

public InetAddress getInetAddress()

Returns:

The ip-address that is associated with this session.

lastAccessed

public Date lastAccessed()

firstAccessed

public Date firstAccessed()

getId

public String getId()

Description copied from interface: SessionContext

This method returns an unique identifier that serves as a key to this session.

Specified by:

getId in interface SessionContext

Returns:

The session identifier.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

addEvent

public void addEvent(AuditEvent e)

Parameters:

e -

compareTo

public int compareTo(Session s)

This compares the session to s. Basically this is just a comparison of the session-identifiers and results in a lexikographical order of sessions based on ther session-ids.

Specified by:

compareTo in interface Comparable<Session>

Parameters:

s -

Returns:

0, if this session equals s, or +1/-1 if it is ordered before/after s.

toString

public String toString()

Overrides:

toString in class Object

getScore

public double getScore()

setScore

public void setScore(double d)

getVariable

public String getVariable(String name)

Description copied from interface: SessionContext

This method returns the string-value of the variable given by name. If no such variable exists within this session, null is returned.

Specified by:

getVariable in interface SessionContext

Returns:

The value of the variable given by name or null if the variable does not exist.

getVariableNames

public Set<String> getVariableNames()

Description copied from interface: SessionContext

This method returns a set of variable names (strings) that are set within the session scope and did not expire yet. Not that due to expiration the returned set of variables may not reflect the set of currently set variables, as after calling this method a variable might expire.

Specified by:

getVariableNames in interface SessionContext

Returns:

The variable-names that are valid in this session-context.

increment

public void increment(String var,
                      int count)

Description copied from interface: SessionContext

This method will increment the count of the variable var by the amount of count. If the variable is a non-numeric one, calling this method will have no effect.

Specified by:

increment in interface SessionContext

setVariable

public void setVariable(String name,
                        String value,
                        Date expires)

Description copied from interface: SessionContext

This method creates a new variable with the given name and initializes it to the value provided by value. The variable will expire at the given date or as the session itself expires. By providing a null value for the date, the variable will be set to expire at the sessions end.

Specified by:

setVariable in interface SessionContext

removeVariable

public void removeVariable(String name)

Description copied from interface: SessionContext

This method shall remove the variable with the given name from the session-context. If no such variable exists, calling this method will have no effect.

Specified by:

removeVariable in interface SessionContext

hashCode

public int hashCode()

Overrides:

hashCode in class Object