Начало работы с клиентской базой данных JavaScript PouchDB

 [ { "ok": true, "id": "easy-a", "rev": "1-84abc2a942007bee7cf55007cba56198" }, { "ok": true, "id": "black-swan", "rev": "1-7b80fc50b6af7a905f368670429a757e" } ] 

Если вы хотите вставить несколько документов, использование массового API, как правило, лучше, чем выполнение нескольких запросов put() . Массовые операции, как правило, выполняются быстрее, чем отдельные операции, поскольку их можно объединить в одну транзакцию (для локального хранилища IndexedDB / WebSQL) или в один HTTP-запрос (для удаленного сервера CouchDB).

Получить несколько документов

Для чтения нескольких документов PouchDB предоставляет метод allDocs() .

 // without {include_docs: true}, only document ids are returned movies .allDocs({include_docs: true}) .then(function (docs) { console.log(docs) }) 

Это быстрый и очень полезный метод. Из документации PouchDB:

allDocs () — это незамеченная звезда мира PouchDB. Он не только возвращает документы по порядку — он также позволяет изменить порядок, отфильтровать по _id, срезы и кости, используя операции «больше» и «меньше» над _id, и многое другое.

По умолчанию документы возвращаются в порядке возрастания _id . Вы можете указать {descending: true} чтобы изменить порядок.

 movies .allDocs({ include_docs: true, descending: true }) .then(...) 

Вы также можете указать параметры startkey и endkey для получения документов в диапазоне. Например, чтобы получить все фильмы, _id начинается с «a» или «b», вы можете выполнить этот запрос:

 movies .allDocs({ include_docs: true, startkey: 'a', endkey: 'c' }) .then(console.log) .catch(console.log) 

Параметры startKey и endKey особенно полезны для разбитых на страницы API.

Go Realtime с ChangeFeeds

Мы говорили о том, как PouchDB использует поле _rev для отслеживания ревизий, причем каждая ревизия указывает на предыдущую ревизию. PouchDB и CouchDB используют эту цепочку изменений для репликации базы данных.

Тем не менее, следствием этого алгоритма репликации является то, что он позволяет вам просматривать историю базы данных, позволяя вам отвечать на такие вопросы, как

• Какие изменения были внесены в базу данных с определенного времени?
• Какие изменения были внесены в конкретный документ?

Это где API changes() входит.

Чтобы получить все изменения с начала времени:

 db.changes({ since: 0, include_docs: true }).then(function (changes) { console.log(changes) }).catch(...) 

Однако в веб-приложении вы, как правило, больше заинтересованы в том, чтобы увидеть изменения в базе данных, которые происходят после начальной загрузки страницы, чтобы вы могли соответствующим образом изменить пользовательский интерфейс. Дуэт PouchDB / CouchDB обеспечил вам доступ к прямой трансляции.

 db .changes({ since: 'now', live: true, include_docs: true }) .on('change', function (change) { // This is where you can modify UI, based on database change. // change.id contains the doc id, change.doc contains the doc if (change.deleted) { // document was deleted } else { // document was added/modified } }) .on('error', function (err) { // handle errors }) 

Итак, если у вас есть, скажем, базовое приложение со списком, вы можете добавить элементы в одно окно, и они будут отображаться в другом окне в режиме реального времени.

Вы можете увидеть демонстрацию этого в действии .

Синхронизация: возьмите данные PouchDB за пределы браузера

Большинству приложений необходимо хранить данные на сервере, а не только в браузере, поэтому вы можете использовать PouchDB для локального сохранения данных, но синхронизировать его с внутренним экземпляром CouchDB, чтобы данные были доступны везде, а не только в этом конкретном браузере.

PouchDB предоставляет очень простой API для этого. Предположим, у вас есть удаленная база данных CouchDB, синхронизирующая ее всего за две строки JavaScript.

 // local database, that lives in the browser's IndexedDB store var localDB = new PouchDB('mylocaldb') // remote CouchDB var remoteDB = new PouchDB('http://localhost:5984/myremotedb') 

Вы можете реплицировать локальные изменения в удаленную БД, написав

 localDB .replicate .to(remoteDB) .on('complete', function () { // local changes replicated to remote }).on('error', function (err) { // error while replicating }) 

Однако, поскольку многие пользователи могут иметь доступ к одной и той же базе данных, более полезно иметь возможность синхронизировать изменения с удаленной БД в браузер. PouchDB поможет вам в этом.

Двунаправленная синхронизация может быть достигнута с помощью одной строки JavaScript:

 // replicates once localDB.sync(remoteDB); 

Или для прямой синхронизации:

 // keeps syncing changes as they occur localDB.sync(remoteDB, {live: true}) 

Следующие шаги

PouchDB также имеет растущую экосистему плагинов и адаптеров фреймворков, в которую нам некуда деться, но обязательно стоит проверить. Кроме того, работая с PouchDB, вы можете использовать расширение PouchDB Inspector chrome, которое предоставляет приятный графический интерфейс для просмотра вашей базы данных.

Вот и все для этого вводного взгляда на PouchDB. Это определенно одна из наиболее интересных баз данных, и я надеюсь, вы сможете увидеть, как вы могли бы использовать ее для создания приложений, работающих в автономном режиме, в режиме реального времени.