cz.gyarab.util.rmi.server

Class Session<U>

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

cz.gyarab.util.rmi.server.Session<U>

Type Parameters:

U - typ objektu uživatele

All Implemented Interfaces:

ExpiringMap.Permanent, RemoteSession, java.io.Serializable, java.rmi.Remote, java.rmi.server.Unreferenced

public class Session<U>
extends java.rmi.server.UnicastRemoteObject
implements ExpiringMap.Permanent

Objekt relace.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static SessionProvider<cz.gyarab.util.rmi.server.LocalSession>	SIMPLE_PROVIDER Jednoduchá továrna poskytovatele vytvoří instanci LocalSession.LocalSession(int, java.lang.String, java.lang.String, java.lang.String).

Fields inherited from class java.rmi.server.RemoteObject

ref

Constructor Summary

Constructors

Constructor and Description
Session(int port, java.lang.String hostName, java.lang.String userName, java.lang.String userPassword, SessionKey key, U user, SessionManager<U> manager) Vytvoří objekt relace.

Method Summary

Modifier and Type	Method and Description
void	disconnect() Odpojí relaci od serveru.
<I> RemoteObject<I>	get(java.lang.Class<I> iface, java.io.Serializable key) Vytvoří nebo získá přístup k dříve vytvořenému vzdálenému objektu zadaného rozhraní.
SessionKey	getKey() Vrátí klíč identifikace relace.
java.util.Date	getLastUsed() Vrací časové razítko poslední aktivity relace.
java.lang.String	getRemoteHost() Vrací název místního počítače.
static java.lang.String	getRemoteHost(RemoteSession session) Získá název počítače z relace.
U	getUser() Vrátí objekt uživatele.
static <U> U	getUser(RemoteSession session) Vrátí objekt uživatele spojeného s relací.
java.lang.String	getUserName() Vrací jméno uživatele.
static java.lang.String	getUserName(RemoteSession session) Získá jméno uživatele z relace.
java.util.Date	heartbeat() Ověří dostupnost relace.
protected void	checkState() Ověří stav relace.
boolean	isPermanent() Pokud potřebuje hodnota blokovat vlastní expiraci, musí vrítit true.
protected void	register() Zaregistruje relaci.
void	unreferenced()
protected void	unregister() Odregistruje relaci.

Methods inherited from class java.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

SIMPLE_PROVIDER

public static final SessionProvider<cz.gyarab.util.rmi.server.LocalSession> SIMPLE_PROVIDER

Jednoduchá továrna poskytovatele vytvoří instanci LocalSession.LocalSession(int, java.lang.String, java.lang.String, java.lang.String).

Constructor Detail

Session

public Session(int port,
               java.lang.String hostName,
               java.lang.String userName,
               java.lang.String userPassword,
               SessionKey key,
               U user,
               SessionManager<U> manager)
        throws java.rmi.RemoteException

Vytvoří objekt relace.

Parameters:

port - číslo portu serveru

hostName - jméno (DNS, hostname, IP adresa apod.) serveru

userName - uživatelské jméno

userPassword - přístupové heslo

key - klíč identifikace relace

user - objekt uživatele

manager - správce relací

Throws:

java.rmi.RemoteException

Method Detail

getUser

public static <U> U getUser(RemoteSession session)

Vrátí objekt uživatele spojeného s relací.

Type Parameters:

U - typ objektu uživatele

Parameters:

session - relace

Returns:

objekt uživatele

getKey

public SessionKey getKey()

Vrátí klíč identifikace relace.

Returns:

klíč identifikace relace

getUser

public U getUser()

Vrátí objekt uživatele.

Returns:

objekt uživatele

get

public <I> RemoteObject<I> get(java.lang.Class<I> iface,
                               java.io.Serializable key)
                        throws java.rmi.RemoteException,
                               java.lang.InstantiationException

Description copied from interface: RemoteSession

Vytvoří nebo získá přístup k dříve vytvořenému vzdálenému objektu zadaného rozhraní. Pokud to daná implementace serveru podporuje, může volající určit konkrétní objekt zadáním jeho klíče. Implementace také může rozlišovat globální a relační objekty ObjectRegistry.Scope a v kombinaci s klíčováním ObjectRegistry.Keying může dosáhnout libovolného modelu.

Specified by:

get in interface RemoteSession

Type Parameters:

I - požadované rozhraní

Parameters:

iface - požadovné rozhraní

key - klíč do mapy vzdálených objektů, je-li zpotřebí a server ho podporuje/vyžaduje

Returns:

vzdálený objekt

Throws:

java.rmi.RemoteException - při I/O problému

java.lang.InstantiationException - nelze-li objekt vytvořit

unregister

protected void unregister()
                   throws java.rmi.NoSuchObjectException

Odregistruje relaci.

Throws:

java.rmi.NoSuchObjectException

register

protected void register()
                 throws java.rmi.RemoteException

Zaregistruje relaci.

Throws:

java.rmi.RemoteException

isPermanent

public boolean isPermanent()

Description copied from interface: ExpiringMap.Permanent

Pokud potřebuje hodnota blokovat vlastní expiraci, musí vrítit true.

Specified by:

isPermanent in interface ExpiringMap.Permanent

Returns:

příznak blokování expirace

getRemoteHost

public static java.lang.String getRemoteHost(RemoteSession session)

Získá název počítače z relace.

Parameters:

session - relace

Returns:

název počítače, pokud ho relace obsahuje, jinak ""

getUserName

public static java.lang.String getUserName(RemoteSession session)

Získá jméno uživatele z relace.

Parameters:

session - relace

Returns:

jméno uživateole, pokud ho relace obsahuje, jinak ""

getRemoteHost

public java.lang.String getRemoteHost()

Vrací název místního počítače.

Returns:

název místního počítače

getUserName

public java.lang.String getUserName()

Vrací jméno uživatele.

Returns:

jméno uživatele

getLastUsed

public java.util.Date getLastUsed()

Vrací časové razítko poslední aktivity relace.

Returns:

časové razítko poslední aktivity relace

disconnect

public void disconnect()
                throws java.rmi.RemoteException

Description copied from interface: RemoteSession

Odpojí relaci od serveru. Žádné další metody této instance už od této chvíle nesmí být volány.

Specified by:

disconnect in interface RemoteSession

Throws:

java.rmi.RemoteException - při I/O problému

heartbeat

public java.util.Date heartbeat()
                         throws java.rmi.RemoteException

Description copied from interface: RemoteSession

Ověří dostupnost relace.

Specified by:

heartbeat in interface RemoteSession

Returns:

aktuální čas na serveru

Throws:

java.rmi.RemoteException - při I/O problému

unreferenced

public void unreferenced()

Specified by:

unreferenced in interface java.rmi.server.Unreferenced

checkState

protected void checkState()
                   throws java.rmi.RemoteException

Ověří stav relace.

Throws:

java.rmi.RemoteException - pokud došlo k narušení konzistence relace nebo pokud se server stal nedostupným