代码拉取完成，页面将自动刷新
同步操作将从 DCloud/uni-cloud-router 强制同步，此操作会覆盖自 Fork 仓库以来所做的任何修改，且无法恢复！！！
确定后同步将在后台操作，完成时将刷新页面，请耐心等待。
基于 koa 风格的 uniCloud 云函数路由库，同时支持 uniCloud 客户端及 URL 化访问
npm install --save uni-cloud-router
├── package.json
├── index.js // 云函数入口文件
├── config.js // 用于配置 router 应用根目录、中间件等
├── controller // 用于解析用户的输入，处理后返回相应的结果
| ├── user.js
├── service (可选) //用于编写业务逻辑层，建议使用
| ├── user.js
// index.js (通常无需改动)
const Router = require('uni-cloud-router').Router // 引入 Router
const router = new Router(require('./config.js')) // 根据 config 初始化 Router
exports.main = async (event, context) => {
return router.serve(event, context) // 由 Router 接管云函数
}
// config.js
module.exports = {
debug: true, // 调试模式时，将返回 stack 错误堆栈
baseDir: __dirname, // 必选，应用根目录
middleware: [], // 自定义中间件
}
// controller/user.js
const uniID = require('uni-id')
const Controller = require('uni-cloud-router').Controller
// 必须继承 Controller
module.exports = class UserController extends Controller {
async login() {
const { username, password } = this.ctx.data // 获取请求参数
// 使用 uni-id 登录
return uniID.login({
username,
password,
})
}
}
负责解析用户的输入，处理后返回相应的结果。
推荐 Controller 层主要对用户的请求参数进行处理（校验、转换），然后调用对应的 service 方法处理业务，得到业务结果后封装并返回：
所有的 Controller 文件都必须放在 controller 目录下，可以支持多级目录，访问的时候可以通过目录名级联访问。
// controller/post.js
const Controller = require('uni-cloud-router').Controller
// 必须继承 Controller 类
module.exports = class PostController extends Controller {
async create() {
const { ctx, service } = this
// 校验参数
ctx.validate({
title: { type: 'string' },
content: { type: 'string' },
})
// 组装参数
const author = ctx.auth.uid
const post = Object.assign(ctx.data, { author })
// 调用 Service 进行业务处理
return service.post.create(post)
}
}
定义的 Controller 类，会在每一个请求访问时实例化一个全新的对象，会有下面几个属性挂在 this 上。
this.ctx：当前请求的上下文对象的实例，通过它我们可以拿到各种便捷属性和方法。this.service：应用定义的 service，通过它我们可以访问到抽象出的业务层，等同于 this.ctx.service。this.db：等同于 uniCloud.database()。this.curl：等同于 uniCloud.httpclient.request。this.throw：抛出异常信息，等同于 this.ctx.throw。通过在 Controller 上绑定的 Context 实例的 data 属性，获取请求发送过来的参数
class PostController extends Controller {
async listPosts() {
const data = this.ctx.data
// {
// username: 'demo',
// password: 'demo',
// }
}
}
通过 Service 层进行业务逻辑的封装，不仅能提高代码的复用性，同时可以让业务逻辑更好测试。
Controller 中可以调用任何一个 Service 上的任何方法，同时 Service 是懒加载的，只有当访问到它的时候才会去实例化它。
class PostController extends Controller {
async create() {
const { ctx, service } = this
const author = ctx.auth.uid
const post = Object.assign(ctx.data, { author })
// 调用 service 进行业务处理
return service.post.create(post)
}
}
Service 的具体写法，请查看 Service 章节。
class PostController extends Controller {
async create() {
// 设置状态码为 201
this.ctx.status = 201 // 仅当使用 HTTP/HTTPS 请求时生效
}
}
业务逻辑封装的一个抽象层，有以下几个好处：
所有的 Service 文件都必须放在 service 目录下，可以支持多级目录，访问的时候可以通过目录名级联访问。
// service/post.js
const Service = require('uni-cloud-router').Service
// 必须继承 Service
module.exports = class PostService extends Service {
async create(data) {
return this.db.add(data)
}
}
定义的 Service 类是懒加载的，只有当访问到它的时候才会去实例化它，会有下面几个属性挂在 this 上。
this.ctx：当前请求的上下文对象的实例，通过它我们可以拿到各种便捷属性和方法。this.service：应用定义的 service，通过它我们可以访问到抽象出的业务层，等同于 this.ctx.service。this.db：等同于 uniCloud.database()。this.curl：等同于 uniCloud.httpclient.request。this.throw：抛出异常信息，等同于 this.ctx.throw。在路由请求前，后添加处理逻辑，实现一些特定功能，如：用户登录，权限校验等
与 koa 保持一致，参考：koa 中间件
// middleware/auth.js
const uniID = require('uni-id')
module.exports = (options) => {
// 初始化 uniID 配置
uniID.init(options)
// 返回中间件函数
return async function auth(ctx, next) {
// 校验 token
const auth = uniID.checkToken(ctx.event.uniIdToken)
if (auth.code) {
// 校验失败，抛出错误信息
throw { code: auth.code, message: auth.message }
}
ctx.auth = auth // 设置当前请求的 auth 对象
await next() // 执行后续中间件
}
}
示例：
const auth = require('./middleware/auth.js') // 引入 auth 中间件
module.exports = {
debug: true, // 调试模式时，将返回 stack 错误堆栈
baseDir: __dirname, // 指定应用根目录
middleware: [
[
//数组格式，第一个元素为中间件，第二个元素为中间件生效规则配置
auth({ tokenSecret: 'tokenSecret-demo' }), // 注册中间件
{ enable: true, ignore: /\/login$/ }, // 配置当前中间件生效规则，该规则表示以`/login`结尾的路由不会执行 auth 中间件校验 token
],
],
}
enable 控制中间件是否开启。
match 设置只有符合某些规则的请求才会经过这个中间件。
支持类型：
ignore 设置符合某些规则的请求不经过这个中间件。
支持类型：同 match
Context 是一个请求级别的对象，在每一次收到用户请求时，会实例化一个 Context 对象，这个对象封装了这次用户请求的信息，并提供了许多便捷的方法来获取请求参数或者设置响应信息。框架会将所有的 Service 挂载到 Context 实例上
最常见的 Context 实例获取方式是在 Middleware, Controller 以及 Service 中。
// 在 Controller 中通过 this.ctx 获取 Context 实例
module.exports = class UserController extends Controller {
async login() {
const data = this.ctx.data // 从 Context 实例上获取请求参数
}
}
// 在 Service 中通过 this.ctx 获取 Context 实例
module.exports = class PostService extends Service {
async create(data) {
const auth = this.ctx.auth // 从 Context 实例上获取 auth(需要启用 uni-id 中间件)
}
}
// 在 Middleware 中通过 ctx 参数获取 Context 实例
module.exports = (options) => {
// 返回中间件函数
return async function auth(ctx, next) {
const data = ctx.data // 从 Context 实例上获取请求参数
await next()
}
}
// 使用 uniCloud 访问
uniCloud.callFunction({
name: 'router', // 要调用的云函数名称
data: {
action: 'user/login', // 路由地址，对应 controller 下 user.js 的 login 方法
// 参数列表
data: {
// controller 通过 this.ctx.data 获取
username: 'demo',
password: 'demo',
},
},
})
// 使用 URL 化 request 访问
uni.request({
url: 'xxxxx/router/user/login', // 路由地址，对应 controller 下 user.js 的 login 方法
data: {
// controller 通过 this.ctx.data 获取
username: 'demo',
password: 'demo',
},
})
{
"code": "", // 异常 code，如："INVOKE_FUNCTION_FAILED"
"message": "", // 异常信息
"stack": "" // 当 config.js 中配置 debug 为 true 时，返回发生异常的堆栈信息
// 其他信息
}
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。