前面已发布一篇关于 db-operate 包的使用方法的文章,由于篇幅有限,没有进行db-operate 包的基本介绍,下面将开始介绍 db-operate 包的一些基本的应用函数的应用。
前面的文章已经讲了如何使用 db-operate 包实现对 mongoDB 数据库的操作,没看过的朋友们可以点击这里#mongoDB数据库操作之node js db-operate包的使用
首先,引入的 db-operate 包构建的变量“test”中,会有 mongoPoint 的实例类,
此时,mongoPoint 实例类没有收到所需配置进行初始化,开始进行对 mongoDB 数据库操作之前,必须先调用 mongoPoint 实例对象下的 configureConnect (数据库连接配置) 函数,对需要连接的数据库信息进行测试并初始化,便于操作功能正常使用。调用的代码示例如下:
let dbs = require("db-operate");
let test = new dbs();
test.mongoPoint.configureConnect({
hostName:192.168.31.56,
Port:27017,
DataBaseName:"ses",
UserName:"sespdb",
PassWord:"poiuytmnbvc",
CollectName:"cct"
}).then(()=>{}).catch(()=>{});
configureConnect 函数是异步函数,执行完成后会得到成功(then)或失败(catch)这两种结果,通过then、catch的调用可以得到数据库的连接配置是否有误。configureConnect这一步成功通过后,接下来就可以使用如下的操作功能函数了。
readerDataOperate,读取数据操作函数
insertDataOperate,插入数据操作函数
updateDataOperate,更新数据操作函数
removeDataOperate,删除数据操作函数
以上四个函数,实现了增加、删除、改写、查找(增删改查)
以下的函数也可以使用,分别是:
createDataLibrary,创建数据库函数
deleteDataLibrary,删除数据库函数
createDataCollection,创建数据集合(数据表)操作函数
deleteDataCollection,删除数据集合(数据表)操作函数
上面介绍的是 db-operate 包的常用函数的基本介绍。接下来将上一篇文章遗留下来的没讲的,以及一些坑洞。在这里逐一补上。
上一篇文章已经讲了如何插入数据和查找数据,
如
insertDataOperate({insertData:{K:"1",J:"2"}})
readerDataOperate({SearchData:{}})
其实,这两个函数标准的使用方法是通过传递完整的对象数据进行操作的,分别是
insertDataOperate 函数传参对象格式
{
DataLibrary:"",//数据库名称,如果只用按连接配置的数据库名称,这个可以去掉
CollectName:"",//集合(数据表)名称,跟数据库名称同理,根据情况去掉
insertData:{},//需要插入的数据
}
readerDataOperate 函数传参对象格式
{
DataLibrary:"",//跟上面的同理,根据情况去掉或保留
CollectName:"",//也跟上面的情况类同,根据实际选择去留
SearchData:{}//需要查找的数据
}
剩下的updateDataOperate、removeDataOperate 的传参对象的
DataLibrary、CollectName 属性跟前面两个是一致的,
而 updateDataOperate 函数更新数据是由传参对象内的 updateData 属性和 multiDataUpdate 决定的。updateData 对象内包含的 where 属性和 updateString 属性分别是指定需要更新的数据,确认更新的数据。而确认要更新的数据必须放在updateString 属性里面的 $set 属性内。以上面的插入案例插入来举例,需要将 K 里面的 “1” 更新成 “3” 那么调用 updateDataOperate 函数的传参对象是
{
updateData:{
where:{K:"1"},
updateString:{$set:{K:"3"}}
}
multiDataUpdate:false
}
前面提到 multiDataUpdate 属性是是否更新多条相同的数据,默认为false,单纯只更新一条数据可以去掉该属性或保留该属性的默认值,如更新多条相同的数据,只能将该属性的值改为 true 即可。
removeDataOperate 函数是删除数据表内指定的数据,有些共同部分,在这里就不再赘述了。 removeDataOperate 函数删除数据也是根据传参对象内的 removeData 属性和 multiDataRemove 属性决定的。例如我需要删除前面的 K:"3" 的数据,那么传参对象是
{
removeData:{K:"3"}
}
multiDataRemove 属性跟 multiDataUpdate 属性同理,需要删除多条相同的数据将默认值改为 true 即可。
看到这里,有的朋友就问了,你这么多函数的传参都是对象,怎么记得住啊。在这里呢我也可以告诉大家,在 mongoPoint 实例对象下有一个 OperateTemplate 的属性,里面包含有各对应的操作函数传参所需的对象的生成函数。分别是:
readerTemplateBuilder 对应 readerDataOperate
insertTemplateBuilder 对应 insertDataOperate
updateTemplateBuilder 对应 updateDataOperate
removeTemplateBuilder 对应 removeDataOperate
以上面讲的更新数据为例,OperateTemplate里面的函数就是这样用的。
let ins = test.mongoPoint.OperateTemplate.insertTemplateBuilder();
ins.updateData.where={K:"1"}
ins.updateData.updateString.$set={K:"3"}
test.updateDataOprate(ins);//执行更新数据
其他的操作也与此类同的,这里不再赘述。
增删改查的基本就介绍完了,那么还有建库、建表、删库、删表、db-operate 包构建实例的方式,将在下篇更新。