PriorityBlockingQueue 类

定义

命名空间:: Java.Util.Concurrent

程序集:: Mono.Android.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

未绑定的 BlockingQueue 阻止队列，该队列使用与类 PriorityQueue 相同的排序规则并提供阻止检索操作。

[Android.Runtime.Register("java/util/concurrent/PriorityBlockingQueue", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class PriorityBlockingQueue : Java.Util.AbstractQueue, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Util.Concurrent.IBlockingQueue

[<Android.Runtime.Register("java/util/concurrent/PriorityBlockingQueue", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type PriorityBlockingQueue = class
    inherit AbstractQueue
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IBlockingQueue
    interface IQueue
    interface ICollection
    interface IIterable

继承: Object

Object

AbstractCollection

AbstractQueue
PriorityBlockingQueue

属性: RegisterAttribute JavaTypeParametersAttribute

实现: IJavaObject IJavaPeerable ISerializable IIterable IBlockingQueue ICollection IQueue IDisposable

注解

未绑定的 BlockingQueue 阻止队列，该队列使用与类 PriorityQueue 相同的排序规则并提供阻止检索操作。虽然此队列在逻辑上是未绑定的，但由于资源耗尽（导致）， OutOfMemoryError尝试添加可能会失败。此类不允许 null 元素。依赖于可比较自然排序的优先级队列也不允许插入非可比对象（这样做会导致 ClassCastException）。

此类及其迭代器实现和接口的所有 <em>可选</em> 方法Collection。Iterator 方法中#iterator()提供的迭代器和方法#spliterator()><中提供的拆分器不<>保证按任何特定顺序遍历 PriorityBlockingQueue 的元素。如果需要有序遍历，请考虑使用 Arrays.sort(pq.toArray())。此外，方法 drainTo 可用于 <以>优先级顺序删除</em> 部分或所有元素，并将其放置在另一个集合中。

此类上的操作不能保证对优先级相等的元素的排序。如果需要强制实施排序，可以定义使用辅助键破坏主要优先级值中关系的自定义类或比较器。例如，下面是一个类，该类对可比较元素应用先入先出的断线。若要使用它，可以插入一个 new FIFOEntry(anEntry) 而不是纯条目对象。

{@code
            class FIFOEntry<E extends Comparable<? super E>>
                implements Comparable<FIFOEntry<E>> {
              static final AtomicLong seq = new AtomicLong();
              final long seqNum;
              final E entry;
              public FIFOEntry(E entry) {
                seqNum = seq.getAndIncrement();
                this.entry = entry;
              }
              public E getEntry() { return entry; }
              public int compareTo(FIFOEntry<E> other) {
                int res = entry.compareTo(other.entry);
                if (res == 0 && other.entry != this.entry)
                  res = (seqNum < other.seqNum ? -1 : 1);
                return res;
              }
            }}

此类是 Java Collections Framework 的成员。

在 1.5 中添加。

适用于 . 的 java.util.concurrent.PriorityBlockingQueueJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

构造函数

名称	说明
PriorityBlockingQueue()	创建具有默认初始容量（11）的一个 `PriorityBlockingQueue` ，该容量根据其可比自然排序对元素进行排序。
PriorityBlockingQueue(ICollection)	创建一个 `PriorityBlockingQueue` 包含指定集合中的元素。
PriorityBlockingQueue(Int32, IComparator)	使用指定的初始容量创建一个 `PriorityBlockingQueue` ，该容量根据指定的比较器对元素进行排序。
PriorityBlockingQueue(Int32)	创建一个 `PriorityBlockingQueue` 具有指定的初始容量，该容量根据元素的“可比自然排序”对元素进行排序。
PriorityBlockingQueue(IntPtr, JniHandleOwnership)	创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

属性

名称	说明
Class	返回此 `Object`的运行时类。 (继承自 Object)
Handle	基础 Android 实例的句柄。 (继承自 Object)
IsEmpty	要添加 (继承自 AbstractCollection)
JniIdentityHashCode	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
JniPeerMembers	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
PeerReference	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
ThresholdClass	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。
ThresholdType	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。

方法

名称	说明
Add(Object)	要添加 (继承自 AbstractCollection)
AddAll(ICollection)	要添加 (继承自 AbstractCollection)
Clear()	要添加 (继承自 AbstractCollection)
Clone()	创建并返回此对象的副本。 (继承自 Object)
Comparator()	返回用于对此队列中的元素进行排序的比较器，或者 `null` 此队列是否使用其元素的可比较自然顺序。
Contains(Object)	要添加 (继承自 AbstractCollection)
ContainsAll(ICollection)	要添加 (继承自 AbstractCollection)
Dispose()	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
Dispose(Boolean)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
DrainTo(ICollection, Int32)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
DrainTo(ICollection)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
Element()	检索此队列的头，但不删除。 (继承自 AbstractQueue)
Equals(Object)	指示其他对象是否“等于”此对象。 (继承自 Object)
ForEach(IConsumer)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
GetHashCode()	返回对象的哈希代码值。 (继承自 Object)
Iterator()	返回此队列中元素的迭代器。
JavaFinalize()	当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object)
Notify()	唤醒正在等待此对象的监视器的单个线程。 (继承自 Object)
NotifyAll()	唤醒正在等待此对象的监视器的所有线程。 (继承自 Object)
Offer(Object, Int64, TimeUnit)	将指定的元素插入到此优先级队列中。
Offer(Object)	将指定的元素插入到此优先级队列中。
Peek()	检索但不删除此队列的头，或返回 `null` 此队列是否为空。
Poll()	检索和删除此队列的头，或返回 `null` 此队列是否为空。
Poll(Int64, TimeUnit)	检索并删除此队列的头，如有必要，等待指定的等待时间，使元素变得可用。
Put(Object)	将指定的元素插入到此优先级队列中。
RemainingCapacity()	始终返回， `Integer.MAX_VALUE` 因为容量 `PriorityBlockingQueue` 不受限制。
Remove()	检索并删除此队列的头。 (继承自 AbstractQueue)
Remove(Object)	要添加 (继承自 AbstractCollection)
RemoveAll(ICollection)	要添加 (继承自 AbstractCollection)
RemoveIf(IPredicate)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
RetainAll(ICollection)	要添加 (继承自 AbstractCollection)
SetHandle(IntPtr, JniHandleOwnership)	设置 Handle 属性。 (继承自 Object)
Size()	返回包含 `Collection` 的对象数的计数。
Spliterator()	返回 `Spliterator` 此队列中的元素。
Take()	检索并删除此队列的头，如有必要，请等待元素可用。
ToArray()	要添加 (继承自 AbstractCollection)
ToArray(Object[])	要添加 (继承自 AbstractCollection)
ToArray<T>()	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
ToString()	返回对象的字符串表示形式。 (继承自 Object)
UnregisterFromRuntime()	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
Wait()	使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object)
Wait(Int64, Int32)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object)
Wait(Int64)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object)

显式接口实现

名称	说明
IJavaPeerable.Disposed()	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
IJavaPeerable.Finalized()	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
IJavaPeerable.JniManagedPeerState	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。 (继承自 Object)

扩展方法

名称	说明
GetJniTypeName(IJavaPeerable)	获取实例 `self`类型的 JNI 名称。
JavaAs<TResult>(IJavaPeerable)	尝试强制`self`键入`TResult`，检查强制是否在Java端有效。
JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
OfferAsync(IBlockingQueue, Object, Int64, TimeUnit)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
OfferAsync(IBlockingQueue, Object)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
PollAsync(IBlockingQueue, Int64, TimeUnit)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
PutAsync(IBlockingQueue, Object)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
TakeAsync(IBlockingQueue)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
ToEnumerable(IIterable)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
ToEnumerable<T>(IIterable)	未绑定的 BlockingQueue 阻止队列，该队列使用与类 `PriorityQueue` 相同的排序规则并提供阻止检索操作。
TryJavaCast<TResult>(IJavaPeerable, TResult)	尝试强制`self`键入`TResult`，检查强制是否在Java端有效。

适用于