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不重疊。 雖然不同執行緒可能執行不同的執行,但先前執行的效果會 先於 後續執行發生。
雖然此類別繼承自 ThreadPoolExecutor,但部分繼承的調音方法對此並不實用。 特別是因為它作為一個固定大小的池,使用執行 corePoolSize 緒和無界佇列,調整不會 maximumPoolSize 有實質效果。 此外,幾乎從來不建議將 0 設 corePoolSize 為零或使用 allowCoreThreadTimeOut ,因為這可能會讓池子在任務達到執行資格時失去執行緒來處理。
如同 ThreadPoolExecutor,若未另行指定,此類別作為預設執行緒工廠,並Executors#defaultThreadFactory作為ThreadPoolExecutor.AbortPolicy預設拒絕的執行處理器。
延伸說明: 此類別會 ThreadPoolExecutor#execute(Runnable) execute 覆寫 and AbstractExecutorService#submit(Runnable) submit 方法,以產生內部 ScheduledFuture 物件以控制各任務的延遲與排程。 為了保留功能,子類別中對這些方法的後續覆寫必須呼叫超類別版本,這實際上會使額外的任務自訂功能失效。 然而,此類別提供替代的受保護擴充方法decorateTask(對 和 Runnable各一個版本Callable),可用來自訂執行透過 execute、 submit、 schedulescheduleAtFixedRatescheduleWithFixedDelay及 輸入的具體任務類型。 預設情況下,a 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。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| ScheduledThreadPoolExecutor(Int32, IRejectedExecutionHandler) |
建立 |
| ScheduledThreadPoolExecutor(Int32, IThreadFactory, IRejectedExecutionHandler) |
建立 |
| ScheduledThreadPoolExecutor(Int32, IThreadFactory) |
建立 |
| ScheduledThreadPoolExecutor(Int32) |
建立一個與特定核心池大小相同的新 |
| ScheduledThreadPoolExecutor(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
| 名稱 | Description |
|---|---|
| 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 基礎架構,並非直接從你的程式碼中使用。 |
方法
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 |
擴充方法
| 名稱 | Description |
|---|---|
| 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) |
試著強制 |