微信小程序云開發(fā) 搭建一個管理小程序

更新時間：2019年05月17日 15:45:44 作者：yunsiyu

這篇文章主要為大家詳細(xì)介紹了微信小程序云開發(fā)，搭建一個管理小程序，具有一定的參考價值，感興趣的小伙伴們可以參考一下

概述 :

開發(fā)者可以使用云開發(fā)開發(fā)微信小程序、小游戲，無需搭建服務(wù)器，即可使用云端能力。

云開發(fā)為開發(fā)者提供完整的云端支持，弱化后端和運(yùn)維概念，無需搭建服務(wù)器，使用平臺提供的 API 進(jìn)行核心業(yè)務(wù)開發(fā)，即可實現(xiàn)快速上線和迭代，同時這一能力，同開發(fā)者已經(jīng)使用的云服務(wù)相互兼容，并不互斥。

目前提供三大基礎(chǔ)能力支持：

云函數(shù)：在云端運(yùn)行的代碼，微信私有協(xié)議天然鑒權(quán)，開發(fā)者只需編寫自身業(yè)務(wù)邏輯代碼
數(shù)據(jù)庫：一個既可在小程序前端操作，也能在云函數(shù)中讀寫的 JSON 數(shù)據(jù)庫
存儲：在小程序前端直接上傳/下載云端文件，在云開發(fā)控制臺可視化管理

創(chuàng)建項目:

新建項目選擇一個空目錄，填入 AppID（使用云開發(fā)能力必須填寫 AppID），勾選創(chuàng)建 “云開發(fā) QuickStart 項目”，點(diǎn)擊創(chuàng)建即可得到一個展示云開發(fā)基礎(chǔ)能力的示例小程序。

項目結(jié)構(gòu)如下:

開通云服務(wù):

點(diǎn)擊云開發(fā) , 打開云開發(fā)控制臺,云開發(fā)控制臺提供如下能力(云函數(shù)中對數(shù)據(jù)庫的操作等同于在控制臺直接操作數(shù)據(jù)庫)

概覽：查看云開發(fā)基礎(chǔ)使用數(shù)據(jù)
用戶管理：查看小程序用戶信息
數(shù)據(jù)庫：管理數(shù)據(jù)庫，可查看、增加、更新、查找、刪除數(shù)據(jù)、管理索引、管理數(shù)據(jù)庫訪問權(quán)限等
存儲管理：查看和管理存儲空間
云函數(shù)：查看云函數(shù)列表、配置、日志和監(jiān)控
統(tǒng)計分析：查看云開發(fā)資源具體使用統(tǒng)計信息

基礎(chǔ)方法(基本涵蓋小程序云開發(fā)常用的定義和方法):

小程序調(diào)用云函數(shù)示例:

// Callback 風(fēng)格調(diào)用
wx.cloud.callFunction({
 // 要調(diào)用的云函數(shù)名稱
 name: 'add',
 // 傳遞給云函數(shù)的參數(shù)
 data: {
 x: 1,
 y: 2,
 },
 success: res => {
 // output: res.result === 3
 },
 fail: err => {
 // handle error
 },
 complete: () => {
 // ...
 }
})
 
// Promise 風(fēng)格調(diào)用
wx.cloud.callFunction({
 // 要調(diào)用的云函數(shù)名稱
 name: 'add',
 // 傳遞給云函數(shù)的event參數(shù)
 data: {
 x: 1,
 y: 2,
 }
}).then(res => {
 // output: res.result === 3
}).catch(err => {
 // handle error
})

小程序調(diào)用數(shù)據(jù)庫示例:

// 1. 獲取數(shù)據(jù)庫引用
const db = wx.cloud.database()
// 2. 構(gòu)造查詢語句
// collection 方法獲取一個集合的引用
// where 方法傳入一個對象，數(shù)據(jù)庫返回集合中字段等于指定值的 JSON 文檔。API 也支持高級的查詢條件（比如大于、小于、in 等），具體見文檔查看支持列表
// get 方法會觸發(fā)網(wǎng)絡(luò)請求，往數(shù)據(jù)庫取數(shù)據(jù)
db.collection('books').where({
publishInfo: {
country: 'United States'
}
}).get({
success: function(res) {
// 輸出 [{ "title": "The Catcher in the Rye", ... }]
console.log(res)
}
})

小程序存儲調(diào)用示例:

// 讓用戶選擇一張圖片
wx.chooseImage({
success: chooseResult => {
// 將圖片上傳至云存儲空間
wx.cloud.uploadFile({
// 指定上傳到的云路徑
cloudPath: 'my-photo.png',
// 指定要上傳的文件的小程序臨時文件路徑
filePath: chooseResult.tempFilePaths[0],
// 成功回調(diào)
success: res => {
console.log('上傳成功', res)
},
})
},
})

