BlobStoreManager Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

BlobStoreManager

Attribute

RegisterAttribute

Hinweise

Diese Klasse bietet Zugriff auf den vom System verwalteten BLOB-Speicher.

Apps können ein Datenblob mithilfe eines BlobHandle Objekts veröffentlichen und darauf zugreifen, das mit BlobHandle#createWithSha256(byte[], CharSequence, long, String)einem Objekt erstellt werden kann. Dieses BlobHandle Objekt kapselt die folgenden Informationen, die zum Identifizieren der Blobs verwendet werden: <ul><li>BlobHandle#getSha256Digest()<li li>BlobHandle#getLabel()<li>BlobHandle#getExpiryTimeMillis()<>BlobHandle#getTag()</ul> Für zwei BlobHandle Objekte, die als identisch betrachtet werden sollen, müssen alle diese Informationen gleich sein.

Zum Beitragen eines neuen Daten-Blobs muss eine App eine Sitzung mithilfe BlobStoreManager#createSession(BlobHandle) erstellen und diese Sitzung dann zum Schreiben mithilfe BlobStoreManager#openSession(long)öffnen.

Der folgende Codeausschnitt zeigt, wie Sie eine Sitzung zum Schreiben erstellen und öffnen:

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);
                    }
                }

Wenn alle Daten nicht in einem einzigen Versuch geschrieben werden konnten, können Apps diese Sitzung schließen und erneut öffnen, indem die sitzungs-ID verwendet wird, die über BlobStoreManager#createSession(BlobHandle). Beachten Sie, dass die Sitzungsdaten beibehalten und erneut geöffnet werden können, um den Datenbeitrag abzuschließen, auch über Geräteneustarts hinweg.

Nachdem die Daten in die Sitzung geschrieben wurden, kann sie mithilfe Session#commit(Executor, Consumer)von Commits übernommen werden. Bis zum Commit der Sitzung werden daten, die in die Sitzung geschrieben wurden, nicht für jede App freigegeben.

Sobald eine Sitzung mithilfe Session#commit(Executor, Consumer)eines Commits zugesichert wurde, werden alle im Rahmen dieser Sitzung geschriebenen Daten versiegelt und können nicht mehr geändert werden.

Vor dem Commit für die Sitzung können Apps angeben, welche Apps über einen oder mehrere der folgenden Zugriffsmodi auf die beigetragenen Daten zugreifen dürfen: <ul><li>Session#allowPackageAccess(String, byte[]) , wodurch bestimmte Pakete auf die Blobs zugreifen können. <li>Session#allowSameSignatureAccess() , die nur Apps zulassen, die mit demselben Zertifikat signiert sind wie die App, die zum Zugriff auf das Blob beigetragen hat. <li>Session#allowPublicAccess() , mit dem jede App auf dem Gerät auf das Blob zugreifen kann. </ul>

Der folgende Codeausschnitt zeigt, wie Sie den Zugriffsmodus angeben und die Sitzung übernehmen:

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);
                }

Apps, die mindestens eine der vom Herausgeber des Datenblobs angegebenen Zugriffsmoduseinschränkungen erfüllen, können darauf zugreifen.

Ein daten-BLOB, das ohne Angabe dieser Zugriffsmodi veröffentlicht wird, wird als privat betrachtet, und nur die App, die zum Daten-BLOB beigetragen hat, kann darauf zugreifen. Dies ist weiterhin nützlich für die allgemeine Gerätesystemintegrität, da das System versuchen kann, eine Kopie des Daten-BLOB auf dem Datenträger beizubehalten, wenn mehrere Apps dieselben Daten beitragen.

Es wird dringend empfohlen, dass Apps eine von Session#allowPackageAccess(String, byte[]) oder Session#allowSameSignatureAccess() wenn sie wissen, vorab die Gruppe der Apps, für die sie die Blobs freigeben möchten, verwenden. Session#allowPublicAccess() ist für öffentlich verfügbare Daten vorgesehen, die aus Bibliotheken und SDKs zugesichert werden.

Sobald ein Daten-BLOB zugesichert Session#commit(Executor, Consumer)wurde, kann darauf zugegriffen BlobStoreManager#openBlob(BlobHandle)werden, vorausgesetzt, der Aufrufer erfüllt Einschränkungen eines der Zugriffsmodi, die diesem Daten-BLOB zugeordnet sind. Eine App kann eine Lease für ein Blob erwerben BlobStoreManager#acquireLease(BlobHandle, int) und die Lease freigeben mit BlobStoreManager#releaseLease(BlobHandle). Ein Blob wird nicht aus dem System gelöscht, während es mindestens eine App leasingt.

Der folgende Codeausschnitt zeigt, wie Sie auf das Daten-BLOB zugreifen:

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

Java Dokumentation für android.app.blob.BlobStoreManager.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.