Et si vous avez besoin de stocker une variété de données décentralisées? Objets, tableaux, dates, nombres, chaînes, oui n'importe quoi. Est-il nécessaire de proposer un SGBD puissant pour cela? En effet, il nous suffit souvent de stocker et de recevoir des données de manière distribuée et ouverte, mais aussi simple que possible et sans revendications particulières.
Dans cet article, je voudrais révéler une petite bibliothèque de métastocles , avec laquelle vous pouvez résoudre le problème ci-dessus facilement, mais avec certaines limitations.
Un peu d'histoire
Il y a environ un an, il y avait un désir et un besoin de créer un référentiel musical. Cet article détaille. Dès le début, il était clair que vous deviez tout écrire pour qu'à l'avenir vous puissiez faire de même avec d'autres entités: livres, vidéos, etc. Il a été décidé de tout diviser en couches pouvant être utilisées indépendamment.
Metastocle est l'une des couches qui vous permet de stocker et de recevoir de nombreux types de données (mais pas de fichiers), contrairement à la couche storacle , qui implémente le travail avec les fichiers.
, - , . 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']
});
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
}
}
:
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 , , , .
, , , , . , , .
: