compact2, compact3

java.rmi.server

Interface RemoteRef

All Superinterfaces:

Externalizable， Serializable

All Known Subinterfaces:

ServerRef

public interface RemoteRef
extends Externalizable

RemoteRef代表一个远程对象的句柄。一个 RemoteStub使用远程引用进行远程方法调用远程对象。

从以下版本开始：

JDK1.1

另请参见：

RemoteStub

Field Summary

Fields

Modifier and Type	Field and Description
static String	packagePrefix 初始化服务器包前缀：假设服务器参考类的实现（例如，unicastref，unicastserverref）位于由前缀定义的包。
static long	serialVersionUID 表明JDK 1.1类X版本的兼容性。

方法摘要

Modifier and Type	Method and Description
void	done(RemoteCall call) 过时的。 1.2式单不再使用这种方法。而不是使用一个序列的方法调用的远程引用（newCall，invoke，和done），一个使用一个单一的方法，invoke(Remote, Method, Object[], int)，在远程参考进行参数编组，执行远程方法的返回值和解包。
String	getRefClass(ObjectOutput out) 返回引用类型进行序列化到流出来的类的名字。
void	invoke(RemoteCall call) 过时的。 1.2式单不再使用这种方法。而不是使用一个序列的方法调用的远程引用（newCall，invoke，和done），一个使用一个单一的方法，invoke(Remote, Method, Object[], int)，在远程参考进行参数编组，执行远程方法的返回值和解包。
Object	invoke(Remote obj, 方法 method, Object[] params, long opnum) 调用一个方法。
RemoteCall	newCall(RemoteObject obj, Operation[] op, int opnum, long hash) 过时的。 1.2式单不再使用这种方法。而不是使用一个序列的方法调用存根上的远程参考（newCall，invoke，和done），一个使用一个单一的方法，invoke(Remote, Method, Object[], int)，在远程参考进行参数编组，执行远程方法的返回值和解包。
boolean	remoteEquals(RemoteRef obj) 比较两个相等的远程对象。
int	remoteHashCode() 返回一个远程对象的hashCode。
String	remoteToString() 返回一个表示此远程对象的引用的字符串。

Methods inherited from interface java.io.Externalizable

readExternal, writeExternal

Field Detail

serialVersionUID

static final long serialVersionUID

表明JDK 1.1类X版本的兼容性。

另请参见：

Constant Field Values

packagePrefix

static final String packagePrefix

初始化服务器包前缀：假设服务器参考类的实现（例如，unicastref，unicastserverref）位于由前缀定义的包。

另请参见：

Constant Field Values

方法详细信息

invoke

Object invoke(Remote obj,
              方法 method,
              Object[] params,
              long opnum)
       throws 异常

调用一个方法。这种形式的授权方法调用参考允许参考照顾设置连接到远程主机，配置的方法和参数的一些代表，然后沟通方法调用远程主机。这个方法返回，驻留在远程主机或抛出RemoteException如果调用失败或应用程序级别的例外，如果远程调用抛出异常的远程对象的方法调用的结果。

参数

obj -包含remoteref对象（例如，该对象的remotestub。

method -被调用的方法

params -参数列表

opnum -哈希值可以用来表示方法

结果

远程方法调用的结果

异常

异常如果远程方法调用期间发生任何异常

从以下版本开始：

一点二

newCall

@Deprecated
RemoteCall newCall(RemoteObject obj,
                               Operation[] op,
                               int opnum,
                               long hash)
                        throws RemoteException

过时的。 1.2式单不再使用这种方法。而不是使用一个序列的方法调用存根上的远程参考（newCall，invoke，和done），一个使用一个单一的方法，invoke(Remote, Method, Object[], int)，在远程参考进行参数编组，执行远程方法的返回值和解包。

为这个对象上的一个新的远程方法调用创建一个适当的调用对象。通过操作数组和索引，允许存根发电机分配操作指标与解释。远程引用可能需要在调用中进行编码的操作。

参数

obj远程存根来打电话

op -短线操作数组

opnum操作数

hash存根/骨架接口散列

结果

表示远程调用的调用对象

异常

RemoteException如果未能启动新的远程调用

从以下版本开始：

JDK1.1

另请参见：

invoke(Remote,java.lang.reflect.Method,Object[],long)

invoke

@Deprecated
void invoke(RemoteCall call)
                 throws 异常

过时的。 1.2式单不再使用这种方法。而不是使用一个序列的方法调用的远程引用（newCall，invoke，和done），一个使用一个单一的方法，invoke(Remote, Method, Object[], int)，在远程参考进行参数编组，执行远程方法的返回值和解包。

执行远程调用。调用将提高任何应该通过的“用户”的异常，而不是被存根捕获。如果在远程调用中引发了任何异常，调用应该在提高“用户”或远程异常之前清理连接的连接。

参数

call对象代表远程调用

异常

异常 -如果在远程方法发生任何异常

从以下版本开始：

JDK1.1

另请参见：

invoke(Remote,java.lang.reflect.Method,Object[],long)

done

@Deprecated
void done(RemoteCall call)
               throws RemoteException

过时的。 1.2式单不再使用这种方法。而不是使用一个序列的方法调用的远程引用（newCall，invoke，和done），一个使用一个单一的方法，invoke(Remote, Method, Object[], int)，在远程参考进行参数编组，执行远程方法的返回值和解包。

允许远程引用清理（或重用）连接。所做的应该只被调用，如果调用成功返回（非异常）的存根。

参数

call对象代表远程调用

异常

RemoteException -如果在调用远程清理发生错误

从以下版本开始：

JDK1.1

另请参见：

invoke(Remote,java.lang.reflect.Method,Object[],long)

getRefClass

String getRefClass(ObjectOutput out)

返回引用类型进行序列化到流出来的类的名字。

参数

out -输出流的引用将被序列化

结果

引用类型的类名称（无包资格）

从以下版本开始：

JDK1.1

remoteHashCode

int remoteHashCode()

返回一个远程对象的hashCode。两个远程对象的存根，指的是同一个远程对象将具有相同的哈希代码（为了支持远程对象的哈希表中的键）。

结果

远程对象的hashCode

从以下版本开始：

JDK1.1

另请参见：

Hashtable

remoteEquals

boolean remoteEquals(RemoteRef obj)

比较两个相等的远程对象。返回一个布尔值，该值指示这个远程对象是否等效于指定的对象。使用此方法时，一个远程对象被存储在哈希表中。

参数

obj -比较对象

结果

如果这些对象是相等的，则为假；否则为。

从以下版本开始：

JDK1.1

另请参见：

Hashtable

remoteToString

String remoteToString()

返回一个表示此远程对象的引用的字符串。

结果

表示远程对象引用的字符串

从以下版本开始：

JDK1.1