云函數(shù)的定義:

// index.js 是入口文件，云函數(shù)被調(diào)用時會執(zhí)行該文件導(dǎo)出的 main 方法
// event 包含了調(diào)用端（小程序端）調(diào)用該函數(shù)時傳過來的參數(shù)，同時還包含了可以通過 getWXContext 方法獲取的用戶登錄態(tài) `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
}
}

云函數(shù)中操作數(shù)據(jù)庫

以下調(diào)用獲取默認(rèn)環(huán)境的數(shù)據(jù)庫的引用：

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

假設(shè)有一個環(huán)境名為 test，用做測試環(huán)境，那么可以如下獲取測試環(huán)境數(shù)據(jù)庫：

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

也可以通過 init 傳入默認(rèn)環(huán)境的方式使得獲取數(shù)據(jù)庫時默認(rèn)是默認(rèn)環(huán)境數(shù)據(jù)庫：

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集合

云開發(fā)實踐:

(使用小程序云開發(fā)實現(xiàn)一個可以增刪改查的設(shè)備管理平臺)

1: 需求分析:

設(shè)備管理現(xiàn)狀: 部門有大量安卓/蘋果測試機(jī)和測試硬件設(shè)備 , 當(dāng)前管理現(xiàn)狀混亂 , 管理員使用紙質(zhì)表格和excel對每次的出借情況進(jìn)行記錄 , 當(dāng)有同事需要測試設(shè)備的時候 , 需要聯(lián)系管理員 , 管理員查閱表格 , 找到最后借用人進(jìn)行協(xié)調(diào) , 并登記在冊
管理痛點(diǎn): 管理員需要通過翻閱借用記錄表去了解設(shè)備現(xiàn)狀 , 并協(xié)調(diào)資源 , 增加了工作量 , 普通員工無法知道設(shè)備出借現(xiàn)狀 , 獲取設(shè)備環(huán)節(jié)復(fù)雜;
考勤管理現(xiàn)狀: 管理員通過excel表格匯總考勤情況 , 并逐月發(fā)送到員工郵箱 , 員工需要下載csv文件去查看考勤
考勤管理痛點(diǎn): 對于員工 , 通過查看excel十分不便
需求總結(jié): 普通員工通過查看設(shè)備現(xiàn)狀 , 找到可以狀態(tài)的設(shè)備 , 并匯報管理員 , 管理員通過小程序切換設(shè)備狀態(tài) , 綁定使用人 ; 管理員逐月導(dǎo)入考勤數(shù)據(jù) , 員工可通過小程序查看個人考勤情況;

2: 項目構(gòu)建

ui庫使用iview weapp
小程序端(前端)對數(shù)據(jù)庫的操作權(quán)限是嚴(yán)格按照控制臺中配置的權(quán)限 , 云函數(shù)則擁有所有權(quán)限(云函數(shù)中對數(shù)據(jù)庫的操作等同于在云開發(fā)控制臺中進(jìn)行數(shù)據(jù)庫操作),所以本項目中所有的關(guān)于數(shù)據(jù)庫的操作都將在云函數(shù)中處理 , 小程序端只作為視圖層 , 并對無權(quán)限的界面和操作進(jìn)行視覺隔離

3: 建立集合

通過云函數(shù)控制臺建立需要的集合 , 并將excel/json文件導(dǎo)入到對應(yīng)的集合, 也可以直接手動建立

4: 核心功能的實現(xiàn)(以云函數(shù)操作數(shù)據(jù)庫為主)

小程序端>app.js

初始化云函數(shù) , 獲取已授權(quán)用戶信息 , 定義需要的全局?jǐn)?shù)據(jù)

