A API Blobstore permite que a sua aplicação publique objetos de dados, denominados blobs,que são muito maiores do que o tamanho permitido para objetos no serviço Datastore. Os blobs são úteis para publicar ficheiros grandes, como ficheiros de vídeo ou de imagem, e para permitir que os utilizadores carreguem ficheiros de dados grandes. Os blobs são criados carregando um ficheiro através de um pedido HTTP. Normalmente, as suas aplicações fazem isto apresentando um formulário com um campo de carregamento de ficheiros ao utilizador. Quando o formulário é enviado, o Blobstore cria um blob a partir do conteúdo do ficheiro e devolve uma referência opaca ao blob, denominada chave do blob,que pode usar posteriormente para publicar o blob. A aplicação pode publicar o valor do objeto BLOB completo em resposta a um pedido do utilizador ou pode ler o valor diretamente através de uma interface de streaming semelhante a um ficheiro.
Apresentamos o Blobstore
O App Engine inclui o serviço Blobstore, que permite que as aplicações disponibilizem objetos de dados limitados apenas pela quantidade de dados que podem ser carregados ou transferidos através de uma única ligação HTTP. Estes objetos são denominados valores Blobstore ou blobs.
Os valores do Blobstore são publicados como respostas dos controladores de pedidos e são criados como carregamentos através de formulários Web. As aplicações não criam dados de objetos binários grandes diretamente. Em vez disso, os objetos binários grandes são criados indiretamente por um formulário Web enviado ou outro pedido HTTP POST.
Os valores do Blobstore podem ser publicados para o utilizador ou acedidos pela aplicação numa stream semelhante a um ficheiro, através da API Blobstore.
Para pedir a um utilizador que carregue um valor do Blobstore, a sua aplicação apresenta um formulário Web com um campo de carregamento de ficheiros. A aplicação gera o URL de ação do formulário chamando a API Blobstore. O navegador do utilizador carrega o ficheiro diretamente para o Blobstore através do URL gerado. Em seguida, o Blobstore armazena o blob, reescreve o pedido para conter a chave do blob e transmite-o a um caminho na sua aplicação. Um controlador de pedidos nesse caminho na sua aplicação pode realizar o processamento adicional de formulários.
Para publicar um objeto BLOB, a sua aplicação define um cabeçalho na resposta de saída e o App Engine substitui a resposta pelo valor do objeto BLOB.
Não é possível modificar os blobs depois de criados, embora seja possível eliminá-los. Cada blob tem um registo de informações do blob correspondente, armazenado no arquivo de dados, que fornece detalhes sobre o blob, como a hora de criação e o tipo de conteúdo. Pode usar a chave do blob para obter registos de informações de blobs e consultar as respetivas propriedades.
Usar o Blobstore
As aplicações podem usar o Blobstore para aceitar ficheiros grandes como carregamentos de utilizadores e para publicar esses ficheiros. Os ficheiros são denominados blobs assim que são carregados. As aplicações não acedem diretamente aos blobsEm vez disso, as aplicações funcionam com blobs através de entidades de informações de blobs (representadas pela classe ) no Datastore.
O utilizador cria um objeto BLOB enviando um formulário HTML que inclui um ou mais campos de entrada de ficheiros. A sua aplicação conjuntos como o destino (ação) deste formulário, transmitindo a função um caminho de URL de um controlador na sua aplicação. Quando o utilizador envia o formulário, o navegador do utilizador carrega os ficheiros especificados diretamente para o Blobstore. O Blobstore reescreve o pedido do utilizador e armazena os dados do ficheiro carregado, substituindo os dados do ficheiro carregado por uma ou mais chaves de blob correspondentes. Em seguida, transmite o pedido reescrito ao controlador no caminho do URL que forneceu a .
Este controlador pode fazer processamento adicional com base na chave do objeto binário grande.
A aplicação pode ler partes de um valor do Blobstore através de uma interface de streaming semelhante a um ficheiro.
Carregar um blob
Para criar e carregar um blob, siga este procedimento:
1. Crie um URL de carregamento
Chame
para criar um URL de carregamento para o formulário que o utilizador vai preencher,
transmitindo o caminho da aplicação a carregar quando o POST do formulário estiver concluído.
Existe uma versão assíncrona, create_upload_url_async(). Permite que o código da sua aplicação continue a ser executado enquanto o Blobstore gera o URL de carregamento.
2. Crie um formulário de carregamento
O formulário tem de incluir um campo de carregamento de ficheiros e o enctype do formulário tem de estar definido como
multipart/form-data. Quando o utilizador envia o formulário, o POST é processado pela API Blobstore, que cria o blob. A API também cria um registo de informações para o blob e armazena o registo no Datastore, e transmite o pedido reescrito à sua aplicação no caminho indicado como uma chave de blob.
Não pode usar um Application Load Balancer externo global com um NEG sem servidor para processar pedidos de carregamento enviados para o URL /_ah/upload/
devolvido pela chamada blobstore.create_upload_url.
Em alternativa, tem de encaminhar esses pedidos de carregamento diretamente para o serviço do App Engine. Pode fazê-lo através do domínio appspot.com ou de um domínio personalizado mapeado diretamente para o serviço do App Engine.
3. Implemente o controlador de carregamento
Neste controlador, pode armazenar a chave do objeto BLOB com o resto do modelo de dados da sua aplicação. A própria chave do blob permanece acessível a partir da entidade de informações do blob no Datastore. Tenha em atenção que, depois de o utilizador enviar o formulário e o seu controlador ser chamado, o objeto BLOB já foi guardado e as informações do objeto BLOB foram adicionadas ao Datastore. Se a sua aplicação não quiser manter o blob, deve eliminá-lo imediatamente para evitar que fique órfão.
Para todas as apps Flask, todas as chamadas feitas a métodos na classeBlobstoreUploadHandler
requerem o request.environ dictionary (pedido a ser importado do módulo flask). Se a sua app for uma app WSGI sem uma framework Web, usa o parâmetro environ no método get_uploads().
Ao reescrever o pedido do utilizador, o Blobstore esvazia as partes MIME dos ficheiros carregados e adiciona a chave do blob como um cabeçalho de parte MIME. O Blobstore
preserva todos os outros campos e partes do formulário, transmitindo-os ao controlador de carregamento.
Se não especificar um tipo de conteúdo, o Blobstore tenta inferi-lo a partir da extensão do ficheiro. Se não conseguir determinar um tipo de conteúdo, atribui o tipo de conteúdo application/octet-stream ao blob recém-criado.
Publicar um blob
Para publicar blobs, tem de incluir um controlador de transferência de blobs como um caminho na sua aplicação.
blobstore.Send.