云开发官方文档
一个小程序在开发时,除了考虑界面功能逻辑外,还需要后端的数据支持。而为了获得后端的数据支持,开发者需要提前考虑服务器、存储和数据库等需求,并且会花费时间精力在部署应用、依赖上。因此官方为了实现小程序的快速上线和迭代,为开发者提供了一个云开发的功能,将以服务的方式为开发者提供如云函数、数据库、存储管理等所需功能,大大降低了小程序的开发门槛,仅需通过小程序云开发提供的接口,就能实现因缺乏后端知识而无法实现的需求。本章内容将简单讲解如何使用小程序云开发
tip:创建项目之前大家需要注意以下几点:
- 如果您有多个云开发id 需要选择其中一个在全局app.js中绑定
- 创建node云函数之前需要选择当前环境
- node云函数创建完成后需 上传并部署:云安装并依赖(只在新建时操作)
- 每次修改完云函数后 需右键 云函数增量上传
图例
全局app.js中绑定id
云函数index.js也要绑定id
云数据库id查看
选择环境
上传并部署
增量上传
tip:每次修改云函数文件夹是 增量上传 并刷新
//调用云函数
wx.cloud.callFunction({name,data})
sendFeed(){
console.log("发表留言");
// 执行云函数
wx.cloud.callFunction({
name:"addFeed", //云函数的名称
data:{ //data传递的参数
msg:this.data.msg, //留言信息
userInfo:wx.getStorageSync('userInfo'),//用户信息
}
})
.then(res=>{
console.log(res)
// 获取留言
this.getFeedback()
// 更新msg
this.setData({msg:""})
})
.catch(err=>{
console.log(err)
})
},
到这里基础的获取云数据的操作就完成了
var db = cloud.database();
var data = await db.collection("feedback").get()
var data = await db.collection("feedback").add(
data:{添加数据}
)
完整代码(这是一个发送留言的案例)
feedback/index.js代码
// 云函数入口文件
const cloud = require('wx-server-sdk')
cloud.init({env: 'cloud1-3gqtnkb6095e983c'}) // 使用当前云环境
// 定义数据库
const db =cloud.database()
// 云函数入口函数
exports.main = async (event, context) => {
// wx的上下文信息
const wxContext = cloud.getWXContext()
// event调用函数时传递的参数
// 获取集合feedback的数据 云端集合的名字
// get获取数据
// awiat等待
const data = await db.collection("feedback").get({
data: {
msg: event.msg,
datatime: new Date(),
userInfo:event.userInfo,
},
})
return {
data:data.data, //返回数据集合
event,
sum:event.a+event.b, //返回a+b结果
openid: wxContext.OPENID, //openid与appid
appid: wxContext.APPID,
unionid: wxContext.UNIONID,
}
}
addfeed/index.js代码
// 云函数入口文件
const cloud = require('wx-server-sdk')
cloud.init({env: 'cloud1-3gqtnkb6095e983c'}) // 使用当前云环境
// 定义数据库
const db =cloud.database()
// 云函数入口函数
exports.main = async (event, context) => {
// wx的上下文信息
const wxContext = cloud.getWXContext()
// event调用函数时传递的参数
// 获取集合feedback的数据 云端集合的名字
// get获取数据
// awiat等待
const data = await db.collection("feedback").add({
data: {
msg: event.msg,
datetime: new Date(),
userInfo:event.userInfo,
},
})
return {
data:data.data, //返回数据集合
event,
sum:event.a+event.b, //返回a+b结果
openid: wxContext.OPENID, //openid与appid
appid: wxContext.APPID,
unionid: wxContext.UNIONID,
}
}
页面home.wxml代码
<view>
<textarea value="{{msg}}" style="background-color: #e784c9;" bindinput="inputHd"/>
<button type="primary" bindtap="addFeed">发表button>
view>
<view class="list">
<view wx:for="{{list}}" wx:key="_id">
<view>
<image src="{{item.userInfo.avatarUrl}}" style="width: 33px; height: 33px;" mode=""/>
<text>{{item.userInfo.nickName}}text>
<text>{{item.datetime}}text>
view>
<view> {{item.msg}} view>
view>
view>
页面home.js代码
// pages/home/home.js
const {formatDate} =require("../utils/index")
Page({
/**
* 页面的初始数据
*/
data: {
list:[],//用户信息
msg:"",
},
inputHd(e){
// textarea与msg双向绑定
this.setData({msg:e.detail.value})
},
addFeed(){
// 获取本地用户信息
const userInfo=wx.getStorageSync('userInfo')
// 如果有用户信息
if(userInfo&&userInfo.nickName){
// 直接发表留言
this.sendFeed()
}else{
// 否则 先获取用户头像
wx.getUserProfile({
desc: '获取用户头像',
success:(res)=>{
// 存储用户头像信息
wx.setStorageSync('userInfo',res.userInfo)
// 然后发表留言
this.sendFeed()
}
})
}
},
sendFeed(){
console.log("发表留言");
// 执行云函数
wx.cloud.callFunction({
name:"addFeed", //云函数的名称
data:{ //data传递的参数
msg:this.data.msg, //留言信息
userInfo:wx.getStorageSync('userInfo'),//用户信息
}
})
.then(res=>{
console.log(res)
// 获取留言
this.getFeedback()
// 更新msg
this.setData({msg:""})
})
.catch(err=>{
console.log(err)
})
},
/**
* 生命周期函数--监听页面加载
*/
onLoad(options) {
this.getFeedback()
},
getFeedback(){
wx.cloud.callFunction(
{name:"feedback",data:{a:3,b:2}}
)
.then(res=>{
console.log(res)
this.setData({list:res.result.data.map(item=>({...item,datetime:formatDate(item.datetime,"-")}))})
})
.catch(err=>
console.error(err)
)
},
搜索官方文档
指定查询条件,返回带新查询条件的新的集合引用
//搜索语法
db.collection('todos').where({
_openid: 'user-open-id',
done: false
})
.get({
success: function(res) {
// res.data 是包含以上定义的两条记录的数组
console.log(res.data)
}
})
分页官方文档
Collection.skip指定查询返回结果时从指定序列后的结果开始返回,常用于分页
//分页语法
db.collection('todos').skip(10)
.get()
.then(console.log)
.catch(console.error)
排序官方文档
Aggregate.sort()根据指定的字段,对输入的文档进行排序
sort({
<字段名1>: <排序规则>,
<字段名2>: <排序规则>,
})
//排序规则>可以是以下取值:
//1 代表升序排列(从小到大);
//-1 代表降序排列(从大到小)