【开源】Westore Cloud 发布- 没后端没SQL没DBA,只需 javascript 开发云端小程序

时间:2024-07-17 11:06:50

Westore Cloud - 隐形云,NoBackEnd,NoSql,HiddenDB

好的设计便是感觉不到设计的存在

开发小程序,但是:没有后端!没有运维!没有 DBA!没有域名!没有证书!没有钱!没有精力!

没关系,会 javascript 就可以,Westore Cloud 带你起飞~~

Github

https://github.com/dntzhang/westore

小程序云开发简介

开发者可以使用云开发开发微信小程序、小游戏,无需搭建服务器,即可使用云端能力。

云开发为开发者提供完整的云端支持,弱化后端和运维概念,无需搭建服务器,使用平台提供的 API 进行核心业务开发,即可实现快速上线和迭代,同时这一能力,同开发者已经使用的云服务相互兼容,并不互斥。

目前提供三大基础能力支持:

  • 云函数:在云端运行的代码,微信私有协议天然鉴权,开发者只需编写自身业务逻辑代码
  • 数据库:一个既可在小程序前端操作,也能在云函数中读写的 JSON 数据库
  • 存储:在小程序前端直接上传/下载云端文件,在云开发控制台可视化管理

关于小程序云更多信息的官方文档可以点击这里

Westore Cloud 简介

Westore Cloud 在基于小程序云的数据库能力,让开发者感知不到数据库的存在(隐形云),只需要专注于本地数据、本地数据逻辑和本地数据的流动,通过简单的 pull、push、add 和 remove 同步本地数据和云数据库。数据库相关的官方文档可以点这里。架构图如下所示:

【开源】Westore Cloud 发布- 没后端没SQL没DBA,只需 javascript 开发云端小程序

典型的 Data First 架构设计,中小型项目可以去掉 Models 和 Adapter 两大模块。可以与 Model first 的架构对比:

【开源】Westore Cloud 发布- 没后端没SQL没DBA,只需 javascript 开发云端小程序

Model first 的架构里,如果不需要持久化存储,可以去掉 Database,只剩下 Models。Models 与渲染无关,专注于模型的抽象与模型之间的逻辑,具体是渲染到 Web、安卓、IOS 还是 Flash 或者 WPF 统统不属于 Models 需要操心的问提。

Westore Cloud 特性

  • 小程序直连数据库
  • 数据库数据项函数扩展
  • 极简的 API 设计 (pull push add remove)
  • 只需要一种编程语言(javascript)编写前端、后端、mongodb
  • 开发者只需专注数据和数据的逻辑(即store),隐形的数据库同步功能
  • 无延迟的设计(先更新本地刷新视图、再sync db、最后 diff 本地更新视图)

快速入门

新建集合

【开源】Westore Cloud 发布- 没后端没SQL没DBA,只需 javascript 开发云端小程序

定义映射 Store

安装上面建立的集合名称一一对应建立好 store 的 data:

export default {
data: {
//user 对应 db 的 collectionName
'user': [],
//其他 collection 可以继续添加
'product': []
},
env:'test-06eb2e'
}

上面的 env 对应云控制台的环境 ID:

【开源】Westore Cloud 发布- 没后端没SQL没DBA,只需 javascript 开发云端小程序

新增测试数据

通过 add 方法往集合 user 添加数据:

this.store.add('user', {
name: 'dntzhang',
city: '深圳',
age: 22,
gender: 1
}).then((res) => { })

【开源】Westore Cloud 发布- 没后端没SQL没DBA,只需 javascript 开发云端小程序

通过 add 方法往集合 product 添加数据:

this.store.add('product', {
address: {
province:'广东省',
city:'深圳市',
},
agent: [ '微信支付', '微信搜一搜', '微信读书']
})

扩展数据库每项方法

export default {
data: {
'user':[],
'product': []
},
methods:{
//这里可以扩展 collection 每一项的方法
'product':{
'agentString':function(){
//this.agent 对应 product 集合的 agent字段
return this.agent.join('-')
}
}
},
env:'test-06eb2e'
}

通过上面的扩展方法,在遍历 product 表的每一项时,可以直接使用 agentString 属性绑定到视图,比如展示本地第一条数据的 agentString:

<view>{{product[0].agentString}}</view>

拉取数据

this.store.pull('user').then(res => {
this.store.data.user = res.data
this.update()
})

绑定数据到视图

