cz.gyarab.util.rmi

Interface RemoteObject<I>

Type Parameters:

I - rozhraní, ke kterému se váže vzdálený objekt

All Superinterfaces:

java.lang.AutoCloseable, java.rmi.Remote

All Known Implementing Classes:

LocalObject

public interface RemoteObject<I>
extends java.rmi.Remote, java.lang.AutoCloseable

Zapouzdření pro vzdálený objekt. V ideálním světě by nebyl takový objekt zapotřebí a server by mohl nabízet libovolné rozhraní přímo. Jenže při volání místní implementace metody může být vyvolána jen určitá množina výjimek (runtime a těch deklarovaných), při vzdáleném volání k těmto výjimkám přistupují další, i kontrolované. V důsledku toho by musela všechna exportovaná rozhraní rozšiřovat Remote a všechny metody deklarovat RemoteException. To je jistě nepraktické, takže implementace klient-serverové komunikace v ArabTools sáhla po tomto zapouzdření. Pokud při spouštění vzdálených metod dojde k vyvolání výjimky jiné, než té, kterou úmyslně vyvolala volaná metoda (u které je tedy žádoucí, aby se propagovala k volajícímu), bude zabalena jako kauza do runtime ServerRuntimeException. Vzdálený objekt je pravděpodobně již poškozen (např. ho server už odstranil z paměti, server se také mohol ukončit nebo restartovat, mohlo dojít k trvalému přerušení spojení apod.), takže další volání jeho metod by už nedávalo smysl.

Since:

1.4

Method Summary

Modifier and Type	Method and Description
void	close() Zavře tento vzdálený objekt a na serveru ho odstraní z paměti.
java.lang.Object	invoke(Invoke<I> invoke) Vykoná požadovanou metodu s uvedenými argumenty na přidruženém vzdáleném objektu.

Method Detail

invoke

java.lang.Object invoke(Invoke<I> invoke)
                 throws java.rmi.RemoteException,
                        InvocationException

Vykoná požadovanou metodu s uvedenými argumenty na přidruženém vzdáleném objektu. Metodu volá klient, implementuje server.

Parameters:

invoke - požadované parametry volání

Returns:

návratová hodnota z metody (primitivní datové typy jsou boxovány, void se vrací jako null)

Throws:

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

InvocationException - při problému s voláním metody (volání postoupilo až na serverovou stranu, ale tam už nebylo možné dál pokračovat); výjimka vyvolaná samotnou metodou je v kauzálním řetězi této výjimky

close

void close()
    throws java.rmi.RemoteException

Zavře tento vzdálený objekt a na serveru ho odstraní z paměti.

Je nepřípustné po vykonání této metody dál objekt používat na klienstké straně (např. volat jeho další metody vč. této).

Specified by:

close in interface java.lang.AutoCloseable

Throws:

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