cz.gyarab.util.rmi

Interface RemoteServer

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

LocalServer

public interface RemoteServer
extends java.rmi.Remote

Rozhraní vzdáleného serveru. Na straně serveru je singleton a představuje jediný vstpní bod pro klient-serverovou implementaci v ArabTools.

Since:

1.4

Field Summary

Fields

Modifier and Type	Field and Description
static int	CONNECTION_PORT Výchozí číslo TCP portu, na kterém vzdálený server přijímá požadavky.
static java.lang.String	REGISTRY_NAME Unikátní název nabízené služby.

Method Summary

Modifier and Type	Method and Description
RemoteSession	connect(java.lang.String userName, java.lang.String userPassword) Pokusí se připojit k serveru a získat tak instanci vzdálené relace.
Version	version() Zjistí verzi ArabTools na serveru.

Field Detail

REGISTRY_NAME

static final java.lang.String REGISTRY_NAME

Unikátní název nabízené služby.

See Also:

Naming.bind(java.lang.String, java.rmi.Remote)

CONNECTION_PORT

static final int CONNECTION_PORT

Výchozí číslo TCP portu, na kterém vzdálený server přijímá požadavky.

Implementační poznámka: autorovi knihovny není úplně zřejmé, jak přesně fungují tyto porty, jestli je možné, že by měl každý registrovaný vzdálený objekt jiný port apod., tak se pro jistotu v celé implementaci serverové části používá tento jediný port. Viz též konstruktor UnicastRemoteObject(int).

See Also:

Constant Field Values

Method Detail

version

Version version()
         throws java.rmi.RemoteException

Zjistí verzi ArabTools na serveru.

Returns:

serverovou verzi ArabTools

Throws:

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

connect

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

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.

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á