de.aristaflow.adept2.base.sessionmanagement

Class QualifiedAgent

java.lang.Object

de.aristaflow.adept2.base.sessionmanagement.QualifiedAgent

All Implemented Interfaces:

java.io.Serializable

public final class QualifiedAgent
extends java.lang.Object
implements java.io.Serializable

A QualifiedAgent represents an agent (tuple) that has been authenticated and provides all information the system needs for unique identification. Each agent tuple consists of the IDs of the agent and a corresponding organisational position as well as the corresponding names. For more information on an agent use RichAgent.

Author:

Patrick Schmidt

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	QualifiedAgent(long agentID, java.lang.String agentUserName, long orgPositionID, java.lang.String orgPositionName) Constructs a new QualifiedAgent for the designated agent and organisational position ID.
protected	QualifiedAgent(long agentID, java.lang.String agentUserName, long orgPositionID, java.lang.String orgPositionName, java.lang.String userSessionID) Constructs a new QualifiedAgent for the designated agent and organisational position ID as well as the user session ID.

Method Summary

Modifier and Type	Method and Description
static QualifiedAgent	create(long agentID, java.lang.String agentUserName, long orgPositionID, java.lang.String orgPositionName) Constructs a new QualifiedAgent for the designated agent and organisational position ID.
static QualifiedAgent	create(long agentID, java.lang.String agentUserName, long orgPositionID, java.lang.String orgPositionName, java.lang.String userSessionID) Constructs a new QualifiedAgent for the designated agent and organisational position ID as well as the user session ID.
boolean	equals(java.lang.Object obj) Two QualifiedAgents are equal if their agent IDs and org position IDs match.
protected void	finalize() Removes the entry from the intern cache if this object instance is the JVM-wide used.
long	getAgentID() Returns the Agent's ID of this result entry.
java.lang.String	getAgentUserName() Returns the Agent's user name of this result entry.
long	getOrgPositionID() Returns the OrgPosition ID (of the Agent's OrgPosition) of this result entry.
java.lang.String	getOrgPositionName() Returns the OrgPosition name (of the Agent's OrgPosition) of this result entry.
java.lang.String	getUserSessionID() Gets the ID of the user session which is provided by various (client) frameworks.
int	hashCode()
QualifiedAgent	intern() Interns this qualified agent, that is, looks up the designated agent in an internal map and uses the very same object instance for the same agent, similar to a singleton.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

QualifiedAgent

protected QualifiedAgent(long agentID,
                         java.lang.String agentUserName,
                         long orgPositionID,
                         java.lang.String orgPositionName)

Constructs a new QualifiedAgent for the designated agent and organisational position ID. Please pay attention to the order as both parameters are ints. The user session ID will be set to null.

Parameters:

agentID - The ID of this agent.

agentUserName - The name of this agent.

orgPositionID - The ID of the organisational position of the agent.

orgPositionName - The name of the organisational position of the agent.

QualifiedAgent

protected QualifiedAgent(long agentID,
                         java.lang.String agentUserName,
                         long orgPositionID,
                         java.lang.String orgPositionName,
                         java.lang.String userSessionID)

Constructs a new QualifiedAgent for the designated agent and organisational position ID as well as the user session ID. Please pay attention to the order as both parameters are ints.

Parameters:

agentID - The ID of this agent.

agentUserName - The name of this agent.

orgPositionID - The ID of the organisational position of the agent.

orgPositionName - The name of the organisational position of the agent.

userSessionID - The session ID as provided by various (client) frameworks like HTTP-Session-IDs.

Method Detail

create

public static QualifiedAgent create(long agentID,
                                    java.lang.String agentUserName,
                                    long orgPositionID,
                                    java.lang.String orgPositionName)

Constructs a new QualifiedAgent for the designated agent and organisational position ID. Please pay attention to the order as both parameters are ints. The user session ID will be set to null.

Parameters:

agentID - The ID of this agent.

agentUserName - The name of this agent.

orgPositionID - The ID of the organisational position of the agent.

orgPositionName - The name of the organisational position of the agent.

Returns:

The newly created agent.

create

public static QualifiedAgent create(long agentID,
                                    java.lang.String agentUserName,
                                    long orgPositionID,
                                    java.lang.String orgPositionName,
                                    java.lang.String userSessionID)

Constructs a new QualifiedAgent for the designated agent and organisational position ID as well as the user session ID. Please pay attention to the order as both parameters are ints.

Parameters:

agentID - The ID of this agent.

agentUserName - The name of this agent.

orgPositionID - The ID of the organisational position of the agent.

orgPositionName - The name of the organisational position of the agent.

userSessionID - The session ID as provided by various (client) frameworks like HTTP-Session-IDs.

Returns:

The newly created agent.

getAgentID

public long getAgentID()

Returns the Agent's ID of this result entry.

Returns:

the Agent's ID of this result entry

getAgentUserName

public java.lang.String getAgentUserName()

Returns the Agent's user name of this result entry.

Returns:

the Agent's user name of this result entry

getOrgPositionID

public long getOrgPositionID()

Returns the OrgPosition ID (of the Agent's OrgPosition) of this result entry.

Returns:

the OrgPosition ID of this result entry

getOrgPositionName

public java.lang.String getOrgPositionName()

Returns the OrgPosition name (of the Agent's OrgPosition) of this result entry.

Returns:

the OrgPosition ID of this result entry

getUserSessionID

public java.lang.String getUserSessionID()

Gets the ID of the user session which is provided by various (client) frameworks. For instance HTTP-frameworks use a HTTP-Session-ID to identify each user uniquely. This will be null in case no corresponding ID is provided.

Returns:

The ID of the user session that allows various frameworks to identify a user uniquely.

intern

public QualifiedAgent intern()

Interns this qualified agent, that is, looks up the designated agent in an internal map and uses the very same object instance for the same agent, similar to a singleton. This method is equivalent to String.intern().
Only qualified agents without a user session ID will be interned.

Returns:

The interned qualified agent, that is the one and only object instance representing this agent in one JVM or this object instance.

finalize

protected void finalize()

Removes the entry from the intern cache if this object instance is the JVM-wide used.

Overrides:

finalize in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Two QualifiedAgents are equal if their agent IDs and org position IDs match. getUserSessionID() is not considered here!

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object