BlobStoreManager Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

BlobStoreManager

Attributi

RegisterAttribute

Commenti

Questa classe fornisce l'accesso all'archivio BLOB gestito dal sistema.

Le app possono pubblicare e accedere a un BLOB di dati usando un BlobHandle oggetto che può essere creato con BlobHandle#createWithSha256(byte[], CharSequence, long, String). Questo BlobHandle oggetto incapsula le informazioni seguenti usate per identificare i BLOB: <ul><li>BlobHandle#getSha256Digest()<li li>BlobHandle#getLabel()<>BlobHandle#getExpiryTimeMillis()<>BlobHandle#getTag()</ul> Per considerare identici due BlobHandle oggetti, tutte queste informazioni devono essere uguali.

Per contribuire a un nuovo BLOB di dati, un'app deve creare una sessione usando BlobStoreManager#createSession(BlobHandle) e quindi aprire questa sessione per la scrittura usando BlobStoreManager#openSession(long).

Il frammento di codice seguente illustra come creare e aprire una sessione per la scrittura:

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

Se non è stato possibile scrivere tutti i dati in un singolo tentativo, le app possono chiudere questa sessione e riaprirla usando l'ID sessione ottenuto tramite BlobStoreManager#createSession(BlobHandle). Si noti che i dati della sessione sono persistenti e possono essere riaperti per completare il contributo ai dati, anche durante i riavvii del dispositivo.

Dopo aver scritto i dati nella sessione, è possibile eseguirne il commit tramite Session#commit(Executor, Consumer). Finché non viene eseguito il commit della sessione, i dati scritti nella sessione non verranno condivisi con alcuna app.

Una volta eseguito il commit di una sessione usando Session#commit(Executor, Consumer), tutti i dati scritti come parte di questa sessione sono sealed e non possono più essere modificati.

Prima di eseguire il commit della sessione, le app possono indicare quali app possono accedere ai dati forniti usando una o più delle modalità di accesso seguenti: <ul><li>Session#allowPackageAccess(String, byte[]) che consentirà a pacchetti specifici di accedere ai BLOB. <li>Session#allowSameSignatureAccess() che consentirà solo le app firmate con lo stesso certificato dell'app che ha contribuito all'accesso al BLOB. <li>Session#allowPublicAccess() che consentirà a qualsiasi app nel dispositivo di accedere al BLOB. </ul>

Il frammento di codice seguente illustra come specificare la modalità di accesso ed eseguire il commit della sessione:

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

Le app che soddisfano almeno uno dei vincoli di modalità di accesso specificati dall'editore del BLOB di dati potranno accedervi.

Un BLOB di dati pubblicato senza specificare una di queste modalità di accesso verrà considerato privato e solo l'app che ha contribuito al BLOB di dati potrà accedervi. Ciò è ancora utile per l'integrità complessiva del sistema del dispositivo perché il sistema può provare a mantenere una copia del BLOB di dati su disco quando più app contribuiscono agli stessi dati.

È consigliabile che le app usino uno o Session#allowPackageAccess(String, byte[])Session#allowSameSignatureAccess() quando conoscono, in anticipo, il set di app con cui vogliono condividere i BLOB. Session#allowPublicAccess() è progettato per i dati di cui è stato eseguito il commit pubblicamente dalle librerie e dagli SDK.

Una volta eseguito il commit di un BLOB di dati con Session#commit(Executor, Consumer), è possibile accedervi usando BlobStoreManager#openBlob(BlobHandle), presupponendo che il chiamante soddisfi i vincoli di qualsiasi modalità di accesso associata a tale BLOB di dati. Un'app può acquisire un lease in un BLOB con BlobStoreManager#acquireLease(BlobHandle, int) e rilasciare il lease con BlobStoreManager#releaseLease(BlobHandle). Un BLOB non verrà eliminato dal sistema mentre è presente almeno un lease dell'app.

Il frammento di codice seguente illustra come accedere al BLOB di dati:

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

per android.app.blob.BlobStoreManager.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.