Pouchdb 简明教程
PouchDB - Adding Attachment
可以使用 PouchDB 中的 putAttachment() 方法将二进制对象附加到文档。
Syntax
以下是如何 putAttachment() 。必须将文档 ID、附件 ID、MIME 类型以及附件传递给此方法。此方法还接受可选的回调函数。
db.putAttachment( docId, attachmentId, attachment, type, [callback] );
我们可用 blob 或 buffer 对象准备附件,其中 blob 用在使用浏览器时,而 buffer 用在与 Node.js 合作时,由于我们在 Node.js 中演示程序,我们使用 buffer 对象来准备文档。
Example
以下是如何在 PouchDB 中使用 putAttachment() 方法,在名为 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'
}
Adding Attachment to an Existing Document
假设在 PouchDB 的 my_database 数据库中有一个文档,其 ID 为“ 002 ”。可以通过将 ID 值更改为 002 来执行 read_doc.js ,以获取其内容,如下所示。
{
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'
}
Adding Attachment to a Remote Document
你甚至可以添加到存储在服务器 (CouchDB) 上的远程数据库中的文档中添加附件。
要执行此操作,您需要传入 CouchDB 中的数据库路径而不是数据库名称,该路径包含要读取的文档。
Example
假设 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
现在,如果你验证该文档,你会发现如以下屏幕截图所示,附件已添加到该文档。