FileLock 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
一個代表檔案區域鎖的標記。
[Android.Runtime.Register("java/nio/channels/FileLock", DoNotGenerateAcw=true)]
public abstract class FileLock : Java.Lang.Object, IDisposable, Java.Lang.IAutoCloseable[<Android.Runtime.Register("java/nio/channels/FileLock", DoNotGenerateAcw=true)>]
type FileLock = class
inherit Object
interface IAutoCloseable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 繼承
- 屬性
- 實作
備註
一個代表檔案區域鎖的標記。
每當透過類別中的 or 方法或類別的 FileChannel#lock(long,long,boolean) lock or FileChannel#tryLock(long,long,boolean) tryLock 方法取得檔案FileChannel鎖時，都會建立一個檔案鎖定物件。AsynchronousFileChannel#lock(long,long,boolean,Object,CompletionHandler) lockAsynchronousFileChannel#tryLock(long,long,boolean) tryLockAsynchronousFileChannel
檔案鎖定物件最初是有效的。 直到透過呼叫#release release方法、關閉用於獲取該方法的通道，或終止 Java 虛擬機（以先發生者為準）解除鎖，該鎖仍有效。 可透過調用鎖 #isValid isValid 的方法來檢驗鎖的有效性。
檔案鎖要麼是 獨佔 的，要麼是 共享的。 共享鎖防止其他同時執行的程式取得重疊的獨佔鎖，但允許它們取得重疊的共享鎖。 專屬鎖防止其他程式取得任一類型的重疊鎖。 一旦解鎖，該鎖對其他程式可能取得的鎖不再有影響。
鎖是獨佔還是共享，可以透過調用其 #isShared isShared 方法來判斷。 部分平台不支援共享鎖，此時共享鎖的請求會自動轉換成專屬鎖的請求。
單一 Java 虛擬機對特定檔案所持有的鎖不會重疊。 此 #overlaps overlaps 方法可用於測試候選鎖範圍是否與現有鎖重疊。
檔案鎖定物件記錄鎖所存放檔案的檔案通道、鎖的類型與有效性，以及鎖定區域的位置與大小。 只有鎖的有效性會隨時間改變;鎖狀態的其他面向都是不變的。
檔案鎖是代表整個 Java 虛擬機器持有的。 它們不適合在同一虛擬機器內控制多個執行緒對檔案的存取。
檔案鎖定物件對於多個並行執行緒來說是安全的。
“pdep”><h2> Platform dependencies </h2>
此檔案鎖定 API 旨在直接對應至底層作業系統的原生鎖定設施。 因此，檔案上所持有的鎖應該對所有有權限存取該檔案的程式都可見，無論這些程式是以何種語言撰寫。
鎖是否真的阻止其他程式存取被鎖定區域的內容，取決於系統，因此未明確說明。 部分系統的原生檔案鎖定功能僅為 諮詢性質，意即程式必須協同遵守已知的鎖定協定，以確保資料完整性。 在其他系統中，原生檔案鎖是 強制性的，意即如果一個程式鎖定了檔案的某個區域，其他程式實際上會被阻止以違反該鎖的方式存取該區域。 在其他系統中，無論是原生檔案鎖是建議性還是強制性，都可以依檔案設定。 為確保跨平台行為一致且正確，強烈建議將此 API 提供的鎖視為諮詢鎖使用。
在某些系統中，強制鎖定檔案區域會防止該區域成為 java.nio.channels.FileChannel#map <i>mapped into memory</i>，反之亦然。 結合鎖定與映射的程式應準備好這種組合失敗的可能。
在某些系統中，關閉通道會釋放 Java 虛擬機在底層檔案中持有的所有鎖，無論這些鎖是透過該通道取得，還是同一檔案中另一個開啟的通道。 強烈建議在程式中使用獨特通道來取得任何檔案的所有鎖。
有些網路檔案系統只允許在記憶體映射檔案的區域頁面對齊且為底層硬體頁面大小整倍數時使用檔案鎖定。 有些網路檔案系統不會對超出某個位置的區域實施檔案鎖定，通常是 2<sup>30</sup> 或 2<sup>31</sup>。 一般來說，鎖定位於網路檔案系統上的檔案時應非常謹慎。
在 1.4 版本加入。
Java 文件 java.nio.channels.FileLock。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| FileLock(AsynchronousFileChannel, Int64, Int64, Boolean) |
初始化此類別的新實例。 |
| FileLock(FileChannel, Int64, Int64, Boolean) |
初始化此類別的新實例。 |
| FileLock(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsShared |
顯示此鎖是否共用。 |
| IsValid |
表示此鎖是否為有效的檔案鎖。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| JniPeerMembers |
一個代表檔案區域鎖的標記。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| AcquiredBy() |
回傳該鎖所取得檔案的通道。 |
| Channel() |
回傳該鎖所取得檔案的檔案通道。 |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Close() |
此方法即引用該 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| Equals(Object) |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Overlaps(Int64, Int64) |
判斷該鎖是否與指定鎖範圍重疊。 |
| Position() |
回傳鎖定區域第一個位元組在檔案中的位置。 |
| Release() |
解鎖這個鎖。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| Size() |
回傳鎖定區域的大小（以位元組為單位）。 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳一個描述此鎖範圍、類型及有效性的字串。 |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
一個代表檔案區域鎖的標記。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
一個代表檔案區域鎖的標記。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
一個代表檔案區域鎖的標記。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |