PouchDB - Adicionando Anexo

Você pode anexar um objeto binário a um documento usando o putAttachment() método no PouchDB.

Sintaxe

A seguir está a sintaxe do putAttachment(). Para este método, temos que passar a id do documento, id do anexo, tipo MIME junto com o anexo. Este método também aceita uma função de retorno de chamada opcional.

db.putAttachment( docId, attachmentId, attachment, type, [callback] );

Podemos preparar o anexo usando objetos blob ou buffer, onde blob é usado ao trabalhar com o navegador e buffer é usado ao trabalhar com Node.js, já que estamos demonstrando nossos programas em Node.js, usamos objetos buffer para preparar documentos.

Exemplo

A seguir está um exemplo de criação de um documento com anexo, dentro de um banco de dados denominado my_database no PouchDB usando putAttachment() método.

//Requiring the package 
var PouchDB = require('PouchDB');

//Creating the database object var db = new PouchDB('my_database');

//Preparing the attachment 
var my_attachment = new Buffer(['Welcome to tutorialspoint'], {type: 'text/plain'});

//Adding attachment to a document 
db.putAttachment('001', 'att_1.txt', my_attachment, 'text/plain', function(err, res) { 
   if (err) { 
      return console.log(err); 
   } else { 
      console.log(res+"Attachment added successfully") 
   } 
});

Salve o código acima em um arquivo com o nome Add_Attachment.js. Abra o prompt de comando e execute o arquivo JavaScript usandonode como mostrado abaixo.

C:\PouchDB_Examples >node Add_Attachment.js

Isso cria um documento vazio adicionando um anexo a ele, no banco de dados chamado my_database que é armazenado no PouchDB e exibe a seguinte mensagem.

Attachment added successfully

Você pode verificar se o anexo foi adicionado lendo o documento usando o código a seguir.

//Requiring the package 
var PouchDB = require('PouchDB');

//Creating the database object var db = new PouchDB('my_database');

//Reading the Document 
db.get('001',{attachments: true}, function(err, doc) { 
   if (err) { 
      return console.log(err); 
   } else { 
      console.log(doc); 
   } 
});

Salve o código acima como read_doc.jse executá-lo. Executando este programa, você pode ver o seguinte conteúdo do documento.

{ 
   _attachments: { 
      att_1.txt: { 
         content_type: 'text/plain',
         digest: 'md5-k7iFrf4NoInN9jSQT9WfcQ==',
         data: 'AA==' 
      } 
   },
   _id: '001',
   _rev: '1-620fd5f41d3328fcbf9ce7504338a51d' 
}

Adicionar anexo a um documento existente

Suponha que haja um documento em um banco de dados com o nome my_database PouchDB com id '002'. Você pode obter o conteúdo dele executando oread_doc.js alterando o valor de id para 002, como mostrado abaixo.

{ 
   name: 'Raju',
   age: 23,
   designation: 'Designer',
   _id: '002',
   _rev: '1-05ca7b5f3f4762a9fb2d119cd34c8d40' 
}

Agora, você pode adicionar um anexo a este documento usando seu _rev valor.

//Requiring the package 
var PouchDB = require('PouchDB');

//Creating the database object var db = new PouchDB('my_database');

//Adding attachment to existing document 
var my_attachment = new Buffer (['Welcome to tutorialspoint'], {type: 'text/plain'});

rev = '1-05ca7b5f3f4762a9fb2d119cd34c8d40'; 
db.putAttachment('002', 'att_1.txt', rev, my_attachment, 'text/plain', function(err, res) { 
   if (err) { 
      return console.log(err); 
   } else { 
      console.log (res + "Attachment added successfully") 
   } 
});

Salve o código acima em um arquivo com o nome Add_Attachment_to_doc.js. Abra o prompt de comando e execute o arquivo JavaScript usandonode como mostrado abaixo.

C:\PouchDB_Examples >node Add_Attachment_to_doc.js

Isso adiciona um anexo ao documento especificado exibindo a seguinte mensagem.

Attachment added successfully

Se você alterar o valor de id em read_doc.js para 002 e executá-lo, você obterá a seguinte saída.

{ 
   name: 'Raju',
   age: 23,
   designation: 'Designer',
   _attachments: { 
      att_1: { 
         content_type: 'text/plain',
         digest: 'md5-k7iFrf4NoInN9jSQT9WfcQ==',
         data: 'AA==' 
      } 
   },
   _id: '002',
   _rev: '2-3bb4891b954699bce28346723cc7a709' 
}

Adicionar anexo a um documento remoto

Você pode até adicionar um anexo ao documento existente em um banco de dados que é armazenado remotamente no servidor (CouchDB).

Para fazer isso, em vez de um nome de banco de dados, você precisa passar o caminho para o banco de dados no CouchDB, que contém o documento a ser lido.

Exemplo

Suponha que haja um banco de dados chamado my_databaseno servidor CouchDB. Então, se você verificar a lista de bancos de dados no CouchDB usando o URLhttp://127.0.0.1:5984/_utils/index.html você obterá a seguinte captura de tela.

E se você selecionar o banco de dados chamado my_database, você pode visualizar seu conteúdo conforme mostrado abaixo.

A seguir está um exemplo de adição de um anexo ao documento 001 armazenado em um banco de dados chamado my_database que é armazenado no servidor CouchDB.

//Requiring the package
var PouchDB = require('PouchDB');

//Creating the database object
var db = new PouchDB('http://localhost:5984/my_database');

//Adding attachment to existing document
var my_attachment = new Buffer (['Welcome to tutorialspoint'], {type: 'text/plain'});

rev = '1-36c34fdcf29a652876219065f9681602';
db.putAttachment('001', 'att_1.txt',rev, my_attachment, 'text/plain', function(err, res) {
   if (err) {
      return console.log(err);
   } else {
      console.log (res+ "Attachment added successfully")
   }
});

Salve o código acima em um arquivo com o nome Remote_Add_Attachment.js. Abra o prompt de comando e execute o arquivo JavaScript usandonode como mostrado abaixo.

C:\PouchDB_Examples >node Remote_Add_Attachment.js

Isso adiciona um anexo ao documento especificado exibindo a seguinte mensagem.

Attachment added successfully

Agora, se você verificar o documento, poderá observar o anexo adicionado a ele conforme mostrado na imagem a seguir.