ScheduledThreadPoolExecutor 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
可以 ThreadPoolExecutor 额外计划命令,以在给定的延迟后运行,或定期执行。
[Android.Runtime.Register("java/util/concurrent/ScheduledThreadPoolExecutor", DoNotGenerateAcw=true)]
public class ScheduledThreadPoolExecutor : Java.Util.Concurrent.ThreadPoolExecutor, IDisposable, Java.Util.Concurrent.IScheduledExecutorService
[<Android.Runtime.Register("java/util/concurrent/ScheduledThreadPoolExecutor", DoNotGenerateAcw=true)>]
type ScheduledThreadPoolExecutor = class
inherit ThreadPoolExecutor
interface IScheduledExecutorService
interface IExecutorService
interface IExecutor
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 继承
- 特性
- 实现
注解
可以 ThreadPoolExecutor 额外计划命令,以在给定的延迟后运行,或定期执行。 此类最好是 java.util.Timer 需要多个工作线程,或者当需要额外灵活性或功能 ThreadPoolExecutor (此类扩展)时。
延迟的任务的执行时间不会早于启用,但不会有任何实时保证,即启用后,它们将启动。 在提交的第一次出(FIFO)顺序中启用了完全相同的执行时间计划的任务。
在运行提交的任务之前取消时,将取消执行。 默认情况下,此类取消的任务不会自动从工作队列中删除,直到其延迟过后。 虽然这可以实现进一步的检查和监视,但它也可能导致取消任务的无限保留。
通过 #scheduleAtFixedRate scheduleAtFixedRate 计划或 #scheduleWithFixedDelay scheduleWithFixedDelay 不重叠的定期任务的连续执行。 虽然不同的执行可能由不同的线程执行,但以前的执行<效果发生在之前></i>,而后续执行的效果。
虽然此类继承自 ThreadPoolExecutor,但一些继承的优化方法对它没有用处。 具体而言,因为它充当使用 corePoolSize 线程和未绑定队列的固定大小的池,因此 maximumPoolSize 调整不会产生任何有用的效果。 此外,设置为零或使用corePoolSize几乎从来不是个好主意allowCoreThreadTimeOut,因为这可能会导致池中没有线程来处理任务,一旦它们有资格运行。
与
<b>扩展说明:</b> 此类重写ThreadPoolExecutor#execute(Runnable) executeAbstractExecutorService#submit(Runnable) submit生成内部对象以控制每个任务延迟和计划的方法ScheduledFuture。 若要保留功能,子类中对这些方法的任何进一步重写都必须调用超级类版本,从而有效地禁用其他任务自定义。 但是,此类提供替代的受保护扩展方法decorateTask(每个版本各Runnable有Callable一个版本),可用于自定义用于执行通过execute、submit、schedule和scheduleAtFixedRatescheduleWithFixedDelay输入的命令的具体任务类型。 默认情况下,使用 ScheduledThreadPoolExecutor 任务类型扩展 FutureTask。 但是,可以使用窗体的子类来修改或替换此项:
{@code
public class CustomScheduledExecutor extends ScheduledThreadPoolExecutor {
static class CustomTask<V> implements RunnableScheduledFuture<V> { ... }
protected <V> RunnableScheduledFuture<V> decorateTask(
Runnable r, RunnableScheduledFuture<V> task) {
return new CustomTask<V>(r, task);
}
protected <V> RunnableScheduledFuture<V> decorateTask(
Callable<V> c, RunnableScheduledFuture<V> task) {
return new CustomTask<V>(c, task);
}
// ... add constructors, etc.
}}
在 1.5 中添加。
Java文档java.util.concurrent.ScheduledThreadPoolExecutor。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
| 名称 | 说明 |
|---|---|
| ScheduledThreadPoolExecutor(Int32, IRejectedExecutionHandler) |
|
| ScheduledThreadPoolExecutor(Int32, IThreadFactory, IRejectedExecutionHandler) |
|
| ScheduledThreadPoolExecutor(Int32, IThreadFactory) |
|
| ScheduledThreadPoolExecutor(Int32) |
|
| ScheduledThreadPoolExecutor(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
属性
| 名称 | 说明 |
|---|---|
| ActiveCount |
返回正在主动执行任务的大致线程数。 (继承自 ThreadPoolExecutor) |
| Class |
返回此 |
| CompletedTaskCount |
返回已完成执行的任务的大致总数。 (继承自 ThreadPoolExecutor) |
| ContinueExistingPeriodicTasksAfterShutdownPolicy |
获取有关是否继续执行现有定期任务的策略,即使此执行程序已 |
| CorePoolSize |
返回线程的核心数。 - 或 - 设置线程的核心数。 (继承自 ThreadPoolExecutor) |
| ExecuteExistingDelayedTasksAfterShutdownPolicy |
获取有关是否执行现有延迟任务的策略,即使此执行程序已 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IsShutdown |
获取此执行程序是否已进入关闭状态。 (继承自 ThreadPoolExecutor) |
| IsTerminated |
获取此执行程序是否已达到其终止状态。 (继承自 ThreadPoolExecutor) |
| IsTerminating |
如果此执行程序正在终止或 |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于访问此Java绑定成员的 JNI 元数据。 |
| LargestPoolSize |
返回同时在池中的最大线程数。 (继承自 ThreadPoolExecutor) |
| MaximumPoolSize |
返回允许的最大线程数。 - 或 - 设置允许的最大线程数。 (继承自 ThreadPoolExecutor) |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| PoolSize |
返回池中的当前线程数。 (继承自 ThreadPoolExecutor) |
| Queue |
返回此执行程序使用的任务队列。 (继承自 ThreadPoolExecutor) |
| RejectedExecutionHandler |
返回不可执行任务的当前处理程序。 - 或 - 为不可执行的任务设置新的处理程序。 (继承自 ThreadPoolExecutor) |
| RemoveOnCancelPolicy |
获取取消时是否应立即从工作队列中删除已取消的任务的策略。 - 或 - 设置在取消时是否应立即从工作队列中删除已取消的任务的策略。 |
| TaskCount |
返回已计划执行的任务的大致总数。 (继承自 ThreadPoolExecutor) |
| ThreadFactory |
返回用于创建新线程的线程工厂。 - 或 - 设置用于创建新线程的线程工厂。 (继承自 ThreadPoolExecutor) |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
方法
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 |
扩展方法
| 名称 | 说明 |
|---|---|
| AwaitTerminationAsync(IExecutorService, Int64, TimeUnit) |
通过Task指定的执行程序运行 AwaitTermination(Int64, TimeUnit) 。 |
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| InvokeAnyAsync(IExecutorService, ICollection, Int64, TimeUnit) |
通过Task指定的执行程序运行 InvokeAny(ICollection, Int64, TimeUnit) 。 |
| InvokeAnyAsync(IExecutorService, ICollection) |
通过Task指定的执行程序运行 InvokeAny(ICollection) 。 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |