89 lines
1.9 KiB
Markdown
89 lines
1.9 KiB
Markdown
---
|
||
title: WEB API 设计
|
||
order: 2
|
||
toc: menu
|
||
nav:
|
||
title: 核心
|
||
order: 2
|
||
---
|
||
|
||
# WEB API 设计
|
||
|
||
<Alert title="注意" type="warning">
|
||
以下各代码片段，仅供阅读参考，可能与实际代码略有偏差。
|
||
</Alert>
|
||
|
||
和常规的 MVC 思路不同，NocoBase 的 Server 非常简单，先来一段简单例子代码感受一下：
|
||
|
||
```ts
|
||
import { Application } from '@nocobase/server';
|
||
|
||
const api = new Application({
|
||
database: {},
|
||
resourcer: {},
|
||
});
|
||
|
||
// 配置数据表
|
||
api.database.table({
|
||
name: 'users',
|
||
fields: [
|
||
{ type: 'string', name: 'username' },
|
||
{ type: 'password', name: 'password' },
|
||
],
|
||
});
|
||
|
||
api.listen(3000);
|
||
```
|
||
|
||
相对应的 HTTP API：
|
||
|
||
```bash
|
||
GET http://localhost:3000/api/users
|
||
POST http://localhost:3000/api/users
|
||
GET http://localhost:3000/api/users/1
|
||
PUT http://localhost:3000/api/users/1
|
||
DELETE http://localhost:3000/api/users/1
|
||
```
|
||
|
||
内置了基础的 REST API，除此之外还可以自行扩展，如：
|
||
|
||
```ts
|
||
api.resourcer.registerAction('users:login', async (ctx, next) => {
|
||
// 代码省略
|
||
});
|
||
```
|
||
|
||
HTTP API 新增了扩展
|
||
|
||
```bash
|
||
POST http://localhost:3000/api/users:login
|
||
```
|
||
|
||
配合 SDK 就是这样的了
|
||
|
||
```ts
|
||
// 常用的 REST API
|
||
|
||
// GET http://localhost:3000/api/users
|
||
api.resource('users').list();
|
||
// POST http://localhost:3000/api/users
|
||
api.resource('users').create();
|
||
// GET http://localhost:3000/api/users/1
|
||
api.resource('users').get();
|
||
// PUT http://localhost:3000/api/users/1
|
||
api.resource('users').update();
|
||
// DELETE http://localhost:3000/api/users/1
|
||
api.resource('users').destroy();
|
||
|
||
// 扩展的非 REST 风格的 API
|
||
|
||
// POST http://localhost:3000/api/users:login
|
||
api.resource('users').login();
|
||
// POST http://localhost:3000/api/users:register
|
||
api.resource('users').register();
|
||
// POST http://localhost:3000/api/users:logout
|
||
api.resource('users').logout();
|
||
// POST http://localhost:3000/api/users:export
|
||
api.resource('users').export();
|
||
```
|