/jsonDb

A small db controller saving with json file

Primary LanguageTypeScriptOtherNOASSERTION

jsonDb

LICENSE

a small db controller saving with json file

Author:Alan Chen

Version: 0.0.1

Date: 2019/11/27

purpose

  1. lowdb适用的场景,jsonDb都适用,我个人认为,这种以本地文件存储数据的插件,比较适合electron本地应用和非常轻量的server。
  2. lowdb本身没对数据读写做什么处理,它更像是一个通用的api插件,支持adapter来实现读写数据的接口。虽然兼容了browser端,但是我个人认为localstorage本身就是阻塞操作,还不如localforage集成的indexdb和websql来的高效。
  3. lowdb自带的adapter对node端处理的太过于暴力,导致在读写体积稍微大一点的json文件(作者说是200m左右)时,就会导致卡顿,甚至内存崩溃。
  4. jsonDb在对读取文件时,做了分片读取,通过jsonDb生成的.jsonx文件都会附带一个索引映射.map文件。开发者可以指定读取部分字节大小的数据到内存中,而且索引文件会同步更新,这样就避免了内存崩溃和io读取耗时太长。

其实jsonDb也可以写成lowdb的一个adapter,但是在下不太喜欢依赖太多,加上一些api可能也不好实现,因此写了一个单独的插件。

disadvantage

  1. 虽然jsonDb在一定程度上解决了读取大文件的耗时和内存崩溃问题,但是随着.jsonx文件越来越大,.map文件也势必越来越大,尤其当.jsonx文件的key超级庞大,这样就gg了。。。
  2. 原本最理想的情况是,读写都实现分片,但是在写入文件时遇到了。。。
  3. lowdb由于集成了lodash,所以在处理数据上会非常好用,jsonDb没有,但是提供了一个query方法自定义查询,如果你觉得还是不够的话。自己用lodash再次处理吧。
  4. 目前不支持并发操作,后期可能会通过event emitter保证下次读取会等待当前写入完成之后再触发。

installation

npm install --save @alanchenchen/json-db or yarn add @alanchenchen/json-db

usage

  1. git clone https://github.com/alanchenchen/jsonDb.git
  2. cd jsonDb然后yarn安装好依赖
  3. 接着使用下面的脚本命令即可,目前入口文件是example.ts

api

传送门

scripts

  1. npm start等同于npm run serve,通过ts-node启动example.ts.
  2. npm build编译ts文件到dist目录.

license

  • Anti 996(996.ICU)