BlobStoreManager Classe

Definição

[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

Herança

Object

JavaObject

Object

BlobStoreManager

Atributos

RegisterAttribute

Comentários

Essa classe fornece acesso ao repositório de blobs gerenciado pelo sistema.

Os aplicativos podem publicar e acessar um blob de dados usando um BlobHandle objeto que pode ser criado com BlobHandle#createWithSha256(byte[], CharSequence, long, String). Este BlobHandle objeto encapsula as seguintes informações usadas para identificar os blobs: <ul><li>BlobHandle#getSha256Digest()<li>BlobHandle#getLabel()<li li>BlobHandle#getExpiryTimeMillis()<>BlobHandle#getTag()</ul> Para que dois BlobHandle objetos sejam considerados idênticos, todas essas informações devem ser iguais.

Para contribuir com um novo blob de dados, um aplicativo precisa criar uma sessão usando BlobStoreManager#createSession(BlobHandle) e, em seguida, abrir esta sessão para escrever usando BlobStoreManager#openSession(long).

O snippet de código a seguir mostra como criar e abrir uma sessão para escrever:

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 todos os dados não puderem ser gravados em uma única tentativa, os aplicativos poderão fechar essa sessão e abri-los novamente usando a ID da sessão obtida por meio BlobStoreManager#createSession(BlobHandle)de . Observe que os dados da sessão são persistentes e podem ser rea abertos para concluir a contribuição de dados, mesmo entre reinicializações do dispositivo.

Depois que os dados são gravados na sessão, eles podem ser confirmados usando Session#commit(Executor, Consumer). Até que a sessão seja confirmada, os dados gravados na sessão não serão compartilhados com nenhum aplicativo.

Depois que uma sessão é confirmada usando Session#commit(Executor, Consumer), todos os dados gravados como parte desta sessão são lacrados e não podem mais ser modificados.

Antes de confirmar a sessão, os aplicativos podem indicar quais aplicativos têm permissão para acessar os dados contribuidos usando um ou mais dos seguintes modos de acesso: ul<>li<>, Session#allowPackageAccess(String, byte[])que permitirá que pacotes específicos acessem os blobs. <li>Session#allowSameSignatureAccess() , que permitirá apenas aplicativos assinados com o mesmo certificado que o aplicativo que contribuiu com o blob para acessá-lo. <li>Session#allowPublicAccess() , que permitirá que qualquer aplicativo no dispositivo acesse o blob. </ul>

O snippet de código a seguir mostra como especificar o modo de acesso e confirmar a sessão:

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

Os aplicativos que atendem a pelo menos uma das restrições de modo de acesso especificadas pelo editor do blob de dados poderão acessá-lo.

Um blob de dados publicado sem especificar nenhum desses modos de acesso será considerado privado e somente o aplicativo que contribuiu com o blob de dados terá permissão para acessá-lo. Isso ainda é útil para a integridade geral do sistema de dispositivos, pois o Sistema pode tentar manter uma cópia do blob de dados no disco quando vários aplicativos contribuem com os mesmos dados.

É altamente recomendável que os aplicativos usem um ou Session#allowPackageAccess(String, byte[])Session#allowSameSignatureAccess() quando souberem, antecipadamente, o conjunto de aplicativos com os quais eles gostariam de compartilhar os blobs. Session#allowPublicAccess() destina-se a dados publicamente disponíveis confirmados de bibliotecas e SDKs.

Depois que um blob de dados é confirmado, Session#commit(Executor, Consumer)ele pode ser acessado usando BlobStoreManager#openBlob(BlobHandle), supondo que o chamador satisfaça as restrições de qualquer um dos modos de acesso associados a esse blob de dados. Um aplicativo pode adquirir uma concessão em um blob com BlobStoreManager#acquireLease(BlobHandle, int) e liberar a concessão com BlobStoreManager#releaseLease(BlobHandle). Um blob não será excluído do sistema enquanto houver pelo menos um aplicativo alugando-o.

O snippet de código a seguir mostra como acessar o blob de dados:

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

Java documentação para android.app.blob.BlobStoreManager.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.