omero.util

Class ServantHolder

java.lang.Object

omero.util.ServantHolder

public class ServantHolder
extends java.lang.Object

Manager for all active servants in a single session. To reduce the need of using Util.stringToIdentity(String) and Util.identityToString(Ice.Identity) the servant tries to make the two usages equivalent.

Since:

3.0-Beta4

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.String,java.lang.Object>	clientIds An internal mapping to all client ids from SessionI for a given DB session since there is no method on ObjectAdapter to retrieve all servants.

Constructor Summary

Constructors

Constructor and Description
ServantHolder(java.lang.String session)
ServantHolder(java.lang.String session, int servantsPerSession)

Method Summary

Modifier and Type	Method and Description
void	acquireLock(java.lang.String key) Acquires the given lock or if necessary creates a new one.
void	addClientId(java.lang.String clientId)
Ice.Object	get(Ice.Identity id)
java.util.Set<java.lang.String>	getClientIds()
Ice.Identity	getIdentity(java.lang.String idName) Constructs an Identity from the current session and from the given String which for stateful services are defined by UUIDs.
java.util.List<java.lang.String>	getServantList()
java.lang.String	getSession()
java.lang.String	getStatefulServiceCount()
java.lang.Object	getUntied(Ice.Identity id)
void	put(Ice.Identity id, Ice.Object servant)
void	releaseLock(java.lang.String key) Releases the given lock if found, otherwise throws an InternalException
Ice.Object	remove(Ice.Identity id)
void	removeClientId(java.lang.String clientId)

Methods inherited from class java.lang.Object

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

Field Detail

clientIds

protected final java.util.Map<java.lang.String,java.lang.Object> clientIds

An internal mapping to all client ids from SessionI for a given DB session since there is no method on ObjectAdapter to retrieve all servants.

Constructor Detail

ServantHolder

public ServantHolder(java.lang.String session)

ServantHolder

public ServantHolder(java.lang.String session,
                     int servantsPerSession)

Method Detail

getSession

public java.lang.String getSession()

getIdentity

public Ice.Identity getIdentity(java.lang.String idName)

Constructs an Identity from the current session and from the given String which for stateful services are defined by UUIDs.

addClientId

public void addClientId(java.lang.String clientId)

removeClientId

public void removeClientId(java.lang.String clientId)

getClientIds

public java.util.Set<java.lang.String> getClientIds()

acquireLock

public void acquireLock(java.lang.String key)

Acquires the given lock or if necessary creates a new one.

Parameters:

key - the lock's key

releaseLock

public void releaseLock(java.lang.String key)

Releases the given lock if found, otherwise throws an InternalException

Parameters:

key - the lock's key

get

public Ice.Object get(Ice.Identity id)

getUntied

public java.lang.Object getUntied(Ice.Identity id)

put

public void put(Ice.Identity id,
                Ice.Object servant)
         throws OverUsageException

Throws:

OverUsageException

remove

public Ice.Object remove(Ice.Identity id)

getServantList

public java.util.List<java.lang.String> getServantList()

getStatefulServiceCount

public java.lang.String getStatefulServiceCount()