<view class="container">
<view class="title" >用户信息</view>
<view>姓名:{{user[0].name}}</view>
<view>年龄:{{user[0].age}}</view>
<view>城市:{{user[0].city}}</view>
<view>性别:{{user[0].gender===1?'男':'女'}}</view>
<view class="title" >产品(测试深层属性绑定和更新)</view>
<view>省:{{product[0].address.province}}</view>
<view>市:{{product[0].address.city}}</view>
<view>代理商:{{product[0].agentString}}</view>
<view class='split'></view>
<user-list></user-list>
<view>
<button ontap="addUser">新增 User</button>
</view>
</view>

修改数据

this.store.data.user[0].name = 'dntzhang' + Math.floor(Math.random() * 100)
this.store.push().then((res) => {
console.log('成功更新云数据库')
})

push 方法等于 update local + update cloud。所以不仅本地视图会刷新,云数据库也会同步更新,更新回调在 then 里执行。

支持精准更新深层的嵌套属性,如:

this.store.data.product[0].address.city = '广州市'
this.store.data.product[0].agent[0] = '微信'
this.store.data.product[0].agent[1] = 'QQ'
this.store.data.product[0].agent[2] = '腾讯云'
this.store.push()

更新后:

【开源】Westore Cloud 发布- 没后端没SQL没DBA,只需 javascript 开发云端小程序

删除数据

const item = this.store.data.user.splice(index, 1)[0]
this.update() //更新本地数据和视图
this.store.remove('user', item._id) //同步到云数据库

新增数据

const user = {
name: 'new user' + this.store.data.user.length,
age: 1,
city: '江西',
gender: 2
}
this.store.data.user.push(user)
//优先更新本地视图
this.update()
//增加到云数据库
this.store.add('user', user)

如果新增的条数据后续需要修改且同步到云数据库需要设置 _id,即最后一行代码改成:

this.store.add('user', user).then((res) => {
//设置_id,方便后续修改进行 push
user._id = res._id
this.update()
})

增加改查完整的 DEMO 可以点击这里

API

this.store.pull(collectionName, [where])

拉取云数据库集合的 JSON 数据

参数

名称 是否可选 类型 描述
collectionName 必须 字符串 集合名称
where 不必须 JSON Object 查询条件,如查询18岁 {age : 18}

更多 where 的构建查询条件的 API 可以点击这里

返回值

返回 Promise 对象的实例。

实例

查询 18 岁的用户:

this.store.pull('user', {age: 18}).then(res => {
this.store.data.user = res.data
this.update()
})

this.store.push()

同步本地 JSON 到云数据库

返回值

返回 Promise 对象的实例。

示例

this.store.data.user[0].name = 'dntzhang'
this.store.data.product[0].address.city = '广州市'
this.store.data.product[0].agent[1] = 'QQ'
this.store.data.product[0].agent[2] = '腾讯云'
this.store.push().then((res) => {
console.log('同步数据完成!')
})

this.store.add(collectionName, data)

添加 JSON 数据到数据库

参数

名称 是否可选 类型 描述
collectionName 必须 字符串 集合名称
data 必须 JSON Object 添加到数据库的数据项

返回值

返回 Promise 对象的实例。

示例

const user = {
name: 'new user' + this.store.data.user.length,
age: 1,
city: '江西',
gender: 2
}
this.store.data.user.push(user)
this.update()
this.store.add('user', user).then((res) => {
//设置_id
user._id = res._id
this.update()
})

this.store.remove(collectionName, id)

根据 id 删除数据库中的数据

参数

名称 是否可选 类型 描述
collectionName 必须 字符串 集合名称
id 必须 字符串 对应数据库中自动生成的 _id 字段

返回值

返回 Promise 对象的实例。

示例

const item = this.store.data.user.splice(index, 1)[0]
this.update()
this.store.remove('user', item._id)

原理

JSON Diff Result 转为数据库更新请求

diffToPushObj({ 'user[2].name': { cc: 1 }, 'user[2].age': 13, 'user[1].a.b': { xxx: 1 } })

返回:

{ 'user-2': { 'name': { 'cc': 1 }, 'age': 13 }, 'user-1': { 'a': { 'b': { 'xxx': 1 } } } }

其中,'user-2'.split('-') 之后可以得到DB的集合名user,数字 2 代表本地数据第三条。

Star & Fork

https://github.com/dntzhang/westore

License

MIT @dntzhang