csbase.util.rmi

Class PortReference

java.lang.Object

csbase.util.rmi.PortReference

public class PortReference
extends Object

Representa uma referência a uma porta.
Manter uma referência a uma porta impede que ela seja utilizada por terceiros.

Esse referência também permite que sejam exportados objetos por aquela porta e também verificar se um endpoint consegue acessar aquela porta e consequentemente chamar os métodos dos objetos exportados por ela.

Author:

Tecgraf

Constructor Summary

Constructors

Constructor and Description
PortReference() Construtor.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	bind(int port) Vincula a referência com uma determinada porta, impedindo que terceiros utilizem aquela porta.
Remote	exportObject(Remote obj) Exporta um objeto na porta referenciada.
boolean	isBound() Verifica se esta instância está vinculada a uma porta.
boolean	isReachableBy(IPingable endpoint) Verifica se um endpoint conseguiria acessar os objetos exportados por essa porta.
void	unbind() Caso exista um vinculo com uma porta, desfaz ele.
boolean	unexportObject(Remote obj, boolean force) Remove o dado objeto da runtime do RMI.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PortReference

public PortReference()

Construtor.

Method Detail

bind

public boolean bind(int port)

Vincula a referência com uma determinada porta, impedindo que terceiros utilizem aquela porta. Se já ouver vínculo com alguma porta, o vínculo anterior será desfeito.

Parameters:

port - Porta na qual a referência será vinculada.
Se o valor passado for 0, o sistema irá escolher a porta no qual essa instância irá se vincular.

Returns:

True se foi possível se vincular a porta dada, ou false caso ela já estivesse em uso.

unbind

public void unbind()

Caso exista um vinculo com uma porta, desfaz ele.

isBound

public boolean isBound()

Verifica se esta instância está vinculada a uma porta.

Returns:

True se está instância está vinculada a uma porta.

isReachableBy

public boolean isReachableBy(IPingable endpoint)

Verifica se um endpoint conseguiria acessar os objetos exportados por essa porta.

Parameters:

endpoint - Destino dos objetos exportados.

Returns:

True se um endpoint conseguiria acessar os objetos exportados por essa porta.

exportObject

public Remote exportObject(Remote obj)
                    throws RemoteException

Exporta um objeto na porta referenciada.

Parameters:

obj - Objeto a ser exportado.

Returns:

O stub do objeto.

Throws:

RemoteException - Se ocorrer alguma falha durante a exportação.

IllegalStateException - Se não houver uma porta vinculada a essa instância.

See Also:

UnicastRemoteObject.exportObject(Remote, int, java.rmi.server.RMIClientSocketFactory, java.rmi.server.RMIServerSocketFactory)

unexportObject

public boolean unexportObject(Remote obj,
                     boolean force)
                       throws NoSuchObjectException

Remove o dado objeto da runtime do RMI.

Parameters:

obj - Objeto a ser removido da runtime do RMI.

force - Se true , prossegue mesmo que haja chamadas RMI pendentes ou em progresso.

Returns:

True se foi possível remover o objeto da runtime do RMI.

Throws:

NoSuchObjectException - Se o objeto não estiver exportado.

See Also:

UnicastRemoteObject.unexportObject(Remote, boolean)