作者:陈民翔芷昌柏淑 | 来源:互联网 | 2023-08-23 11:42
原文地址近年来NODEJS发展迅速,很多工程师尤其是前端工程师,用NODEJS来开发一些后端应用。同时,研发效率和研发成本成为开发者关注的重点,对于一些基础常用功能,如何避免重复开
原文地址
近年来NODEJS发展迅速,很多工程师尤其是前端工程师,用NODEJS来开发一些后端应用。同时,研发效率和研发成本成为开发者关注的重点,对于一些基础常用功能,如何避免重复开发,成为大家关注的重点,而 Parse Server 就是抽象了常用功能的NODEJS开源项目。
首先,从整体上看看 Parse Server
提供了哪些基础功能:
- 用户的登录注册
- 用户身份的认证
- 数据存储 && 灵活查询
- 文件存储
- 实时查询
- 消息推送
- 缓存服务
- 与云平台很好的对接
- 自定义业务逻辑与Hook机制
服务快速搭建
默认情况下,Parse Server 使用的默认数据库是 MonogDB
,所以需要提前安装该数据库。关于数据库的安装与使用不是本文的重点,暂且跳过。
const cOnfig= require('./config');
const app = express();
var api = new ParseServer({
databaseURI: config.databaseURI,
cloud: './cloud/main.js',
appId: config.appId,
masterKey: config.masterKey,
// push: { ... }, // See the Push wiki page
// filesAdapter: ..., // 对应不同云厂商的 FilesAdapter
// JavascriptKey: config.JavascriptKey, // js客户端认证
liveQuery: { // 建立websocket链接,实现实时通信
classNames: ['Sdtuent']
}
});
var dashboard = new ParseDashboard({
"apps": [
{
"serverURL": "http://localhost:1337/parse",
"appId": config.appId,
"masterKey": config.masterKey,
"appName": "test"
},
]
});
// Serve the Parse API at /parse URL prefix
app.use('/parse', api);
app.use('/dashboard', dashboard);
const port = 1337;
const httpServer = http.createServer(app);
httpServer.listen(port, function() {
console.log('parse-server-example running on port ' + port + '.');
});
var parseLiveQueryServer = ParseServer.createLiveQueryServer(httpServer);
通过上述少量的代码,快速完成服务的搭建,/parse
是API的前缀,/dashboard
是后台的页面路由前缀,这样就可以快速使用 Parse Server 提供的各种功能。
客户端调用
针对不同环境、不同语言,parse server提供了大量的 SDK,本文以 Javascript
为例进行简单介绍。
async function saveData() {
const Student = Parse.Object.extend("Student");
const student = new Student();
student.setACL(new Parse.ACL(Parse.User.current()));
student.set("name", "小明");
student.set("age", 12);
const result = await student.save();
console.log('save data: ', result);
}
async function getData() {
const Student = Parse.Object.extend("Student");
const query = new Parse.Query(Student);
query.equalTo('name', '小明');
const result = await query.find();
console.log('save data: ', result);
}
async function run() {
await saveData();
await getData(); // 获得一条数据
await Parse.User.logOut();
// 用另外一个账号登录
await getData(); // 结果为空
}
上述示例设置了 Object level access control
,只有拥有该 object
权限的用户,才能获取对应的数据。
数据的实时通信
要实现数据的实时通信,通常的做法是搭建一个websocket服务,客户端与服务端建立长连接,这样就可以实现数据的实时通信。Parse Server
也集成了这个功能,把websocket服务跟HTTP服务整合在一起,便于 client 端统一调用。
Class的schema问题
因为 Parse Server 背后的数据存储使用的是 MongoDB,数据格式是 schemaless 的, 但是这并不是说可以随意写入数据:
- 第一次创建
Class
的时候,可以自定义字段及类型,同时默认添加 _id、_created_at、_updated_at、_acl 等字段 - 同时,在底层数据中,存在一个
_SCHEMA
集合,存储了 Class 的格式信息,约束了数据再次写入时的字段类型
为了验证上述两点,直接登录 MongoDB
数据库后台:
// step1: 登录数据库后台
mongo
// step2: 查看 collection 情况
show collections
结果如下:
Student
_Role
_SCHEMA
_Session
_User
// step3: 查看 _SCHEMA 内容
db.getCollection('_SCHEMA').find()
结果如下:
{
"_id":"Student",
"objectId":"string",
"updatedAt":"date",
"createdAt":"date",
"name":"string",
"age":"number",
"address":"string"
}
...
接下来对Student表进行写入操作,age的类型不是number,而使用string:
async function saveData() {
const Student = Parse.Object.extend("Student");
const student = new Student();
student.setACL(new Parse.ACL(Parse.User.current()));
student.set("name", "张三");
student.set("age", '9999');
student.set('address', '北京');
const result = await student.save();
console.log('save data: ', result);
}
执行上述代码,会抛出异常信息 schema mismatch for Student.age; expected Number but got String
Cloud Code / HOOK 机制 – 实现自定义业务逻辑
如果进行业务开发,肯定存在自定义的业务逻辑,Parse Server 同样提供了对应的解决途径。
先来看看 Cloud Code 是如何工作的:
// step1 在Parse Server入口处指定路径
var api = new ParseServer({
...
cloud: './cloud/main.js',
...
});
// step2 定义一般的Function
Parse.Cloud.define("averageStars", async (request, response) => {
const params = request.params;
...
const result = ...
response.success(result);
});
// 定义hook函数
Parse.Cloud.beforeSave("Student", (request) => {
...
});
// step3 客户端调用自定义函数方式
async function invokeFn() {
const params = { ... };
const ratings = await Parse.Cloud.run("averageStars", params);
console.log('ratings: ', ratings);
}
// 客户端出发hook比较简单,对Student进行写入,就会触发hook函数
async function saveData() {
const Student = Parse.Object.extend("Student");
const student = new Student();
...
const result = await student.save();
}
同时,Parse Server 也支持远程调用,使用 Dashboard 的 Webhook功能,就可以配置远程调用API
思考总结
Parse Server这个开源项目给了不少项目设计上的思考:
- 具体功能抽象,把一些常用功能抽象出来,是研发提效的一个很重要的手段
- server + client模式,抽象出业务模型之后,如果只是解决了某一部分的问题(例如server),使用成本依然很高,但是如果解决更多链路上的问题,那就会变得更加容易使用和落地。Parser Server不仅提供了server端的实现,而且提供了Dashboard、Client、Adapter等内容
- hook功能,用于解决个性化需求,满足业务定制
- 与云的结合,目前已成为未来技术选型的一个很大趋势,Parse Server 的文件存储,提供了很多云存储相关的 Adapter,快速实现跟云产品的对接
- 权限控制设计,数据的安全已经成为研发很重要的一个工作,分级控制是个思路