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) オブジェクトを使用して、データ BLOB を発行およびアクセスできます。 この BlobHandle オブジェクトは、BLOB の識別に使用される次の情報をカプセル化します。 <ul><li>BlobHandle#getSha256Digest()<li>BlobHandle#getLabel()<li>BlobHandle#getExpiryTimeMillis()<li>BlobHandle#getTag()</ul> 2 つの BlobHandle オブジェクトが同一と見なされるためには、これらすべての情報が等しい必要があります。

新しいデータ BLOB を提供するには、アプリで 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);
                    }
                }

すべてのデータを 1 回の試行で書き込むことができなかった場合、アプリはこのセッションを閉じて、 BlobStoreManager#createSession(BlobHandle)で取得したセッション ID を使用して再度開くことができます。 セッション データは永続化され、デバイスの再起動後でもデータの貢献を完了するために再び開くことができることに注意してください。

データはセッションに書き込まれた後、 Session#commit(Executor, Consumer)を使用してコミットできます。 セッションがコミットされるまで、セッションに書き込まれたデータはアプリと共有されません。

Session#commit(Executor, Consumer)を使用してセッションがコミットされると、このセッションの一部として書き込まれたデータはシールされ、変更できなくなります。

セッションをコミットする前に、1 つ以上のアクセス モード ( <ul><li>Session#allowPackageAccess(String, byte[]) を使用して、投稿されたデータへのアクセスを許可するアプリを指定できます。これにより、特定のパッケージが BLOB にアクセスできるようになります。 <li>Session#allowSameSignatureAccess() BLOB へのアクセスを提供したアプリと同じ証明書で署名されたアプリのみを許可します。 <li>Session#allowPublicAccess() デバイス上の任意のアプリが 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);
                }

データ BLOB の発行元によって指定されたアクセス モード制約の少なくとも 1 つを満たすアプリは、アクセスできます。

これらのアクセス モードを指定せずに発行されたデータ BLOB はプライベートと見なされ、データ BLOB を提供したアプリのみがアクセスを許可されます。 これは、複数のアプリが同じデータを提供する場合に、システムがデータ BLOB の 1 つのコピーをディスク上に保持しようとできるため、デバイスシステムの全体的な正常性に引き続き役立ちます。

事前に BLOB を共有するアプリのセットがわかっている場合は、 Session#allowPackageAccess(String, byte[]) または Session#allowSameSignatureAccess() のいずれかを使用することを強くお勧めします。 Session#allowPublicAccess() は、ライブラリと SDK からコミットされた一般に利用可能なデータを対象とします。

データ BLOB が Session#commit(Executor, Consumer) でコミットされると、呼び出し元がそのデータ BLOB に関連付けられているいずれかのアクセス モードの制約を満たしていると仮定して、 BlobStoreManager#openBlob(BlobHandle)を使用してアクセスできます。 アプリは、 BlobStoreManager#acquireLease(BlobHandle, int) を使用して BLOB のリースを取得し、 BlobStoreManager#releaseLease(BlobHandle)を使用してリースを解放できます。 少なくとも 1 つのアプリがリースされている間、BLOB はシステムから削除されません。

次のコード スニペットは、データ BLOB にアクセスする方法を示しています。

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

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。