cz.gyarab.util.rmi.server

Class LocalServer

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

cz.gyarab.util.rmi.server.LocalServer

All Implemented Interfaces:

RemoteServer, java.io.Serializable, java.rmi.Remote

public class LocalServer
extends java.rmi.server.UnicastRemoteObject
implements RemoteServer

Implementace serverového objektu na straně serveru.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.rmi.server.RemoteObject

ref

Fields inherited from interface cz.gyarab.util.rmi.RemoteServer

CONNECTION_PORT, REGISTRY_NAME

Constructor Summary

Constructors

Constructor and Description
LocalServer() Vytvoří objekt serveru s výchozím portem.
LocalServer(int port) Vytvoří objekt serveru se specifickým portem.
LocalServer(int port, java.rmi.server.RMIClientSocketFactory csf, java.rmi.server.RMIServerSocketFactory ssf) Vytvoří objekt serveru se specifickým portem a určenými továrnami na sockety.

Method Summary

Modifier and Type	Method and Description
void	bind() Zaktivuje server a připojí ho na určený port.
RemoteSession	connect(java.lang.String userName, java.lang.String userPassword) Pokusí se připojit k serveru a získat tak instanci vzdálené relace.
static LocalServer	createDefaultServer() Vytvoří výchozí server.
RegistryProvider	getRegistryProvider() Zjistí aktuálního poskytovatele registrací.
void	setRegistryProvider(RegistryProvider registryProvider) Nastaví aktuálního poskytovatele registrací.
void	setSessionProvider(SessionProvider sessionProvider) Nastaví poskytovatele relací (session).
void	unbind() Deaktivuje server a odpojí ho od určeného portu.
Version	version() Zjistí verzi ArabTools na serveru.

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

Constructor Detail

LocalServer

public LocalServer()
            throws java.rmi.RemoteException

Vytvoří objekt serveru s výchozím portem.

Throws:

java.rmi.RemoteException

LocalServer

public LocalServer(int port)
            throws java.rmi.RemoteException

Vytvoří objekt serveru se specifickým portem.

Parameters:

port - číslo portu, na kterém má server naslouchat

Throws:

java.rmi.RemoteException

LocalServer

public LocalServer(int port,
                   java.rmi.server.RMIClientSocketFactory csf,
                   java.rmi.server.RMIServerSocketFactory ssf)
            throws java.rmi.RemoteException

Vytvoří objekt serveru se specifickým portem a určenými továrnami na sockety.

Parameters:

port - číslo portu, na kterém má server naslouchat

csf - továrna na klientské sokety

ssf - továrna na serverové sokety

Throws:

java.rmi.RemoteException

Method Detail

createDefaultServer

public static LocalServer createDefaultServer()
                                       throws java.rmi.RemoteException

Vytvoří výchozí server.

Returns:

server

Throws:

java.rmi.RemoteException

bind

public void bind()
          throws java.rmi.RemoteException

Zaktivuje server a připojí ho na určený port. Port se určuje v konstruktoru a nelze ho změnit.

Throws:

java.rmi.RemoteException

See Also:

LocateRegistry.createRegistry(int)

unbind

public void unbind()
            throws java.rmi.RemoteException

Deaktivuje server a odpojí ho od určeného portu.

Throws:

java.rmi.RemoteException

See Also:

Registry.unbind(java.lang.String)

setSessionProvider

public void setSessionProvider(SessionProvider sessionProvider)

Nastaví poskytovatele relací (session). Pokud není provider nastaven, je použit výchozí poskytovatel.

Parameters:

sessionProvider - nový poskytovatel

See Also:

LocalSession.SIMPLE_PROVIDER

getRegistryProvider

public RegistryProvider getRegistryProvider()

Zjistí aktuálního poskytovatele registrací.

Returns:

aktuálního poskytovatele registrací

setRegistryProvider

public void setRegistryProvider(RegistryProvider registryProvider)

Nastaví aktuálního poskytovatele registrací. Dokud není nastaven specifický poskytovatel, je použit výchozí.

Parameters:

registryProvider - nový poskytovatel registrací

See Also:

ObjectManager

version

public Version version()
                throws java.rmi.RemoteException

Description copied from interface: RemoteServer

Zjistí verzi ArabTools na serveru.

Specified by:

version in interface RemoteServer

Returns:

serverovou verzi ArabTools

Throws:

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

connect

public RemoteSession connect(java.lang.String userName,
                             java.lang.String userPassword)
                      throws java.rmi.RemoteException,
                             AuthException

Description copied from interface: RemoteServer

Pokusí se připojit k serveru a získat tak instanci vzdálené relace. Relace je, na rozdíl od serveru, multiton. Relace se přidělují v závislosti na serverové implementaci, např. LocalServer vytváří Session pomocí SessionManager na základě SessionKey, který se generuje podle zvoleného způsobu SessionKeyGen.

Specified by:

connect in interface RemoteServer

Parameters:

userName - uživatelské jméno, i když není vyžadováno, může ho serverová strana použít např. pro vizuální identifikaci (vedle např. IP adresy)

userPassword - heslo uživatele, může být null, pokud není autentizace vyžadována, heslo se posílá v otevřené podobě, nelze ho tedy použít pro autentizaci proti reálným systémům

Returns:

nově vytvořenou nebo na základě shody identifikace dříve přidělenou relaci

Throws:

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

AuthException - pokud je vyžadována autentizace a jméno/heslo neodpovídá