微信小程序云开发 搭建一个管理小程序


Posted in Javascript onMay 17, 2019

概述 :

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

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

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

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

创建项目:

新建项目选择一个空目录,填入 AppID(使用云开发能力必须填写 AppID),勾选创建 “云开发 QuickStart 项目”,点击创建即可得到一个展示云开发基础能力的示例小程序。

项目结构如下:

微信小程序云开发 搭建一个管理小程序

开通云服务:

微信小程序云开发 搭建一个管理小程序

点击云开发 , 打开云开发控制台,云开发控制台提供如下能力(云函数中对数据库的操作等同于在控制台直接操作数据库)

  • 概览:查看云开发基础使用数据
  • 用户管理:查看小程序用户信息
  • 数据库:管理数据库,可查看、增加、更新、查找、删除数据、管理索引、管理数据库访问权限等
  • 存储管理:查看和管理存储空间
  • 云函数:查看云函数列表、配置、日志和监控
  • 统计分析:查看云开发资源具体使用统计信息 

基础方法(基本涵盖小程序云开发常用的定义和方法):

小程序调用云函数示例:

// Callback 风格调用
wx.cloud.callFunction({
 // 要调用的云函数名称
 name: 'add',
 // 传递给云函数的参数
 data: {
 x: 1,
 y: 2,
 },
 success: res => {
 // output: res.result === 3
 },
 fail: err => {
 // handle error
 },
 complete: () => {
 // ...
 }
})
 
// Promise 风格调用
wx.cloud.callFunction({
 // 要调用的云函数名称
 name: 'add',
 // 传递给云函数的event参数
 data: {
 x: 1,
 y: 2,
 }
}).then(res => {
 // output: res.result === 3
}).catch(err => {
 // handle error
})

小程序调用数据库示例:

// 1. 获取数据库引用
const db = wx.cloud.database()
// 2. 构造查询语句
// collection 方法获取一个集合的引用
// where 方法传入一个对象,数据库返回集合中字段等于指定值的 JSON 文档。API 也支持高级的查询条件(比如大于、小于、in 等),具体见文档查看支持列表
// get 方法会触发网络请求,往数据库取数据
db.collection('books').where({
publishInfo: {
country: 'United States'
}
}).get({
success: function(res) {
// 输出 [{ "title": "The Catcher in the Rye", ... }]
console.log(res)
}
})

小程序存储调用示例:

// 让用户选择一张图片
wx.chooseImage({
success: chooseResult => {
// 将图片上传至云存储空间
wx.cloud.uploadFile({
// 指定上传到的云路径
cloudPath: 'my-photo.png',
// 指定要上传的文件的小程序临时文件路径
filePath: chooseResult.tempFilePaths[0],
// 成功回调
success: res => {
console.log('上传成功', res)
},
})
},
})

云函数的定义:

// index.js 是入口文件,云函数被调用时会执行该文件导出的 main 方法
// event 包含了调用端(小程序端)调用该函数时传过来的参数,同时还包含了可以通过 getWXContext 方法获取的用户登录态 `openId` 和小程序 `appId` 信息
const cloud = require('wx-server-sdk')
exports.main = (event, context) => {
const {userInfo, a, b} = event
const {OPENID, APPID} = cloud.getWXContext() // 这里获取到的 openId 和 appId 是可信的
const sum = a + b
 
return {
OPENID,
APPID,
sum
}
}

云函数中操作数据库

以下调用获取默认环境的数据库的引用:

const cloud = require('wx-server-sdk')
cloud.init()
const db = cloud.database()

假设有一个环境名为 test,用做测试环境,那么可以如下获取测试环境数据库:

const cloud = require('wx-server-sdk')
cloud.init()
const testDB = cloud.database({
env: 'test'
})

也可以通过 init 传入默认环境的方式使得获取数据库时默认是默认环境数据库:

const cloud = require('wx-server-sdk')
cloud.init({
env: 'test'
})
const testDB = cloud.database()

操作集合:

const cloud = require('wx-server-sdk')
cloud.init()
const db = cloud.database()
const todosCollection = db.collection('todos') // 获取todos集合

