Uni-Cloud

uniCloud 是 DCloud 推出的 Serverless 云开发平台,基于 uni-app 一套代码多端发布的体系,让开发者无需自建服务器,即可在云端编写云函数、操作数据库,并直接在前端发起调用。

其**核心理念是「前端即后端」**:把云函数、数据库与前端调用封装在同一工程内,使前端工程师也能独立完成全栈业务,显著降低中小项目的协作与运维成本。

传统后端开发需要单独搭建服务器、设计接口、维护数据库与运维,前后端协作链路长;uniCloud 以云函数和 JQL 的形式将这些能力直接交给前端,省去服务端搭建与联调环节。
uniCloud · DCloud ## 1. 概述 uniCloud 是 DCloud 推出的 Serverless 云开发平台,基于 uni-app 一套代码多端发布的体系,让开发者无需自建服务器,即可在云端编写云函数、操作数据库,并直接在前端发起调用。其核心理念是「前端即后端」:把云函数、数据库与前端调用封装在同一工程内,使前端工程师也能独立完成全栈业务。本文从新建项目、云函数到数据库操作、云对象、Schema 与 JQL,系统讲解 uniCloud 的全栈开发能力。 ## 2. 新建项目 > 使用 HBuilder 构建项目,并且勾选 uni-cloud 选项。 > 关联服务空间。 ## 3. 新建云函数 在 `uniCloud/cloudfunctions` 目录下构建云函数: - `index.js` —— 类似 mapper 和 Controller,处理请求逻辑。 - `package.json` —— 引入依赖。
exports.main = async (event, context) => {
  return "firstproject";
};
### 2.1 发起请求
onLoad() {
    uniCloud.callFunction({
        name:"MycloudFunction"
    }).then(res=>{
        console.log(res);
    })
},
## 4. Uni-Cloud ### 3.1 event 传递参数 **发送数据:**
onLoad() {
    uniCloud.callFunction({
        name:"MycloudFunction",
        data:{
            name:"zs",
            age:'18'
        }
    }).then(res=>{
        console.log(res);
    })
},
**接收数据:**
exports.main = async (event, context) => {
 	let {name,age} = event;
 	return `姓名${name},年龄${age}`;
};
### 3.2 连接并读取数据库 **连接数据库:**
'use strict';
const db = uniCloud.database()
exports.main = async (event, context) => {
 	let result = await db.collection("user").get();
 	return result;
};
**前端获取数据库内容:**
uniCloud.callFunction({
    name:"CloudDemo1",
    data:{}
}).then(res => {
    console.log(res);
})
### 3.3 count 统计
let result = await db.collection("user").count();
### 3.4 批量添加
let result = await db.collection("user").add({
    name:"ls",
    gender:"0"
});
### 3.5 将表单数据传输到数据库 **HTML:**
<template>
  <view>
    <form @submit="onsubmit">
      <input type="text" placeholder="请输入年龄" name="name"/>
      <input type="text" placeholder="请输入电话" name="tel"/>
      <button form-type="submit">提交</button>
    </form>
  </view>
</template>
**JS:**
<script setup>
import {ref} from "vue";
let obj = ref(null);
const onsubmit = (e)=>{
  obj.value =  e.detail.value;
  console.log(obj.value)
  uniCloud.callFunction({
    name:"MycloudFunction",
    data:obj.value
  }).then(res=>{
    console.log(res);
  })
}
</script>
**云函数:**
'use strict';
const db = uniCloud.database();
exports.main = async (event, context) => {
 	let {name,tel} = event;
 	let result = await db.collection("user").add({
 		name,
 		tel
 	});
 	return result;
};
## 5. 查询数据库 ### 4.1 条件查询
'use strict';
const db = uniCloud.database();
exports.main = async (event, context) => {
 	//doc(ID值)
 	let result = await db.collection("user").doc("667fed48213929f8662e8cec").get();
 	//限制获取的数据的数量
 	let result = await db.collection("user").limit(10).get();
 	//跳过前n条数据
 	let result = await db.collection("user").skip(5).get();
 	//asc顺序 desc倒序
 	let result = await db.collection("user").orderBy("_id","desc").get();
 	//过滤掉不需要的字段
 	let result = await db.collection("user").field("name":true).get();
 	return result;
};
**条件查询常用链式方法** 通过 `doc()`、`limit()`、`skip()`、`orderBy()`、`field()` 等链式方法,可灵活控制查询的范围、数量、排序与字段投影。
### 4.2 Where 查询
let result = await db.collection("user").where({
    _id:"667fea238a5c7863b10600e7"
}).get();
### 4.3 Command
const dbCmd = db.command;

