PouchDB - 添加附件

您可以使用 PouchDB 中的 putAttachment() 方法将二进制对象附加到文档。

语法

以下是 putAttachment() 的语法。 对于此方法，我们必须将文档 id、附件 id、MIME 类型以及附件一起传递。 此方法还接受可选的回调函数。

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

我们可以使用 blob 或 buffer 对象准备附件，其中 blob 在使用浏览器时使用，buffer 在使用 Node.js 时使用，由于我们在 Node.js 中演示我们的程序，因此我们使用缓冲区对象来准备文档。

示例

以下是使用 putAttachment() 方法在 PouchDB 中名为 my_database 的数据库中创建带有附件的文档的示例。

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

将上述代码保存在名为 Add_Attachment.js 的文件中。 打开命令提示符并使用 node 执行 JavaScript 文件，如下所示。

C:\PouchDB_Examples >node Add_Attachment.js

这将在存储在 PouchDB 中的名为 my_database 的数据库中创建一个空文档，添加一个附件，并显示以下消息。

Attachment added successfully

您可以使用以下代码阅读文档来验证附件是否添加。

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

将上述代码保存为read_doc.js并执行。 执行该程序，可以看到该文件的以下内容。

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

向现有文档添加附件

假设数据库中有一个名为 my_database PouchDB 且 ID 为"002"的文档。 您可以通过执行read_doc.js并将id值更改为002来获取其内容，如下所示。

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

现在，您可以使用其 _rev 值向此文档添加附件。

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

将上述代码保存在名为 Add_Attachment_to_doc.js 的文件中。 打开命令提示符并使用 node 执行 JavaScript 文件，如下所示。

C:\PouchDB_Examples >node Add_Attachment_to_doc.js

这会向指定文档添加一个附件，并显示以下消息。

Attachment added successfully

如果将read_doc.js中的id值更改为002并执行它，您将得到以下输出。

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

向远程文档添加附件

您甚至可以向远程存储在服务器 (CouchDB) 上的数据库中现有的文档添加附件。

为此，您需要传递 CouchDB 中数据库的路径，而不是数据库名称，其中包含要读取的文档。

示例

假设 CouchDB 服务器中有一个名为 my_database 的数据库。 然后，如果您使用 URL http://127.0.0.1:5984/_utils/index.html 验证 CouchDB 中的数据库列表，您将获得以下屏幕截图。

如果您选择名为my_database的数据库，您可以查看其内容，如下所示。

以下示例向存储在名为 my_database 的数据库中的文档 001 添加附件，该数据库存储在 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")
   }
});

将上述代码保存在名为 Remote_Add_Attachment.js 的文件中。 打开命令提示符并使用 node 执行 JavaScript 文件，如下所示。

C:\PouchDB_Examples >node Remote_Add_Attachment.js

这会向指定文档添加一个附件，显示以下消息。

Attachment added successfully

现在，如果您验证文档，您可以观察到添加到其中的附件，如以下屏幕截图所示。