云开发实践:

(使用小程序云开发实现一个可以增删改查的设备管理平台)

1: 需求分析:

  • 设备管理现状: 部门有大量安卓/苹果测试机和测试硬件设备 , 当前管理现状混乱 , 管理员使用纸质表格和excel对每次的出借情况进行记录 , 当有同事需要测试设备的时候 , 需要联系管理员 , 管理员查阅表格 , 找到最后借用人进行协调 , 并登记在册
  • 管理痛点: 管理员需要通过翻阅借用记录表去了解设备现状 , 并协调资源 , 增加了工作量 , 普通员工无法知道设备出借现状 , 获取设备环节复杂;
  • 考勤管理现状: 管理员通过excel表格汇总考勤情况 , 并逐月发送到员工邮箱 , 员工需要下载csv文件去查看考勤
  • 考勤管理痛点: 对于员工 , 通过查看excel十分不便
  • 需求总结: 普通员工通过查看设备现状 , 找到可以状态的设备 , 并汇报管理员 , 管理员通过小程序切换设备状态 , 绑定使用人 ; 管理员逐月导入考勤数据 , 员工可通过小程序查看个人考勤情况; 

2: 项目构建

  • ui库使用iview weapp
  • 小程序端(前端)对数据库的操作权限是严格按照控制台中配置的权限 , 云函数则拥有所有权限(云函数中对数据库的操作等同于在云开发控制台中进行数据库操作),所以本项目中所有的关于数据库的操作都将在云函数中处理 , 小程序端只作为视图层 , 并对无权限的界面和操作进行视觉隔离

3: 建立集合

微信小程序云开发 搭建一个管理小程序

通过云函数控制台建立需要的集合 , 并将excel/json文件导入到对应的集合, 也可以直接手动建立

4: 核心功能的实现(以云函数操作数据库为主)

微信小程序云开发 搭建一个管理小程序

小程序端>app.js

初始化云函数 , 获取已授权用户信息 , 定义需要的全局数据

//app.js
App({
 onLaunch: function () {
 const _this = this
 // 初始化云函数
 if (!wx.cloud) {
 console.error('请使用 2.2.3 或以上的基础库以使用云能力')
 } else {
 wx.cloud.init({
 traceUser: true,
 })
 }
 // 获取用户信息(针对已经授权过的用户,直接获取用户信息)
 wx.getSetting({
 success: res => {
 if (res.authSetting['scope.userInfo']) {
  // 已经授权,可以直接调用 getUserInfo 获取头像昵称,不会弹框
  wx.getUserInfo({
  success: res => {
  _this.globalData.avatarUrl = res.userInfo.avatarUrl
  _this.globalData.userInfo = res.userInfo
  if (_this.userInfoCallback) {
  _this.userInfoCallback()
  }
  }
  })
 }
 }
 })
 this.globalData = {
 userInfo: {}, // 微信用户信息
 userRole: '', // 当前用户角色
 registerUser: {}, // 微信用户绑定的用户信息
 userindex: '', // 编辑设备和添加设备页面,index索引选择的值name
 userindexId: '',// 编辑设备和添加设备页面,index索引选择的值id
 currentQuerys: {
 type: ['iphone', 'android', 'ble'],
 user: []
 } // 设备管理筛选框筛选的结果
 }
 }
})

云函数 > login (云函数条件查询云数据库)

以小程序open_id为查询条件 , 在云函数user集合中查找绑定该open_id的数据 , 为空表示该微信账号未绑定用户名

// 云函数入口文件
const cloud = require('wx-server-sdk')
cloud.init()
// 云函数入口函数
exports.main = async (event, context) => {
 const wxContext = cloud.getWXContext()
 // 调用数据库获取所有设备列表
 const db = cloud.database() // 获取数据库
 const _ = db.command // 获取查询指令
 const usersCollection = db.collection('users') // 获取users集合
 const user = (await usersCollection.where({
 open_id: wxContext.OPENID // 根据唯一open_id在user集合中查找已绑定的用户
 }).get())
 return {
 event,
 data: user,
 openid: wxContext.OPENID,
 appid: wxContext.APPID,
 unionid: wxContext.UNIONID,
 }
}

