BlobStoreManager Clase

Definición

[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

Herencia

Object

JavaObject

Object

BlobStoreManager

Atributos

RegisterAttribute

Comentarios

Esta clase proporciona acceso al almacén de blobs administrado por el sistema.

Las aplicaciones pueden publicar y acceder a un blob de datos mediante un BlobHandle objeto que se puede crear con BlobHandle#createWithSha256(byte[], CharSequence, long, String). Este BlobHandle objeto encapsula los siguientes fragmentos de información utilizados para identificar los blobs: <ul><li li>BlobHandle#getSha256Digest()<>BlobHandle#getLabel()<>BlobHandle#getExpiryTimeMillis()<>BlobHandle#getTag()</ul> Para que dos BlobHandle objetos se consideren idénticos, todos estos fragmentos de información deben ser iguales.

Para contribuir a un nuevo blob de datos, una aplicación debe crear una sesión mediante BlobStoreManager#createSession(BlobHandle) y, a continuación, abrir esta sesión para escribir mediante BlobStoreManager#openSession(long).

El siguiente fragmento de código muestra cómo crear y abrir una sesión para escribir:

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

Si no se pudieron escribir todos los datos en un único intento, las aplicaciones pueden cerrar esta sesión y volver a abrirlos con el identificador de sesión obtenido a través BlobStoreManager#createSession(BlobHandle)de . Tenga en cuenta que los datos de sesión se conservan y se pueden volver a abrir para completar la contribución de datos, incluso en los reinicios del dispositivo.

Después de escribir los datos en la sesión, se puede confirmar mediante Session#commit(Executor, Consumer). Hasta que se confirme la sesión, los datos escritos en la sesión no se compartirán con ninguna aplicación.

Una vez confirmada una sesión mediante Session#commit(Executor, Consumer), los datos escritos como parte de esta sesión están sellados y ya no se pueden modificar.

Antes de confirmar la sesión, las aplicaciones pueden indicar qué aplicaciones pueden acceder a los datos aportados mediante uno o varios de los siguientes modos de acceso: <ul><li>Session#allowPackageAccess(String, byte[]) , lo que permitirá que paquetes específicos accedan a los blobs. <li>Session#allowSameSignatureAccess() , que solo permitirá que las aplicaciones firmadas con el mismo certificado que la aplicación que contribuyó al blob para acceder a él. <li>Session#allowPublicAccess() , que permitirá que cualquier aplicación del dispositivo acceda al blob. </ul>

El siguiente fragmento de código muestra cómo especificar el modo de acceso y confirmar la sesión:

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

Las aplicaciones que cumplen al menos una de las restricciones de modo de acceso especificadas por el publicador del blob de datos podrán acceder a ella.

Un blob de datos publicado sin especificar ninguno de estos modos de acceso se considerará privado y solo la aplicación que contribuyó al blob de datos podrá acceder a él. Esto sigue siendo útil para el estado general del sistema del dispositivo, ya que el sistema puede intentar mantener una copia del blob de datos en el disco cuando varias aplicaciones contribuyen a los mismos datos.

Se recomienda encarecidamente que las aplicaciones usen uno de Session#allowPackageAccess(String, byte[]) o Session#allowSameSignatureAccess() cuando sepan, con antelación, el conjunto de aplicaciones con las que desea compartir los blobs. Session#allowPublicAccess() está diseñado para datos disponibles públicamente confirmados desde bibliotecas y SDK.

Una vez que se confirma un blob de datos con Session#commit(Executor, Consumer), se puede acceder a él mediante BlobStoreManager#openBlob(BlobHandle), suponiendo que el llamador satisface las restricciones de cualquiera de los modos de acceso asociados a ese blob de datos. Una aplicación puede adquirir una concesión en un blob con BlobStoreManager#acquireLease(BlobHandle, int) y liberar la concesión con BlobStoreManager#releaseLease(BlobHandle). Un blob no se eliminará del sistema mientras haya al menos una aplicación que lo arrenda.

En el fragmento de código siguiente se muestra cómo acceder al blob de datos:

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

Java documentación para android.app.blob.BlobStoreManager.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.