BlobStoreManager 類別

定義

[Android.Runtime.Register("android/app/blob/BlobStoreManager", ApiSince=30, DoNotGenerateAcw=true)]
public class BlobStoreManager : Java.Lang.Object

[<Android.Runtime.Register("android/app/blob/BlobStoreManager", ApiSince=30, DoNotGenerateAcw=true)>]
type BlobStoreManager = class
    inherit Object

繼承

Object

JavaObject

Object

BlobStoreManager

屬性

RegisterAttribute

備註

此類別提供系統管理的 blob 儲存庫存取權限。

應用程式可以使用一個物件發佈並存取資料塊 BlobHandle ，該物件可用 BlobHandle#createWithSha256(byte[], CharSequence, long, String)建立。 此BlobHandle物件封裝了以下用於識別斑點的資訊：<ul><li>BlobHandle#getSha256Digest()<li li>BlobHandle#getLabel()<>BlobHandle#getExpiryTimeMillis()<li>BlobHandle#getTag()</ul> 兩個物件若被視為BlobHandle相同，所有這些資訊必須相等。

若要貢獻新的資料塊，應用程式需要先建立一個會BlobStoreManager#createSession(BlobHandle)話，然後開啟這個會話以撰寫。BlobStoreManager#openSession(long)

以下程式碼片段展示了如何建立並開啟寫作會話：

final long sessionId = blobStoreManager.createSession(blobHandle);
                try (BlobStoreManager.Session session = blobStoreManager.openSession(sessionId)) {
                    try (OutputStream out = new ParcelFileDescriptor.AutoCloseOutputStream(
                            session.openWrite(offsetBytes, lengthBytes))) {
                        writeData(out);
                    }
                }

若無法一次寫入所有資料，應用程式可關閉此會話，並利用透過 BlobStoreManager#createSession(BlobHandle)取得的會話 ID 重新開啟。 請注意，會話資料會被持久化，且可重新開啟以完成資料貢獻，即使是跨裝置重啟。

資料寫入會話後，可使用 Session#commit(Executor, Consumer)。 在工作階段提交之前，寫入該工作階段的資料不會與任何應用程式共享。

一旦以 承諾 Session#commit(Executor, Consumer)的會話，任何作為該會話一部分的資料都會被封存，且無法再修改。

在提交會話前，應用程式可透過以下一種或多種存取模式 <顯示哪些應用程式可存取貢獻資料：ul><li>Session#allowPackageAccess(String, byte[]) ，允許特定套件存取 blobs。 < > Session#allowSameSignatureAccess() LI 只能允許用與貢獻 BLOB 的應用程式相同的憑證簽署的應用程式存取。 < > Session#allowPublicAccess() LI 可以讓裝置上的任何應用程式都能存取 Blob。 </ul>

以下程式碼片段說明如何指定存取模式並提交會話：

try (BlobStoreManager.Session session = blobStoreManager.openSession(sessionId)) {
                    try (OutputStream out = new ParcelFileDescriptor.AutoCloseOutputStream(
                            session.openWrite(offsetBytes, lengthBytes))) {
                        writeData(out);
                    }
                    session.allowSameSignatureAccess();
                    session.allowPackageAccess(packageName, certificate);
                    session.commit(executor, callback);
                }

滿足資料塊發布者所指定至少一項存取模式限制的應用程式，將能夠存取該資料。

未指定任何存取模式的資料塊將被視為私有，只有貢獻資料塊的應用程式才被允許存取。 這對整體裝置系統健康仍有用處，因為系統可以嘗試在多個應用程式貢獻相同資料時，將一份資料塊保留在磁碟上。

強烈建議應用程式事先知道 Session#allowPackageAccess(String, byte[]) 想要分享 blob 的應用程式組合之一或 Session#allowSameSignatureAccess() 一組。 Session#allowPublicAccess() 是為從函式庫和 SDK 提交的公開資料所設計的。

一旦資料塊被 提交， Session#commit(Executor, Consumer)即可使用 BlobStoreManager#openBlob(BlobHandle)，假設呼叫者滿足該資料塊所屬任意存取模式的限制。 應用程式可以取得一個 blob BlobStoreManager#acquireLease(BlobHandle, int) 的租約，並以 釋放該租約。BlobStoreManager#releaseLease(BlobHandle) 只要至少有一個應用程式在租用，blob 不會從系統中刪除。

以下程式碼片段展示了如何存取資料塊：

try (InputStream in = new ParcelFileDescriptor.AutoCloseInputStream(
                        blobStoreManager.openBlob(blobHandle)) {
                    useData(in);
                }

Java 文件 android.app.blob.BlobStoreManager。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。