模块 java.rmi

接口 RemoteRef

所有父级接口:
Externalizable , Serializable
所有已知的子接口:
ServerRef

public interface RemoteRef extends Externalizable
RemoteRef 表示远程对象的句柄。 RemoteStub 使用远程引用对远程对象执行远程方法调用。
自从:
1.1
参见:
  • 字段详细信息

    • serialVersionUID

      @Deprecated static final long serialVersionUID
      已弃用。
      接口中的 serialVersionUID 字段无效。不使用;没有替代品。
      表示与类的 JDK 1.1.x 版本的兼容性。
      参见:
    • packagePrefix

      static final String  packagePrefix
      初始化服务包前缀:假定服务引用类(例如,UnicastRef、UnicastServerRef)的实现位于前缀定义的包中。
      参见:
  • 方法详情

    • invoke

      Object  invoke(Remote  obj, Method  method, Object [] params, long opnum) throws Exception
      调用一个方法。这种将方法调用委托给引用的形式允许引用负责建立与远程主机的连接,为方法和参数编组一些表示,然后将方法调用传递给远程主机。此方法返回对驻留在远程主机上的远程对象的方法调用的结果,或者如果调用失败则抛出 RemoteException 或如果远程调用抛出异常则抛出应用程序级异常。
      参数:
      obj - 包含 RemoteRef 的对象(例如,对象的 RemoteStub。
      method - 要调用的方法
      params - 参数列表
      opnum - 可用于表示方法的散列
      返回:
      远程方法调用的结果
      抛出:
      Exception - 如果在远程方法调用期间发生任何异常
      自从:
      1.2
    • newCall

      @Deprecated RemoteCall  newCall(RemoteObject  obj, Operation [] op, int opnum, long hash) throws RemoteException
      已弃用。
      1.2 样式存根不再使用此方法。存根不是在存根的远程引用(newCallinvokedone)上使用一系列方法调用,而是在远程引用上使用单个方法 invoke(Remote, Method, Object[], int) 来执行参数编组、远程方法执行和返回的解组值。
      为此对象上的新远程方法调用创建适当的调用对象。传递操作数组和索引,允许存根生成器分配操作索引并解释它们。远程引用可能需要操作在调用中进行编码。
      参数:
      obj - 通过其进行调用的远程存根
      op - 存根操作数组
      opnum - 操作编号
      hash - 存根/骨架接口哈希
      返回:
      表示远程调用的调用对象
      抛出:
      RemoteException - 如果未能启动新的远程调用
      自从:
      1.1
      参见:
    • invoke

      @Deprecated void invoke(RemoteCall  call) throws Exception
      已弃用。
      1.2 样式存根不再使用此方法。存根不是使用对远程引用(newCallinvokedone)的一系列方法调用,而是在远程引用上使用单个方法 invoke(Remote, Method, Object[], int) 来执行参数编组、远程方法执行和返回值的解组。
      执行远程调用。 Invoke 将引发任何应该通过但不被存根捕获的“用户”异常。如果在远程调用期间引发任何异常,调用应该在引发“用户”或远程异常之前负责清理连接。
      参数:
      call - 表示远程调用的对象
      抛出:
      Exception - 如果在远程方法期间发生任何异常
      自从:
      1.1
      参见:
    • done

      @Deprecated void done(RemoteCall  call) throws RemoteException
      已弃用。
      1.2 样式存根不再使用此方法。存根不是使用对远程引用(newCallinvokedone)的一系列方法调用,而是在远程引用上使用单个方法 invoke(Remote, Method, Object[], int) 来执行参数编组、远程方法执行和返回值的解组。
      允许远程引用清理(或重用)连接。仅当调用成功(非异常)返回存根时才应调用 Done。
      参数:
      call - 表示远程调用的对象
      抛出:
      RemoteException - 如果在调用清理期间发生远程错误
      自从:
      1.1
      参见:
    • getRefClass

      String  getRefClass(ObjectOutput  out)
      返回要序列化到流“out”上的 ref 类型的类名。
      参数:
      out - 引用将被序列化到的输出流
      返回:
      引用类型的类名(没有包限定)
      自从:
      1.1
    • remoteHashCode

      int remoteHashCode()
      返回远程对象的哈希码。引用同一个远程对象的两个远程对象存根将具有相同的哈希码(为了支持远程对象作为哈希表中的键)。
      返回:
      远程对象哈希码
      自从:
      1.1
      参见:
    • remoteEquals

      boolean remoteEquals(RemoteRef  obj)
      比较两个远程对象是否相等。返回一个boolean,指示此远程对象是否等同于指定的对象。当远程对象存储在哈希表中时使用此方法。
      参数:
      obj - 要与之比较的对象
      返回:
      如果这些对象相等则为真;否则为假。
      自从:
      1.1
      参见:
    • remoteToString

      String  remoteToString()
      返回表示此远程对象的引用的字符串。
      返回:
      表示远程对象引用的字符串
      自从:
      1.1