mds-wrapper

1.4.1 • Public • Published

mds-wrapper

NPM version Coveralls branch Travis David David

Модуль для работы с медиа-хранилищем.

Использование

var MDS = require('mds-wrapper'),
    mds = new MDS({
        namespace: 'my-site',
        get: {
            host: '127.0.0.1',
            port: 3000
        },
        post: {
            host: '127.0.0.1',
            port: 3001
        },
        auth: 'your authorization secret token'
    });

mds.read('key1', function(err, data) {
    console.log(data); //your value will be here
});

API

constructor

Для инициализации хранилища необходимо создать новый объект класса MDS. В качестве аргумента конструктор MDS принимает объект с конфигурацией хранилища.

mds = new MDS(options);

Где объект options может иметь следующий набор доступных полей:

  • namespace - пространство имен вашего приложения
  • get - объект с полями host и port. Соответственно хост и порт медийного хранилища для запросов для чтения данных.
  • post - объект с полями host и port. Соответственно хост и порт медийного хранилища для запросов для изменения данных.
  • auth - заголовок с параметрами авторизации. Необходим для выполнения запросов для изменения данных.
  • timeout - максимальное время выполнения запроса к хранилищу в миллисекундах. По умолчанию равно 5000.
  • debug - параметр отладки. Если значение этого параметра равно true, то в консоль будут выводиться детальные сообщения для каждого обращения к хранилищу. По умолчанию debug равно false.

Примечание 1:

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

var mds = new MDS({
    namespace: 'my-site',
    host: '127.0.0.1',
    get: { port: 3000 },
    post: { port: 3001 },
    auth: 'your authorization secret token'
});

Примечание 2:

По умолчанию:

  • хост для чтения данных - 127.0.0.1
  • порт для чтения данных - 80
  • хост для изменения данных - 127.0.0.1
  • порт для изменения данных 1111

read

Метод для чтения данных из хранилища по ключу.

Параметры:

  • {String} key - ключ для записи в хранилище.
  • {Function} callback - функция, которая первым аргументом принимает экземпляр класса Error (в случае возникновения ошибки), а вторым - возвращаемые методом данные.

callback-функция является опциональным параметром. Без передачи данной функции, метод вернет Promise-объект.

Пример:

mds.read('your-custom-key', function(error, value) {
    console.log(value);
});
mds.read('your-custom-key').then(function(value) {
    console.log(value);
});

write

Метод для записи данных в хранилище по ключу.

Параметры:

  • {String} key - ключ для записи в хранилище.
  • {String} value - значение для записи в хранилище.
  • {Function} callback - функция, которая первым аргументом принимает экземпляр класса Error (в случае возникновения ошибки), а вторым - возвращаемые методом данные.

callback-функция является опциональным параметром. Без передачи данной функции, метод вернет Promise-объект.

Пример:

mds.write('your-custom-key', 'your-custom-value', function(error, value) {
    console.log(value); // 'your-custom-value'
});
mds.write('your-custom-key', 'your-custom-value').then(function(value) {
    console.log(value); // 'your-custom-value'
});

remove

Метод для удаления данных из хранилища по ключу.

Параметры:

  • {String} key - ключ для записи в хранилище.
  • {Function} callback - функция, которая первым аргументом принимает экземпляр класса Error (в случае возникновения ошибки), а вторым - возвращаемые методом данные.

callback-функция является опциональным параметром. Без передачи данной функции, метод вернет Promise-объект.

Пример:

mds.remove('your-custom-key', function(error, result) {
    console.log(result); // null
});
mds.removeP('your-custom-key').then(function(result) {
    console.log(result); // null
});

readToStream

Метод, считывающий данные из хранилища по ключу и вовращающий экземпляр класса Stream. Позволяет осуществлять потоковое чтение с помощью NodeJS Stream API.

Пример:

mds.read('your-custom-key').pipe(fs.createWriteStream('./your-custom-key.txt'));

getFullUrl

Позволяет получить полный url для записи в mds по ключу.

Тестирование

Для запуска процедуры проверки синтаксиса и стиля кода:

npm run codestyle

Для запуска тестов:

npm test

Лицензия

© 2012 YANDEX LLC. Код лицензирован Mozilla Public License 2.0.

Readme

Keywords

none

Package Sidebar

Install

npm i mds-wrapper

Weekly Downloads

2

Version

1.4.1

License

MPL-2.0

Last publish

Collaborators

  • tadatuta
  • tormozz48