let result = await db.collection("user").where({
    age:dbCmd.eq(30);
}).get();
### 4.4 正则查询
let result = await db.collection("user").where({
    name:/^z/g
    //i =>不区分大小写 g全局检索
  name: new RegExp(keyword,"ig")
}).get();
### 4.5 update 更新
let result = await db.collection("user").doc("667fed48213929f8662e8cec").update({
    name:"ww",
    age:34
});
### 4.6 更新操作符
//向前追加
likes:dbCmd.unshift(["1","2"])
//向后追加
likes:dbCmd.push(["1","2"])
//尾删
likes:dbCmd.pop("1");
//前删
likes:dbCmd.shift("1");
//点赞阅读数+1
likes:dbCmd.inc(1);
//自乘
likes:dbCmd.mul(10);
| 操作符 | 作用 | | ---- | ---- | | `dbCmd.unshift(["1","2"])` | 向前追加 | | `dbCmd.push(["1","2"])` | 向后追加 | | `dbCmd.pop("1")` | 尾删 | | `dbCmd.shift("1")` | 前删 | | `dbCmd.inc(1)` | 点赞/阅读数 +1 | | `dbCmd.mul(10)` | 自乘 | ### 4.7 set 与 update 的区别 > set 会覆盖,update 不会覆盖。
like:dbCmd.set({
    name:"ll",
    age:45
});
### 4.8 remove 删除 > 指定 id,使用 where。
let result = await db.collection("user").where({
    _id:"667fea238a5c7863b10600e7"
}).remove();
## 6. 云对象 ### 5.1 定义
const db = uniCloud.database();
module.exports = {
  _before: function () { // 通用预处理器

  },
  get(){
    return await db.collection("article").get();
  }
}
### 5.2 使用
const myObject = uniCloud.importObject("myObject");
myObject.get().then(res=>{
    console.log(res);
})
### 5.3 传递参数
myObject.get(3).then(res=>{
    console.log(res);
})
## 7. Schema ### 6.1 Schema 概述 每张表/集合,都有一个表名 `.schema.json` 的文件,用于描述表的信息、字段的信息。
{
  "bsonType": "object", // 固定节点
  "description": "该表的描述",
  "required": [], // 必填字段列表
  "properties": { // 该表的字段清单
    "_id": { // 字段名称,每个表都会带有_id字段
      "description": "ID,系统自动生成"
      // 这里还有很多字段属性可以设置
    },
    "field2": { // 字段2,每个表都会带有_id字段
      "description": ""
      // 这里还有很多字段属性可以设置
    }
  }
}
### 6.2 使用
//在非云函数使用
const db = uniCloud.database();
db.collection("article").get().then(res=>{
  console.log(res);
});
### 6.3 基本属性
{
  "bsonType": "object",
     //必填项
  "required": [],
     //权限
  "permission": {
    "read": false,
    "create": false,
    "update": false,
    "delete": false
  },
     //字段
  "properties": {
    "_id": {
      "description": "ID,系统自动生成"
    }
  }
}
使用 Schema 规范表结构:
{
  "bsonType": "object",
  "required": ["name", "birth_year", "tel", "email"],
  "permission": {
    "read": true,
    "create": true,
    "update": true,
    "delete": true
  },
  "properties": {
    "_id": {
      "description": "ID,系统自动生成"
    },
    "name": {
      "bsonType": "string",
      "title": "姓名",
      "trim": "both",
      "minLength": 2,
      "maxLength": 17
    },
    "birth_year": {
      "bsonType": "int",
      "title": "出生年份",
      "minimum": 1950,
      "maximum": 2020
    },
    "tel": {
      "bsonType": "string",
      "title": "手机号码",
      "pattern": "^\\+?[0-9-]{3,20}$",
      "trim": "both"
    },
    "email": {
      "bsonType": "string",
      "title": "email",
      "format": "email",
      "trim": "both"
    },
    "address": {
      "bsonType": "object",
      "title": "地址",
      "required": ["city"],
      "properties": {
        "city": {
          "bsonType": "string",
          "title": "城市"
        },
        "street": {
          "bsonType": "string",
          "title": "街道",
          "trim": "both"
        }
      }
    },
    "intro":{
      "bsonType": "string",
      "title": "简介",
      "trim": "both"
    }
  }
}
## 8. JQL 数据库操作 ### 7.1 新增 仅允许 `collection().add()` 这样的形式。 ### 7.2 修改
db.collection('xx').doc('xxx').update({})
db.collection('xx').where('xxxx').update({})
### 7.3 删除
db.collection('xx').doc('xxx').remove()
db.collection('xx').where('xxxx').remove()
### 7.4 field 过滤
let message = db.collection("article").field("title,content,userid").getTemp();
let users = db.collection("uni-id-users").field("_id,username").getTemp();
db.collection(message,users).get().then(res=>{
    /* console.log(res.result.data); */
    listArr.value = res.result.data;
})
"userid":{
    "title": "用户id",
    "bsonType": "string",
    //要添加外键关联
    "foreignKey": "uni-id-users._id",
    "description": "用户的id",
    "defaultValue":{
        "$env": "uid"
    }
}
### 7.5 as 别名
let users = db.collection("uni-id-users").field("_id,username as name,avatar_file").getTemp();
### 7.6 limit > 使用 limit 限制查询的数量。 ### 7.7 getone 过滤 > 只查一条数据。 ## 9. unicloud-db 前端组件的使用 [unicloud-db组件简介 | uniCloud (dcloud.net.cn)](https://doc.dcloud.net.cn/uniCloud/unicloud-db.html)
<unicloud-db v-slot:default="{data, loading, error, options}" collection="table1" field="field1" :getone="true" where="id=='1'">
  <view>
    {{ data}}
  </view>
</unicloud-db>
**快速接入** 借助 `unicloud-db` 组件,前端页面可通过声明式属性(`collection`、`field`、`where`、`getone`)直接绑定云端数据,无需手动编写云函数调用。
--- > **一句话总结**:uniCloud 通过云函数、JQL 与 unicloud-db 组件,让前端开发者无需自建后端即可完成数据库的增删改查与全栈业务开发。