Metastocle - مستودع بيانات لا مركزي

ماذا لو كنت بحاجة لتخزين مجموعة متنوعة من البيانات اللامركزية؟ كائنات ، صفائف ، تواريخ ، أرقام ، سلاسل ، نعم أي شيء. هل من الضروري التوصل إلى نظام DBMS قوي لهذا الغرض؟ في الواقع ، غالبًا ما نحتاج فقط إلى تخزين البيانات وتلقيها بطريقة موزعة ومفتوحة ، ولكن بأبسط ما يمكن وبدون أي مطالبات خاصة.

في هذه المقالة ، أود أن أكشف مكتبة صغيرة من metastocle ، والتي يمكنك من خلالها حل المشكلة المذكورة أعلاه بسهولة ، ولكن مع بعض القيود.

خلفية صغيرة

منذ حوالي عام ، كانت هناك رغبة وحاجة إلى إنشاء مستودع موسيقى. تفاصيل هذه المقالة . منذ البداية كان من الواضح أنك بحاجة إلى كتابة كل شيء حتى تتمكن في المستقبل من فعل الشيء نفسه مع الكيانات الأخرى: الكتب ومقاطع الفيديو وما إلى ذلك. تقرر تقسيم كل شيء إلى طبقات يمكن استخدامها بشكل مستقل.

Metastocle هي إحدى الطبقات التي تسمح لك بتخزين واستقبال العديد من أنواع البيانات (ولكن ليس الملفات) ، على عكس طبقة المخزن ، التي تنفذ العمل مع الملفات.

, - , . metastocle. : , ...

, , :

• — nosql , , ...
• — , .
• () — : , , ...

:

:

const Node = require('metastocle').Node;

(async () => {
  try {
    const node = new Node({
      port: 4000,
      hostname: 'localhost'
    });

    //  
    await node.addCollection('test', { limit:  10000, pk:  'id' });
    await node.init();
  }
  catch(err) {
    console.error(err.stack);
    process.exit(1);
  }
})();

:

const Client = require('metastocle').Client;

(async () => {
  try {
    const client = new Client({
      address: 'localhost:4000'
    });
    await client.init();

    //  
    const doc = await client.addDocument('test', { text: 'hi' });

    //   
    await client.updateDocuments('test', { text: 'bye' }, {
      filter: { id: doc.id }
    });

    //    
    await client.addDocument('test', { id: 2, text: 'new' });

    //   
    const results = await client.getDocuments('test', {
      filter: { id: 2 }
    });

    //   
    const doc2 = await client.getDocumentById('test', 2));

    //   
    for(let i = 10; i <= 20; i++) {
      await client.addDocument('test', { id: i, x: i });
    }

    //  ,   
    const results2 = await client.getDocuments('test', {
      filter: { id: { $gt: 15 } },
      sort: [['x', 'desc']],
      limit:  2,
      offset:  1,
      fields: ['id']
    });

    //  ,   id > 15
    await client.deleteDocuments('test', {
      filter: { id: { $gt: 15 } }
    });
  }
  catch(err) {
    console.error(err.stack);
    process.exit(1);
  }
})();

, , . , :

const node = new Node({
   port: 4000,
   hostname: 'localhost',
   collections: {
     test: { limit: 10000, pk: 'id' }
   }
 });

:

• pk — . , . , , , uuid , .
• limit —
• queue — : ,   ,
• limitationOrder — , . , , .
• schema —
• defaults — . 
• hooks — . 
• preferredDuplicates — .

(schema) :

{ 
  type: 'object',
  props: {
    count: 'number',
    title: 'string',
    description: { type: 'string' },
    priority: {
      type: 'number',
      value: val => val >= -1 && val <= 1
    },
    goods: {
      type: 'array',
      items: {
        type: 'object',
        props: {
          title: 'string',
          isAble: 'boolean'
        }
      }
    }
  }
}

utils.validateSchema() https://github.com/ortexx/spreadable/blob/master/src/utils.js

:

{ 
  defaults: {
    date: Date.now
    priority: 0
    'nested.prop': (key, doc) => Date.now() - doc.date
  },
  hooks: {
    priority: (val, key, doc, prevDoc) => prevDoc? prevDoc.priority + 1: val
  }
}

:

• CRUD
• Javascript, , .

javascript , . 

https://github.com/ortexx/metastocle/blob/master/dist/metastocle.client.js window.ClientMetastocle ...

Api

• async Client.prototype.addDocument() —
• async Client.prototype.getDocuments() — -
• async Client.prototype.getDocumentsount() —
• async Client.prototype.getDocumentByPk() —
• async Client.prototype.updateDocuments() — -
• async Client.prototype.deleteDocuments() — -

():

.filter — , :

{ 
  a: { $lt: 1 },
  $and: [
    { x: 1 },
    { y: { $gt: 2 } },
    { 
      $or: [
        { z: 1 },
        { "b.c": 2 }
      ] 
    }
  ]
}

.sort — , :

{ sort: [['x', 'asc'], ['y.z', 'desc']] }

.limit —

.offset —

.fields —

readme.

. : npm i -g metastocle --unsafe-perm=true --allow-root. , .

, metastocle -a getDocumentByPk -o test -p 1 -c ./config.js, 1 test. https://github.com/ortexx/metastocle/blob/master/bin/actions.js

• , , , . , -, , -, , .
• . , - , : , ... , , http , .

, .

, , :

• , , , - , . 
• - , , , . , 10000 - 100 , , , .

, , , , . , , .

:

• @ortex
• mywebstreet@gmail.com