学习Lowdb小型本地JSON数据库
Lowdb是轻量化的基于Node的JSON文件数据库。对于构建不依赖服务器的小型项目,使用LowDB存储和管理数据是非常不错的选择。
一:lowdb 使用及安装
在项目中的根目录安装 lowdb 命令如下:
npm install --save-dev lowdb
lowdb是基于lodash构建的,因此我们可以使用任何 lodash 强大的函数。并且我们可以串联使用。
下面我们的目录结构比如是如下:
|--- lowdb
| |--- node_modules
| |--- app.js
| |--- package.json
然后我们在app.js 添加如下代码:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json');
const db = low(adapter); db.defaults({posts: [], user: {}, count: 0 }).write();
如上保存后,我们在命令行中执行 node app.js 后,会在我们的项目中的根目录下新建一个叫 db.json 文件,该文件代码变成如下所示:
{
"posts": [],
"user": {},
"count": 0
}
如上代码,引入 lowdb包,然后引入 lowdb 中的适配器 FileSync。
lowdb自带的适配器有:FileSync、FileAsync 和 LocalBrowser。分别有以下可选参数:
defaultValue: 文件不存在时的默认值。
serialize/deserialize: 文件被写之前和读之后的操作。
比如如下代码:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json', {
serialize: (data) => JSON.stringify(data),
deserialize: (data) => JSON.parse(data)
});
const db = low(adapter); db.defaults({posts: [], user: {}, count: 0 }).write();
如上代码,如果我们的db.json 没有数据的时候 才会重新调用 db.defaults初始化数据,否则的话会使用本地存储的数据。我们可以更改 count 的值试试看,不管我们在node命令行中运行多少次,值都是一样的,但是当我们把 db.json内容删除掉后,我们再运行下,发现最新的内容被写入进去了。
如上代码,如果我们把上面的代码改成这样的如下:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json', {
serialize: (data) => console.log(data),
deserialize: (data) => console.log(data)
});
const db = low(adapter); db.defaults({posts: [], user: {}, count: 30 }).write();
那么在命令行中运行下,第一次被写入之前 serialize 打印 为 {} 空对象。然后就执行 db.defaults 操作就会把对应的数据写入到 db.json 文件中,然后我们就会执行 deserialize 操作对文件进行读取,然后在命令行中会打印 { posts: [], user: {}, count: 30 }。 打印完成后,我们没有做任何操作后,最后我们再来查看下 db.json文件的内容变成了 undefined. 因此我们可以判定 serialize 和 deserialize 这两个操作完成后,他们也会对文件进行写入操作。如果没有值被写入或操作的话,那么文件内容就变为undefined。当文件变为undefined后,我们再执行上面的代码,可以看到 db.defaults({posts: [], user: {}, count: 30 }).write(); 这句代码是不会被写入的。那么我们可以猜想的到,这句代码的含义是会判断该文件 有没有内容,如果没有内容的话文件数据才会被写入,否则的话就不会执行任何操作。我们可以再把 db.json 文件内容全部删除掉,我们再运行下 node app.js 命令后,可以看到这个时候 数据才会被写入进去。
1. 设置数据
我们可以对 db.json 数据里面设置某个字段的数据,比如如下代码:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json', {
serialize: (data) => JSON.stringify(data),
deserialize: (data) => JSON.parse(data)
});
const db = low(adapter); db.defaults({posts: [], user: {}, count: 30 }).write(); // 设置数据
db.set("user.name", 'kongzhi').write();
然后我们的 db.json 数据变成如下了:
{"posts":[],"user":{"name":"kongzhi"},"count":30}
2. 获取数据
我们可以对json文件获取某个字段后的值,然后进行添加数据操作,或者删除数据操作,总之我们可以操作数据,如下代码:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json', {
serialize: (data) => JSON.stringify(data),
deserialize: (data) => JSON.parse(data)
});
const db = low(adapter); db.defaults({posts: [], user: {}, count: 30 }).write(); // 设置数据
db.set("user.name", 'kongzhi').write(); // get 数据, 然后添加一条数据进去,最后写入文档里面去。
db.get('posts').push({'id': 1, 'title': 'welcome to hangzhou' }).write();
我们的db.json 文件代码变成如下所示:
{"posts":[{"id":1,"title":"welcome to hangzhou"}],"user":{"name":"kongzhi"},"count":30}
3. 更新数据,我们可以对某条数据进行更新。如下代码所示:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json', {
serialize: (data) => JSON.stringify(data),
deserialize: (data) => JSON.parse(data)
});
const db = low(adapter); db.defaults({posts: [], user: {}, count: 30 }).write(); // 设置数据
db.set("user.name", 'kongzhi').write(); // get 数据, 然后添加一条数据进去,最后写入文档里面去。
// db.get('posts').push({'id': 1, 'title': 'welcome to hangzhou' }).write(); // 使用 update 更新数据 这里的n 就是 count 的默认值,在db.json中的count默认值为30, 最后写入进去
db.update('count', n => n + 1).write();
运行后 db.json 数据代码如下所示:
{"posts":[{"id":1,"title":"welcome to hangzhou"}],"user":{"name":"kongzhi"},"count":31}
注意:由于我们的 lowdb 基于 lodash 的,因此我们可以使用 lodash 中的所有方法和属性。
4. find 查找字段中数据
我们可以对 db.json 中的某个字段的数据进行查找。代码如下所示:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json', {
serialize: (data) => JSON.stringify(data),
deserialize: (data) => JSON.parse(data)
});
const db = low(adapter); db.defaults({posts: [], user: {}, count: 30 }).write(); // 设置数据
db.set("user.name", 'kongzhi').write(); // get 数据, 然后添加一条数据进去,最后写入文档里面去。
// db.get('posts').push({'id': 1, 'title': 'welcome to hangzhou' }).write(); // 使用 update 更新数据 这里的n 就是 count 的默认值,在db.json中的count默认值为30, 最后写入进去
db.update('count', n => n + 1).write(); // 查找数据
const value = db.get('posts').find({'id': 1}).value();
console.log(value);
假如我们的db.json 代码如下:
{"posts":[{"id":1,"title":"welcome to hangzhou"}],"user":{"name":"kongzhi"},"count":33}
因此我们通过 db.get('posts').find({'id': 1}).value() 后就可以获取到值了,如下所示:
5. lowdb 的API
1. low(adapter): 它返回一个具有特定属性和功能的 lodash.
2. db.[...].write()/.value(): write() 方法是写入数据,value()方法是读取数据。
3. db.getState()/.setState(): 获取/设置数据库的状态。
4. db._ 数据库的lodash的实列。我们可以使用这个来添加我们自己的函数或者第三方的mixins。比如 lodash-id(https://github.com/typicode/lodash-id)
mixins 的使用列子如下:
代码如下:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json', {
serialize: (data) => JSON.stringify(data),
deserialize: (data) => JSON.parse(data)
});
const db = low(adapter); db.defaults({posts: [], user: {}, count: 30 }).write(); // 使用 mixin 混合模式来扩展我们自己的方法
db._.mixin({
getSecondData: function(arr) {
return arr[1];
}
});
// 调用 getSecondData 方法 获取到 posts 第二条数据
const xx = db.get('posts').getSecondData().value();
console.log(xx);
假如我们的db.json 代码如下数据:
{
"posts":[
{"id":1,"title":"welcome to hangzhou"},
{"id":2,"title":"welcome to hangzhou"}
],
"user":{"name":"kongzhi"},
"count":33
}
我们运行 node app.js 命令后,可以看到,我们可以获取到数组里面的第二条数据了,如下所示:
6. db.getState/db.setState 获取数据库状态/设置数据库的状态, 如下代码演示:
const low = require('lowdb');
const FileSync = require('lowdb/adapters/FileSync'); const adapter = new FileSync('./db.json', {
serialize: (data) => JSON.stringify(data),
deserialize: (data) => JSON.parse(data)
});
const db = low(adapter); db.defaults({posts: [], user: {}, count: 30 }).write(); // 获取数据库的状态
console.log(db.getState()); const newState = {}
db.setState(newState); console.log('-----------');
console.log(db.getState());
db.json 假如数据如下:
{
"posts":
[
{"id":1,"title":"welcome to hangzhou"},
{"id":2,"title":"welcome to hangzhou"}
],
"user":{"name":"kongzhi"},
"count":33
}
运行结果如下图所示:
7. 其他json数据操作
比如 db.json 数据如下所示:
{
"posts":
[
{"id":1,"title":"welcome to hangzhou"},
{"id":2,"title":"welcome to hangzhou"}
],
"user":{"name":"kongzhi"},
"count":33
}
1. 检查db.json中有没有 'posts' 这个字段是否存在。如下测试代码:
db.has('posts').value(); // 如果有该字段就会返回 true, 否则的话,返回false.
2. 设置值 set
db.set('posts', []).write(); // 运行完成后,就会对 posts 字段设置为 空数组了 [];
3. 获取特定字段的值
db.get('posts').map('id').value(); // 执行完成后会返回 [1, 2]
4. 获取数量
db.get('posts').size().value(); // 返回该数组的长度为 2
5. 获取特定信息的值
db.get('posts[0].id').value(); // 就会返回 1.
6. 更新信息
db.get('posts')
.find({title: 'welcome to hangzhou'})
.assign({name: 'kongzhi'})
.write();
如上代码,我们可以看到,我们获取 posts这个字段,然后通过 find这个关键字去查找 {title: 'welcome to hangzhou'} 这样的,如果找到,就把 它改成 assign 里面的对象值。如果没有找到,就会在该对象里面添加该值,因此上面的结果返回如下:
{
"posts":[
{"id":1,"title":"welcome to hangzhou","name":"kongzhi"},
{"id":2,"title":"welcome to hangzhou"}
],
"user":{"name":"kongzhi"},
"count":33
}
如果我们把上面的语句改成如下语句,就会更改对应的值了:
db.get('posts')
.find({name: 'kongzhi'})
.assign({name: 'xxx'})
.write();
那么结果就变成如下:
{
"posts":[
{"id":1,"title":"welcome to hangzhou","name":"xxx"},
{"id":2,"title":"welcome to hangzhou"}
],
"user":{"name":"kongzhi"},
"count":33
}
7. 删除信息
db.get('posts')
.remove({name: 'xxx'})
.write();
那么结果就变为如下了:
{
"posts":[
{"id":2,"title":"welcome to hangzhou"}
],
"user":{"name":"kongzhi"},
"count":33
}
8. 移除属性
db.unset('posts[0].id').write();
那么结果变为如下了:
{"posts":[
{"title":"welcome to hangzhou"}
],
"user":{"name":"kongzhi"},
"count":33
}
9. 深拷贝
var xx = db.get('posts').cloneDeep().value();
console.log(xx); // 打印:[ { title: 'welcome to hangzhou' } ]
了解更多相关的知识,请看这里
最新文章
- C#之方法的声明与调用
- Jstorm可靠性分析
- javascript里面的数组,json对象,动态添加,修改,删除示例
- laravel吐槽系列之一
- 【BZOJ3270】【高斯消元】博物馆
- poj1981 Circle and Points 单位圆覆盖问题
- 【解决】VS2013 + Qt 5.7(5.6适用)使用QSqlDatabase出现“无法解析的外部符号";错误
- Strom数据流分组解析
- 第10章 协议和声明类型常量 - IdentityModel 中文文档(v1.0.0)
- Pycharm使用技巧(转载)
- CTF的一道安卓逆向
- ubuntu,day 2 ,退出当前用户,创建用户,查找,su,sudo,管道符,grep,alias,mount,tar解压
- shell 命令 if elif else fi 用法
- 矩阵快速幂(以HDU1757为例)
- QUIC和TCP
- 树莓派使用DHT11温湿度传感器
- Data truncation: Out of range value for column 'Quality' at row 1
- 编程开发(C/C++&;Java&;Python&;JavaScript&;Go&;PHP&;Ruby&;Perl&;R&;Erlang)
- 清空git默认的用户名和密码,
- logstash收集Nginx日志,转换为JSON格式