DGC (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.rmi.dgc
接口 DGC

所有超级接口：: Remote

public interface DGC
extends Remote
extends Remote

DGC 抽象用于分布式垃圾回收算法的服务器端。此接口包含了两个方法：dirty 和 clean。当一个远程引用在客户机（客户机由其 VMID 表示）被解组时，则进行一次脏 (dirty) 调用。当客户机上不存任何针对远程引用的更多引用时，则进行一次相应的洁 (clean) 调用。一次失败的脏调用必须安排一次强洁调用，这样调用的序列号才能保持，以检测未来由分布式垃圾回收器接收的无序调用。针对远程对象的引用由保持该引用的客户机租借一段时间。租借期从接收到脏调用时开始。对租借进行续期是客户机的职责，其方式是：在租借期满之前，在客户机保持的远程引用上进行附加的脏调用。如果客户机在期满之前没有对租借进行续期，则分式布垃圾回收器假定远程对象已不再为该客户机所保持。

方法摘要

void clean(ObjID[] ids, long sequenceNum, VMID vmid, boolean strong)
洁调用从 'ids' 指示的每个远程对象的引用列表中移除 'vmid'。

Lease dirty(ObjID[] ids, long sequenceNum, Lease lease)
脏调用为（与包含在数组 'ids' 中的对象标识符关联的）远程对象引用请求租借。

方法摘要
`void`	`clean(ObjID[] ids, long sequenceNum, VMID vmid, boolean strong)` 洁调用从 'ids' 指示的每个远程对象的引用列表中移除 'vmid'。
`Lease`	`dirty(ObjID[] ids, long sequenceNum, Lease lease)` 脏调用为（与包含在数组 'ids' 中的对象标识符关联的）远程对象引用请求租借。

方法详细信息

dirty

Lease dirty(ObjID[] ids,
            long sequenceNum,
            Lease lease)
            throws RemoteException

脏调用为（与包含在数组 'ids' 中的对象标识符关联的）远程对象引用请求租借。该 'lease' 包含了客户机的惟一 VM 标识符 (VMID) 和一个请求的租期。针对从本地 VM 中导出的每个远程对象，垃圾回收器维护了一个引用列表 - 保持对其引用的客户机列表。如果授予租期，垃圾回收器则为 'ids' 指示的每个远程对象添加客户机 VMID 到引用列表。'sequenceNum' 参数是一个用于检测和丢弃对垃圾回收器最近调用的序号。针对垃圾回收器的每次后续调用，该序号应该总是增加的。有些客户机不能生成 VMID，因为 VMID 是一个包含主机地址的通用惟一标识符，而有些客户机由于安全限制无法获取主机地址。在这种情况下，客户机可以使用一个为 null 的 VMID，并且分布式垃圾回收器为客户机赋予一个 VMID。脏调用返回一个包含所使用 VMID 和授予远程引用租期（服务器可能决定授予一个比客户机所请求更小的租期）的 Lease 对象。客户机必须使用垃圾回收器所使用的 VMID，以便当客户机删除远程对象引用时进行相应的洁调用。客户机 VM 仅需为每个在 VM 中引用的远程引用进行一次初始脏调用（即使它对同一个远程对象持有多个引用）。客户机还必须在租借过期之前进行一次脏调用，以便对远程服务器上的租借进行续期。当客户机不再具有对特定远程对象的任何引用时，它必须为与此引用关联的对象 ID 安排一次洁调用。

参数：: ids - 调用客户机进行引用时要标记的对象 ID; sequenceNum - 序号; lease - 请求的租期
返回：: 授予的租期
抛出：: RemoteException - 如果脏调用失败

clean

void clean(ObjID[] ids,
           long sequenceNum,
           VMID vmid,
           boolean strong)
           throws RemoteException

洁调用从 'ids' 指示的每个远程对象的引用列表中移除 'vmid'。序号用于检测最近的洁调用。如果参数 'strong' 为 true，则洁调用是一次失败的脏调用的结果，因此，应该记住客户机 'vmid' 的序号。

参数：: ids - 调用客户机取消引用时要标记的对象 ID; sequenceNum - 序号; vmid - 客户机 VMID; strong - 进行“强”洁调用
抛出：: RemoteException - 如果洁调用失败

概述