//app.js
App({
 onLaunch: function () {
 const _this = this
 // 初始化云函數(shù)
 if (!wx.cloud) {
 console.error('請使用 2.2.3 或以上的基礎(chǔ)庫以使用云能力')
 } else {
 wx.cloud.init({
 traceUser: true,
 })
 }
 // 獲取用戶信息(針對已經(jīng)授權(quán)過的用戶,直接獲取用戶信息)
 wx.getSetting({
 success: res => {
 if (res.authSetting['scope.userInfo']) {
  // 已經(jīng)授權(quán)，可以直接調(diào)用 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: '', // 當(dāng)前用戶角色
 registerUser: {}, // 微信用戶綁定的用戶信息
 userindex: '', // 編輯設(shè)備和添加設(shè)備頁面,index索引選擇的值name
 userindexId: '',// 編輯設(shè)備和添加設(shè)備頁面,index索引選擇的值id
 currentQuerys: {
 type: ['iphone', 'android', 'ble'],
 user: []
 } // 設(shè)備管理篩選框篩選的結(jié)果
 }
 }
})

云函數(shù) > login (云函數(shù)條件查詢云數(shù)據(jù)庫)

以小程序open_id為查詢條件 , 在云函數(shù)user集合中查找綁定該open_id的數(shù)據(jù) , 為空表示該微信賬號未綁定用戶名

// 云函數(shù)入口文件
const cloud = require('wx-server-sdk')
cloud.init()
// 云函數(shù)入口函數(shù)
exports.main = async (event, context) => {
 const wxContext = cloud.getWXContext()
 // 調(diào)用數(shù)據(jù)庫獲取所有設(shè)備列表
 const db = cloud.database() // 獲取數(shù)據(jù)庫
 const _ = db.command // 獲取查詢指令
 const usersCollection = db.collection('users') // 獲取users集合
 const user = (await usersCollection.where({
 open_id: wxContext.OPENID // 根據(jù)唯一open_id在user集合中查找已綁定的用戶
 }).get())
 return {
 event,
 data: user,
 openid: wxContext.OPENID,
 appid: wxContext.APPID,
 unionid: wxContext.UNIONID,
 }
}

云函數(shù) > register (云函數(shù)修改數(shù)據(jù)庫數(shù)據(jù))

對于未綁定的微信號 , 需要將用戶選中的用戶名與當(dāng)前微信open_id綁定 , 完成注冊

// 云函數(shù)入口文件
const cloud = require('wx-server-sdk')
cloud.init()
// 云函數(shù)入口函數(shù)
exports.main = async (event, context) => {
 const wxContext = cloud.getWXContext()
 // 調(diào)用數(shù)據(jù)庫獲取所有設(shè)備列表
 const db = cloud.database() // 獲取數(shù)據(jù)庫
 const _ = db.command // 獲取查詢指令
 const usersCollection = db.collection('users') // 獲取users集合
 // 查詢條件
 let query = _.eq(event.id)
 // 
 try {
 await usersCollection.doc(event.id).update({
 // data 傳入需要局部更新的數(shù)據(jù)
 data: {
 open_id: wxContext.OPENID
 }
 })
 } catch (e) {
 console.log(e)
 }
 
 return {
 event,
 openid: wxContext.OPENID,
 appid: wxContext.APPID,
 unionid: wxContext.UNIONID,
 }
}

云函數(shù) > getEquipmentList (云函數(shù)查詢?nèi)繑?shù)據(jù) , 云函數(shù)按條件查詢數(shù)據(jù)庫)

獲取設(shè)備數(shù)據(jù)的時候存在多種情況

獲取全部數(shù)據(jù): 由于獲取數(shù)據(jù)庫有100條上限的限制 , 需要進(jìn)行特殊處理
按條件查詢數(shù)據(jù) : 需要提前拼接好查詢語句

// 云函數(shù)入口文件
const cloud = require('wx-server-sdk')
cloud.init()
// 云函數(shù)入口函數(shù)
exports.main = async (event, context) => {
 const wxContext = cloud.getWXContext()
 // 調(diào)用數(shù)據(jù)庫獲取所有設(shè)備列表
 const db = cloud.database() // 獲取數(shù)據(jù)庫
 const _ = db.command // 獲取查詢指令
 const equipmentCollection = db.collection('equipment') // 獲取equipment集合
 // 取所有集合中符合條件的數(shù)據(jù)(因為有默認(rèn) limit 100 條的限制,需要做特殊操作)
 const MAX_LIMIT = 100
 // 先取出集合記錄總數(shù)
 const countResult = await equipmentCollection.count()
 const total = countResult.total
 // 計算需分幾次取
 const batchTimes = Math.ceil(total / 100)
 // 承載所有讀操作的 promise 的數(shù)組
 const tasks = []
 let query = {}
 // 封裝設(shè)備類型查詢條件(直接通過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)
 }
 // 等待所有數(shù)據(jù)讀取完成
 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,
 }
}

云函數(shù) > removeEquipement (云函數(shù)刪除集合數(shù)據(jù))

// 云函數(shù)入口文件
const cloud = require('wx-server-sdk')
 
cloud.init()
 
// 云函數(shù)入口函數(shù)
exports.main = async (event, context) => {
 const wxContext = cloud.getWXContext()
 // 調(diào)用數(shù)據(jù)庫獲取所有設(shè)備列表
 const db = cloud.database() // 獲取數(shù)據(jù)庫
 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,
 }
}

項目截圖: