5
5
6
6
1、表名全部小写,单词间通过'_ '间隔
7
7
8
- 2、主键命名为'id',pg库类型为serial自增长主键,会默认创建名为 [ 表名_id_seq ] 的序列
8
+ 2、主键命名为'id',varchar(20),不使用数据库的序列,应用生成全局序列。
9
9
10
10
3、必须包含4个审计字段且不能为空。created_time、updated_time、created_by、updated_by。
11
11
32
32
| 手机电话| varchar | 20 | |
33
33
| 描述简介| varchar | 500 | |
34
34
| 网址类 | varchar | 500 | 如url |
35
- | 时间类 | timestamp | | |
35
+ | 时间类 | datetime | | |
36
36
37
37
38
38
## URL和方法命名规范
@@ -46,23 +46,23 @@ CRUD 简单 URI:
46
46
47
47
| 方法 | URL | 功能 |
48
48
| --------| -----------| ------------------|
49
- | GET | /users | 获取用户列表 |
50
- | GET | /users /1 | 获取 id 为 1 的用户|
51
- | POST | /users | 创建一个用户 |
52
- | PUT | /users /1 | 替换 id 为 1 的用户|
53
- | PATCH | /users /1 | 修改 id 为 1 的用户|
54
- | DELETE | /users /1 | 删除 id 为 1 的用户|
49
+ | GET | /user | 获取用户列表 |
50
+ | GET | /user /1 | 获取 id 为 1 的用户|
51
+ | POST | /user | 创建一个用户 |
52
+ | PUT | /user /1 | 替换 id 为 1 的用户|
53
+ | PATCH | /user /1 | 修改 id 为 1 的用户|
54
+ | DELETE | /user /1 | 删除 id 为 1 的用户|
55
55
56
56
上面是对某一种资源进行操作的 URI,那如果是有关联的资源,或者称为级联的资源,该如何设计 URI 呢?比如某一用户下的产品:
57
57
58
58
| 方法 | URL | 功能 |
59
59
| --------| ---------------------| ------------------------------------|
60
- | GET | /users /1/products | 获取 Id 为 1 用户下的产品列表 |
61
- | GET | /users /1/products /2 | 获取 Id 为 1 用户下 Id 为 2 的产品 |
62
- | POST | /users /1/products | 在 Id 为 1 用户下,创建一个产品 |
63
- | PUT | /users /1/products /2 | 在 Id 为 1 用户下,替换 Id 为 2 的产品|
64
- | PATCH | /users /1/products /2 | 修改 Id 为 1 的用户下 Id 为 2 的产品 |
65
- | DELETE | /users /1/products /2 | 删除 Id 为 1 的用户下 Id 为 2 的产品 |
60
+ | GET | /user /1/product | 获取 Id 为 1 用户下的产品列表 |
61
+ | GET | /user /1/product /2 | 获取 Id 为 1 用户下 Id 为 2 的产品 |
62
+ | POST | /user /1/product | 在 Id 为 1 用户下,创建一个产品 |
63
+ | PUT | /user /1/product /2 | 在 Id 为 1 用户下,替换 Id 为 2 的产品|
64
+ | PATCH | /user /1/product /2 | 修改 Id 为 1 的用户下 Id 为 2 的产品 |
65
+ | DELETE | /user /1/product /2 | 删除 Id 为 1 的用户下 Id 为 2 的产品 |
66
66
67
67
### 方法命名规范
68
68
@@ -99,10 +99,10 @@ CRUD 简单 URI:
99
99
| 操作 | 例子 | 备注 |
100
100
| --------| ---------------------| ----------------------------------|
101
101
| 增加 | add | |
102
- | 获取 | get | 获取到单条记录 |
102
+ | 保存 | save | 更新,不存在则新增 |
103
103
| 删除 | remove/delete | |
104
+ | 获取 | get | 获取到单条记录 |
104
105
| 更新 | update | 更新存在的记录 |
105
- | 保存 | save | 更新,不存在则新增 |
106
106
| 查询 | query | 根据id等简单条件查询 |
107
107
| 搜索 | search | 根据时间范围或模糊搜索 |
108
108
0 commit comments