云函数 > register (云函数修改数据库数据)

对于未绑定的微信号 , 需要将用户选中的用户名与当前微信open_id绑定 , 完成注册

// 云函数入口文件
const cloud = require('wx-server-sdk')
cloud.init()
// 云函数入口函数
exports.main = async (event, context) => {
 const wxContext = cloud.getWXContext()
 // 调用数据库获取所有设备列表
 const db = cloud.database() // 获取数据库
 const _ = db.command // 获取查询指令
 const usersCollection = db.collection('users') // 获取users集合
 // 查询条件
 let query = _.eq(event.id)
 // 
 try {
 await usersCollection.doc(event.id).update({
 // data 传入需要局部更新的数据
 data: {
 open_id: wxContext.OPENID
 }
 })
 } catch (e) {
 console.log(e)
 }
 
 return {
 event,
 openid: wxContext.OPENID,
 appid: wxContext.APPID,
 unionid: wxContext.UNIONID,
 }
}

云函数 > getEquipmentList (云函数查询全部数据 , 云函数按条件查询数据库)

获取设备数据的时候存在多种情况

  • 获取全部数据: 由于获取数据库有100条上限的限制 , 需要进行特殊处理
  • 按条件查询数据 : 需要提前拼接好查询语句
// 云函数入口文件
const cloud = require('wx-server-sdk')
cloud.init()
// 云函数入口函数
exports.main = async (event, context) => {
 const wxContext = cloud.getWXContext()
 // 调用数据库获取所有设备列表
 const db = cloud.database() // 获取数据库
 const _ = db.command // 获取查询指令
 const equipmentCollection = db.collection('equipment') // 获取equipment集合
 // 取所有集合中符合条件的数据(因为有默认 limit 100 条的限制,需要做特殊操作)
 const MAX_LIMIT = 100
 // 先取出集合记录总数
 const countResult = await equipmentCollection.count()
 const total = countResult.total
 // 计算需分几次取
 const batchTimes = Math.ceil(total / 100)
 // 承载所有读操作的 promise 的数组
 const tasks = []
 let query = {}
 // 封装设备类型查询条件(直接通过reduce直接拼接方法)
 query.eq_type = event.queryList['type'].reduce((acc, cur) => {
 if (!acc) {
 return _.eq(cur)
 } else {
 return acc.or(_.eq(cur))
 }
 }, null)
 // 用户名查询条件
 if (event.queryList['user'].length>0) {
 query.eq_user = event.queryList['user'][0]
 }
 for (let i = 0; i < batchTimes; i++) {
 const promise = equipmentCollection.where(query).skip(i * MAX_LIMIT).limit(MAX_LIMIT).get()
 tasks.push(promise)
 }
 // 等待所有数据读取完成
 const equipmentList = (await Promise.all(tasks)).reduce((acc, cur) => ({
 data: acc.data.concat(cur.data),
 errMsg: acc.errMsg,
 }))
 
 return {
 event,
 data: equipmentList,
 openid: wxContext.OPENID,
 appid: wxContext.APPID,
 unionid: wxContext.UNIONID,
 }
}

 云函数 > removeEquipement (云函数删除集合数据)

// 云函数入口文件
const cloud = require('wx-server-sdk')
 
cloud.init()
 
// 云函数入口函数
exports.main = async (event, context) => {
 const wxContext = cloud.getWXContext()
 // 调用数据库获取所有设备列表
 const db = cloud.database() // 获取数据库
 const _ = db.command // 获取查询指令
 const equipmentCollection = db.collection('equipment') // 获取equipment集合
 
 try{
 await equipmentCollection.doc(event.id).remove()
 } catch(e){
 console.error(e)
 }
 
 return {
 event,
 openid: wxContext.OPENID,
 appid: wxContext.APPID,
 unionid: wxContext.UNIONID,
 }
}

项目截图:

微信小程序云开发 搭建一个管理小程序

