java.lang.ref.ReferenceQueue翻译

public class ReferenceQueue extends ObjectReference queues, to which registered reference objects are appended by the garbage collector after the appropriate reachability changes are detected. 引用队列，在检测到适当的可访问性变化后，通过垃圾收集器将已注册的引用对象加入。

Since: 1.2 Constructor Summary

ReferenceQueue()

Constructs a new reference-object queue. 构建新的引用对象队列。

Method Summary

Reference

poll()

Polls this queue to see if a reference object is available. 查询队列是否存在可用的引用对象。

Reference

remove()

Removes the next reference object in this queue, blocking until one becomes available. 从队列中删除下一个引用对象，阻塞直到有一个可用。

Reference

remove(long timeout)

Removes the next reference object in this queue, blocking until either one becomes available or the given timeout period expires. 从队列中删除下一个引用对象，阻塞直到有一个可用或给定超时期满。

Methods inherited from class java.lang.Object

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

Constructor Detail

ReferenceQueuepublic ReferenceQueue()

Constructs a new reference-object queue. 构建新的引用对象队列。

Method Detail

pollpublic Reference poll()

Polls this queue to see if a reference object is available. If one is available without further delay then it is removed from the queue and returned. Otherwise this method immediately returns null. 查询队列是否存在可用的引用对象。如果有一个可用，不需要进一步延迟，那么从队列中删除后返回。否则方法立即返回null。

Returns: A reference object, if one was immediately available, otherwise null 如果有一个引用对象可用，立即返回，否则返回nullremovepublic Reference remove(long timeout)

throws IllegalArgumentException,

InterruptedException

Removes the next reference object in this queue, blocking until either one becomes available or the given timeout period expires. 从队列中删除下一个引用对象，阻塞直到有一个可用或给定超时期满。 This method does not offer real-time guarantees: It schedules the timeout as if by invoking the Object.wait(long) method. 该方法不提供实时担保，如同通过Object.wait(long)方法安排超时时间。

Parameters: timeout - If positive, block for up timeout milliseconds while waiting for a reference to be added to this queue. If zero, block indefinitely. 如果为正值，当等待一个引用加入队列时，阻塞timeout毫秒。如果为0，则永久阻塞下去。 Returns: A reference object, if one was available within the specified timeout period, otherwise null 如果在指定超时期限内有可用引用对象，则返回，否则返回null Throws: IllegalArgumentException - If the value of the timeout argument is negative 如果timeout参数值为负则抛出 InterruptedException - If the timeout wait is interrupted 如果超时等待被中断后抛出removepublic Reference remove()

throws InterruptedException

Removes the next reference object in this queue, blocking until one becomes available. 从队列中删除下一个引用对象，阻塞直到有一个可用。

Returns: A reference object, blocking until one becomes available 引用对象，阻塞直到一个可用 Throws: InterruptedException - If the wait is interrupted 如果等待被中断后抛出[/url][url=file:///F:/资料/文字资料/j2sdk-1_4_2-doc/docs/api/overview-summary.html]Overview

Class

JavaTM 2 Platform

Std. Ed. v1.4.2

PREV CLASS NEXT CLASS

FRAMES NO FRAMES All Classes

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature

For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.