Pouchdb-adding-attachment

提供:Dev Guides
移動先:案内検索

PouchDB-添付ファイルの追加

PouchDBの* putAttachment()*メソッドを使用して、バイナリオブジェクトをドキュメントに添付できます。

構文

  • putAttachment()*の構文は次のとおりです。 このメソッドには、ドキュメントID、添付ファイルID、MIMEタイプを添付ファイルとともに渡す必要があります。 このメソッドは、オプションのコールバック関数も受け入れます。
db.putAttachment( docId, attachmentId, attachment, type, [callback] );

ブロブまたはバッファーオブジェクトを使用して添付ファイルを準備できます。ブラウザーでの作業中に blob を使用し、 Node.js での作業中に buffer を使用します。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 finddevguides'], {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'
}

既存のドキュメントへの添付ファイルの追加

IDが「 002 」の my_database PouchDBという名前のデータベースにドキュメントがあるとします。 以下に示すように、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 finddevguides'], {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/indexl を使用してCouchDB内のデータベースのリストを確認すると、次のスクリーンショットが表示されます。

リモートドキュメントへの添付ファイルの追加

また、 my_database という名前のデータベースを選択すると、次のようにその内容を表示できます。

添付ファイルの追加

以下は、CouchDBサーバーに保存されている my_database という名前のデータベースに保存されているドキュメント 001 に添付ファイルを追加する例です。

//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 finddevguides'], {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

これで、ドキュメントを検証すると、次のスクリーンショットに示すように、追加された添付ファイルを確認できます。

添付ファイル検証の追加