起源:my.oschina.net/tommylemon/blog/1574430
必定有不少人会想:这怎么可能呢?
就算用简直零配置的 SpringBoot,写 一个最简略的接口也得有 3 行代码 啊!
@RequestMapping("test/{request}")
public String test(@PathVariable String request) {return request + ": Hello World";}
举荐一个 Spring Boot 基础教程及实战示例:
https://github.com/javastacks…
那 8 个没啥用的 Hello World 接口就得 24 行代码了!
这还没算拼 SQL 连 JDBC 或者调用 ORM 库 的代码呢!
更不用说还要写 XML 配置 的其它库了!
没错,用传统形式就是这样。
获取一个用户:
base_url/get/user
获取一个用户列表:
base_url/get/user/list
获取一个评论:
base_url/get/comment
获取一个评论列表:
base_url/get/comment/list
…
仅仅是查问,一张表 (对应客户端的 model) 就要两个接口了,如果再加上增删改,批量改批量删,还有统计,那就得有 8 个接口了!
那么我是怎么解决的呢?
同一种类型的申请都只用一个接口:
增 base_url/post
删(包含批量)base_url/delete
改(包含批量)base_url/put
查(包含列表)base_url/get
统计 base_url/head
用最罕用的查问申请举例:
获取一个用户:
base_url/get/
获取一个用户列表:
base_url/get/
获取一个评论:
base_url/get
获取一个评论列表:
base_url/get
…
都是用同一个接口!我是怎么做到的呢?
APIJSON,对,就它!
咱们用 APIJSON 来操作一张表,例如用户表 User,代码写 3 行就够了:
// 注册表并增加权限,用默认配置
@MethodAccess
public class User {// 内容个别仅供表字段阐明及 Android App 开发应用,服务端不必的可不写。}
//Verifier 内增加权限
accessMap.put(User.class.getSimpleName(), getAccessMap(User.class.getAnnotation(MethodAccess.class)));
或者能够再定制下 POST 申请的角色权限:
@MethodAccess(POST = {UNKNOWN, ADMIN} // 只容许未登录角色和管理员角色新增 User,默认配置是 {LOGIN, ADMIN}
)
public class User {}
而后运行下 Server 工程就能够申请了:
URL:http://apijson.cn:8080/get
表单:
{
"User": {"id": 82001}
}
返回:
{
"User": {
"id": 82001,
"sex": 0,
"name": "Test",
"tag": "APIJSON User",
"head": "http://static.oschina.net/uploads/user/19/39085_50.jpg",
"contactIdList": [
82004,
82021,
70793
],
"pictureList": ["http://common.cnblogs.com/images/icon_weibo_24.png"],
"date": "2017-02-01 19:21:50.0"
},
"code": 200,
"msg": "success"
}
下面只是查了一个 User,如果咱们要查女性用户列表,能够这样:
URL:http://apijson.cn:8080/get
表单:
{"[]": { // 数组
"User": {
"sex": 1, // 性别为女
"@column": "id,name" // 只须要 id,name 这两个字段
}
}
}
返回:
{"[]": [
{
"User": {
"id": 82002,
"name": "Happy~"
}
},
{
"User": {
"id": 82003,
"name": "Wechat"
}
},
{
"User": {
"id": 82005,
"name": "Jan"
}
}
],
"code": 200,
"msg": "success"
}
User 被多包裹了一层?给数组命名为 User[] 来去掉吧:
表单:
{"User[]": { // 提取 User
"User": {
"sex": 1, // 性别为女
"@column": "id,name" // 只须要 id,name 这两个字段
}
}
返回:
{"User[]": [
{
"id": 82002,
"name": "Happy~"
},
{
"id": 82003,
"name": "Wechat"
},
{
"id": 82005,
"name": "Jan"
}
],
"code": 200,
"msg": "success"
}
还要进一步提取名字?User-name[] 满足你:
表单:
{"User-name[]": { // 提取 User.name
"User": {
"sex": 1, // 性别为女
"@column": "name" // 只须要 name 这个字段
}
}
}
返回:
{"User-name[]": [
"Happy~",
"Wechat",
"Jan",
"Meria",
"Tommy"
],
"code": 200,
"msg": "success"
}
但如果是含多张表关联的数组,就不要去掉了哦:
表单:
{"[]": {"Comment": {}, // 评论
"User": { // 公布评论的用户
"id@": "/Comment/userId" //User.id = Comment.userId
}
}
}
返回:
{"[]": [
{
"Comment": {
"id": 3,
"toId": 0,
"userId": 82002,
"momentId": 15,
"date": "2017-02-01 19:20:50.0",
"content": "This is a Content...-3"
},
"User": {
"id": 82002,
"sex": 1,
"name": "Happy~",
"tag": "iOS",
"head": "http://static.oschina.net/uploads/user/1174/2348263_50.png?t=1439773471000",
"contactIdList": [
82005,
82001,
38710
],
"pictureList": [],
"date": "2017-02-01 19:21:50.0"
}
},
{
"Comment": {
"id": 4,
"toId": 0,
"userId": 38710,
"momentId": 470,
"date": "2017-02-01 19:20:50.0",
"content": "This is a Content...-4"
},
"User": {
"id": 38710,
"sex": 0,
"name": "TommyLemon",
"tag": "Android&Java",
"head": "http://static.oschina.net/uploads/user/1218/2437072_100.jpg?t=1461076033000",
"contactIdList": [
82003,
82005
],
"pictureList": [
"http://static.oschina.net/uploads/user/1218/2437072_100.jpg?t=1461076033000",
"http://common.cnblogs.com/images/icon_weibo_24.png"
],
"date": "2017-02-01 19:21:50.0"
}
}
],
"code": 200,
"msg": "success"
}
还有动静 Moment 和它的点赞用户列表:
{"Moment": {},
"User[]": {
"User": {"id{}@": "Moment/praiseUserIdList" //id 在点赞列表 praiseUserIdList 内
}
}
}
相似微信个人资料界面:
{"User": {},
"Moment[]": { // 朋友圈照片列表
"Moment": {
"@order":"date-", // 按公布工夫 date 倒序排列
"userId@": "User/id"
}
}
}
相似微信朋友圈的动静列表:
{"[]": {
"count": 3, // 只有 3 个
"page": 2, // 要第 2 页的
"Moment": {},
"User": {"id@": "/Moment/userId"},
"Comment[]": {
"Comment": {"momentId@": "[]/Moment/id"
}
}
}
}
…
任意构造,任意内容,任意组合,
想要什么 JSON 构造、字段内容、表关联组合查问都能够齐全自定义!
"key[]":{} // 查问数组
"key{}":[1,2,3] // 匹配选项范畴
"key{}":"<=10,length(key)>1..." // 匹配条件范畴
"key()":"function(arg0,arg1...)" // 近程调用函数
"key@":"key0/key1.../targetKey" // 援用赋值
"key$":"%abc%" // 含糊搜寻
"key?":"^[0-9]+$" // 正则匹配
"key+":[1] // 减少 / 扩大
"key-":888.88 // 缩小 / 去除
"name:alias" // 新建别名
"@column":"id,sex,name" // 返回字段
"@group":"userId" // 分组形式
"@having":"max(id)>=100" // 聚合函数
"@order":"date-,name+" // 排序形式
以上都是查问申请,再试试 增删改 和 统计:
增: http://apijson.cn:8080/post
{
"Comment": {
"userId": 82001,
"momentId": 15,
"content": "测试新增评论"
},
"tag": "Comment"
}
删: http://apijson.cn:8080/delete
{
"Comment": {"id": 1510394480987},
"tag": "Comment"
}
改: http://apijson.cn:8080/put
{
"Comment": {
"id": 22,
"content": "测试批改评论"
},
"tag": "Comment"
}
批量删: http://apijson.cn:8080/delete
{
"Comment": {"id{}": [1510394480987, 1510394804925]
},
"tag": "Comment[]"}
批量改: http://apijson.cn:8080/put
{
"Comment": {"id{}": [22, 114],
"content": "测试批量批改评论"
},
"tag": "Comment[]"}
统计: http://apijson.cn:8080/head
{
"Comment": {"content$": "% 测试 %" // 内容蕴含 测试 两个字}
}
写操作须要对应的权限,就是用 3 行代码配置的,申请报错:
登录后角色主动变为 LOGIN(可传 @role 来自定义),合乎 Comment 的 POST 权限配置,胜利:
回忆下,代码才写了 3 行,就实现了包含增删改查等各种操作的 8 个接口以及这么多种查问!
事实上用 APIJSON 基本就不必本人写接口!这 3 行代码其实是为了做权限治理!
像集体博客、非商业的新闻资讯网站这种能够没有权限管制的,
改下全局配置,不做权限校验,那就连一行代码都不必写了!!!
近期热文举荐:
1.1,000+ 道 Java 面试题及答案整顿(2021 最新版)
2. 别在再满屏的 if/ else 了,试试策略模式,真香!!
3. 卧槽!Java 中的 xx ≠ null 是什么新语法?
4.Spring Boot 2.5 重磅公布,光明模式太炸了!
5.《Java 开发手册(嵩山版)》最新公布,速速下载!
感觉不错,别忘了顺手点赞 + 转发哦!