java.lang.ref.ReferenceQueue翻译

 

Overview  Package   Class  Use  Tree  Deprecated  Index  Help			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

---

java.lang.ref
Class ReferenceQueue

java.lang.Object
  java.lang.ref.ReferenceQueue

---

public class ReferenceQueue extends Object

Reference 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

ReferenceQueue

public ReferenceQueue()

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

Method Detail

poll

public 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 如果有一个引用对象可用，立即返回，否则返回null

---

remove

public 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 如果超时等待被中断后抛出

---

remove

public 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 如果等待被中断后抛出

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help			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.