RemoteRef (Java Platform SE 8 )

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)` 将要序列化的引用类型的类名返回到流“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()` 返回一个远程对象的哈希码。
`String`	`remoteToString()` 返回一个表示此远程对象引用的字符串。

Methods inherited from interface java.io.Externalizable
readExternal, writeExternal

- 字段详细信息
  - 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 - 包含 obj的对象（例如，对象的RemoteStub）。
    
    method - 要调用的方法
    
    params - 参数列表
    
    opnum - 可用于表示方法的散列
    
    结果
    
    远程方法调用的结果
    
    异常
    
    异常 - 如果在远程方法调用期间发生任何异常
    
    从以下版本开始：
    
    1.2
  - 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 - stub / skeleton接口哈希
    
    结果
    
    代表远程调用的调用对象
    
    异常
    
    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”。
    
    参数
    
    out - 引用将被序列化的输出流
    
    结果
    
    参考类型的类名（不含包资质）
    
    从以下版本开始：
    
    JDK1.1
  - remoteHashCode
```
int remoteHashCode()
```
    返回一个远程对象的哈希码。引用同一个远程对象的两个远程对象存根将具有相同的哈希码（为了支持远程对象作为哈希表中的键）。
    
    结果
    
    远程对象哈希码
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Hashtable
  - remoteEquals
```
boolean remoteEquals(RemoteRef obj)
```
    比较两个远程对象的相等性。返回一个布尔值，指示该远程对象是否等同于指定的对象。当远程对象存储在散列表中时，将使用此方法。
    
    参数
    
    obj - 要比较的对象
    
    结果
    
    如果这些对象相等则为true; 否则为假。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Hashtable
  - remoteToString
```
String remoteToString()
```
    返回一个表示此远程对象引用的字符串。
    
    结果
    
    表示远程对象引用的字符串
    
    从以下版本开始：
    
    JDK1.1

Interface RemoteRef

Field Summary

方法摘要

Methods inherited from interface java.io.Externalizable

字段详细信息

serialVersionUID

packagePrefix

方法详细信息

invoke

newCall

invoke

done

getRefClass

remoteHashCode

remoteEquals

remoteToString