微信小程序云开发 搭建一个管理小程序

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
jQuery之网页换肤实现代码
Apr 30 Javascript
JavaScript高级程序设计 阅读笔记(十七) js事件
Aug 14 Javascript
javascript获取当前鼠标坐标的方法
Jan 10 Javascript
JavaScript使用function定义对象并调用的方法
Mar 23 Javascript
原生js和jquery分别实现横向导航菜单效果
May 13 Javascript
ES6新特性之解构、参数、模块和记号用法示例
Apr 01 Javascript
Angular2自定义分页组件
Apr 19 Javascript
jQuery实现table中两列CheckBox只能选中一个的示例
Sep 22 jQuery
JavaScript 点击触发复制功能实例详解
Nov 02 Javascript
JS中的算法与数据结构之栈(Stack)实例详解
Aug 20 Javascript
element-ui table组件如何使用render属性的实现
Nov 04 Javascript
vue实现简单计算商品价格
Sep 14 Javascript
微信小程序云开发实现增删改查功能
May 17 #Javascript
微信小程序云开发实现云数据库读写权限
May 17 #Javascript
ES6中的class是如何实现的(附Babel编译的ES5代码详解)
May 17 #Javascript
微信小程序云开发实现数据添加、查询和分页
May 17 #Javascript
js常用正则表达式集锦
May 17 #Javascript
Angular请求防抖处理第一次请求失效问题
May 17 #Javascript
vue cli 3.0 搭建项目的图文教程
May 17 #Javascript
You might like
php header()函数使用说明
2008/07/10 PHP
php数字游戏 计算24算法
2012/06/10 PHP
php实现在线通讯录功能(附源码)
2016/05/13 PHP
可自己添加html的伪弹出框实现代码
2013/09/08 Javascript
常见的原始JS选择器使用方法总结
2014/04/09 Javascript
AngularJS中取消对HTML片段转义的方法例子
2015/01/04 Javascript
js电话号码验证方法
2015/09/28 Javascript
jQuery无刷新切换主题皮肤实例讲解
2015/10/21 Javascript
jQuery简单实现列表隐藏和显示效果示例
2016/09/12 Javascript
JS+Canvas实现的俄罗斯方块游戏完整实例
2016/12/12 Javascript
微信小程序 switch组件详解及简单实例
2017/01/10 Javascript
微信小程序 弹窗自定义实例代码
2017/03/08 Javascript
JavaScript标准对象_动力节点Java学院整理
2017/06/27 Javascript
小程序实现发表评论功能
2018/07/06 Javascript
详解JavaScript的this指向和绑定
2020/09/08 Javascript
[01:10]DOTA2次级职业联赛 - Fly战队宣传片
2014/12/01 DOTA
python中 ? : 三元表达式的使用介绍
2013/10/09 Python
纯Python开发的nosql数据库CodernityDB介绍和使用实例
2014/10/23 Python
Python中optparse模块使用浅析
2015/01/01 Python
python base64 decode incorrect padding错误解决方法
2015/01/08 Python
Python 判断是否为质数或素数的实例
2017/10/30 Python
python实现识别手写数字 python图像识别算法
2020/03/23 Python
tensorflow入门之训练简单的神经网络方法
2018/02/26 Python
使用11行Python代码盗取了室友的U盘内容
2018/10/23 Python
python 字典 setdefault()和get()方法比较详解
2019/08/07 Python
PyCharm2019安装教程及其使用(图文教程)
2019/09/29 Python
Python HTMLTestRunner如何下载生成报告
2020/09/04 Python
体验完美剃须:The Art of Shaving
2018/08/06 全球购物
德国珠宝和配件商店:Styleserver
2021/02/23 全球购物
山海经纬软件测试笔试题和面试题
2013/04/02 面试题
网络工程师自荐书范文
2014/04/01 职场文书
发票退票证明
2015/06/24 职场文书
2016年“12.4”法制宣传日活动总结
2016/04/01 职场文书
Python图片检索之以图搜图
2021/05/31 Python
浅析MongoDB之安全认证
2021/06/26 MongoDB
python如何利用cv2.rectangle()绘制矩形框
2022/12/24 Python