omero.util

Class ServantHolder

java.lang.Object

omero.util.ServantHolder

public class ServantHolder
extends 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

Author:

Josh Moore, josh at glencoesoftware.com

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,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(String session)
ServantHolder(String session, int servantsPerSession)

Method Summary

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

ServantHolder

public ServantHolder(String session,
                     int servantsPerSession)

Method Detail

getSession

public String getSession()

getIdentity

public Ice.Identity getIdentity(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(String clientId)

removeClientId

public void removeClientId(String clientId)

getClientIds

public Set<String> getClientIds()

acquireLock

public void acquireLock(String key)

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

Parameters:

key - the lock's key

releaseLock

public void releaseLock(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 Object getUntied(Ice.Identity id)

put

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

Throws:

omero.OverUsageException

remove

public Ice.Object remove(Ice.Identity id)

getServantList

public List<String> getServantList()

getStatefulServiceCount

public String getStatefulServiceCount()