后端开挂：3行代码写出8个接口！

admin 2024-9-21 13:56:45

前言：

目前朋友们对“暗【àn】黑3装【zhuāng】备【bèi】代码大全”可能比较【jiào】注重，你们【men】都需要剖【pōu】析一些“暗黑3装备代码大【dà】全”的相关文【wén】章。那么小编也【yě】在网摘【zhāi】上网罗了【le】一些有关“暗黑3装备代码大全【quán】””的相【xiàng】关文章，希望你们能喜欢，各【gè】位老铁们快【kuài】快来【lái】了解一下【xià】吧！

基本需求

肯定有不少人会想：这怎么可能呢？

就算用几【jǐ】乎零配置【zhì】的【de】 SpringBoot，写一个【gè】最简单的接口也得有 3 行代码啊【ā】！

@RequestMapping("test/{request}")public String test(@PathVariable String request) {    return request + ": Hello World";}

那 8 个没【méi】啥用的 Hello World 接口就得【dé】 24 行代码了【le】！

这【zhè】还没算拼 SQL 连 JDBC 或者调【diào】用 ORM 库【kù】的代码呢！

更不用说还要写 XML 配置的其它库了！

没错，用传统方式就是这样。

获取一个用户：

base_url/get/user

获取一个用户列表：

base_url/get/user/list

获取一个评论：

base_url/get/comment

获取一个评论列表：

base_url/get/comment/list

仅仅【jǐn】是【shì】查询，一张表(对应客户端【duān】的【de】 model)就【jiù】要两个【gè】接口了，如果再加上增【zēng】删【shān】改，批量改批量删，还【hái】有统计，那就得有 8 个接口了！

那么我是怎么解决的呢？

同一种类型的请求都只用一个接口：

增 base_url/post删（包括批量） base_url/delete改【gǎi】（包括批【pī】量） base_url/put查【chá】（包括列表【biǎo】） base_url/get统计 base_url/head

用最常用的查询请求举例：

获取一个用户：

base_url/get/

获取一个用户列表：

base_url/get/

获取一个评论：

base_url/get

获取一个评论列表：

base_url/get

这或许是一个对你有用的开源项目，mall项目【mù】是【shì】一套【tào】基于 SpringBoot3 + JDK 17 + Vue 实现的电商系统（Github标星60K），采用Docker容器化部署，后端【duān】支持多模块和【hé】微服务架构。包括前台商【shāng】城项目和后台【tái】管理系统，能【néng】支持完整【zhěng】的订单流程！涵盖商品、订单【dān】、购物【wù】车、权限、优惠【huì】券、会员、支付【fù】等功【gōng】能！

Boot项目：https://github.com/macrozheng/mall

Cloud项目：https://github.com/macrozheng/mall-swarm

视频教程：https://www.macrozheng.com/video/

项目演示：

如何做到

都是用同一个接口！我是怎么做到的呢？

APIJSON，对，就它！

我们用 APIJSON 来【lái】操作一张表，例【lì】如用【yòng】户表 User，代码写 3 行就够了【le】：

//注册表并添加权限，用【yòng】默认【rèn】配置@MethodAccesspublic class User {//内容【róng】一般仅【jǐn】供表【biǎo】字段【duàn】说明及 Android App 开发【fā】使用【yòng】，服务端不用的可不写【xiě】。}//Verifier 内添加权限accessMap.put(User.class.getSimpleName(), getAccessMap(User.class.getAnnotation(MethodAccess.class)));

或者可以再定制下 POST 请求的角色权限：

@MethodAccess(  POST = {UNKNOWN, ADMIN} //只允许【xǔ】未登【dēng】录角色和【hé】管理员角色新增 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": "2024-9-21 19:21:50.0"    },    "code": 200,    "msg": "success"}

上面只是查【chá】了一个 User，如【rú】果我们【men】要查女性用户列表【biǎo】，可以这样：

URL：http://apijson.cn:8080/get

表单：

{    "[]": { //数【shù】组        "User": {            "sex": 1, //性别为女            "@column": "id,name" //只需要id,name这【zhè】两个字【zì】段        }    }}

{    "[]": [        {            "User": {                "id": 82002,                "name": "Happy~"            }        },        {            "User": {                "id": 82003,                "name": "Wechat"            }        },        {            "User": {                "id": 82005,                "name": "Jan"            }        }    ],    "code": 200,    "msg": "success"}

User 被多包裹了一层【céng】？给数组命名为【wéi】 User[] 来去掉吧：

表单：

{    "User[]": { //提取User        "User": {            "sex": 1, //性别为女            "@column": "id,name" //只需要id,name这两个【gè】字段【duàn】        }    }

{    "User[]": [        {            "id": 82002,            "name": "Happy~"        },        {            "id": 82003,            "name": "Wechat"        },        {            "id": 82005,            "name": "Jan"        }    ],    "code": 200,    "msg": "success"}

还要进一步提取名字？User-name[] 满足你：

表单：

{    "User-name[]": { //提取【qǔ】User.name        "User": {            "sex": 1, //性别为女            "@column": "name" //只【zhī】需要name这个【gè】字段        }    }}

{    "User-name[]": [        "Happy~",        "Wechat",        "Jan",        "Meria",        "Tommy"    ],    "code": 200,    "msg": "success"}

但如果是含多张表关联的数组，就不要去掉了哦：

表单：

{    "[]": {        "Comment": {}, //评论        "User": {      //发布评【píng】论【lùn】的用【yòng】户            "id@": "/Comment/userId" //User.id = Comment.userId        }    }}

{    "[]": [        {            "Comment": {                "id": 3,                "toId": 0,                "userId": 82002,                "momentId": 15,                "date": "2024-9-21 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": "2024-9-21 19:21:50.0"            }        },        {            "Comment": {                "id": 4,                "toId": 0,                "userId": 38710,                "momentId": 470,                "date": "2024-9-21 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": "2024-9-21 19:21:50.0"            }        }    ],    "code": 200,    "msg": "success"}

还有动态 Moment 和它的点赞用户列表：

{    "Moment": {},    "User[]": {        "User": {            "id{}@": "Moment/praiseUserIdList" //id在点【diǎn】赞列【liè】表praiseUserIdList内        }    }}

类似微信个人资料界面：

{    "User": {},    "Moment[]": { //朋【péng】友圈照片列表        "Moment": {            "@order":"date-", //按【àn】发布时【shí】间date倒序排列            "userId@": "User/id"        }    }}

类似微信朋友圈的动态列表：

{    "[]": {        "count": 3, //只要3个        "page": 2,  //要第【dì】2页的        "Moment": {},        "User": {            "id@": "/Moment/userId"        },        "Comment[]": {            "Comment": {                "momentId@": "[]/Moment/id"            }        }    }}

...

任意结构，任意内容，任意组合，

想要什么 JSON 结构、字【zì】段【duàn】内容【róng】、表【biǎo】关联【lián】组合查询都可以完全自定义！

"key[]":{}                                         // 查询数组"key{}":[1,2,3]                                    // 匹配选项范围"key{}":"<=10,length(key)>1..."                    // 匹配条件范【fàn】围【wéi】"key()":"function(arg0,arg1...)"                   // 远程【chéng】调用函数"key@":"key0/key1.../targetKey"                    // 引【yǐn】用赋值"key$":"%abc%"                                     // 模糊搜索"key?":"^[9-21]+$"                                  // 正【zhèng】则匹配"key+":[1]                                         // 增加【jiā】/扩展"key-":888.88                                     // 减【jiǎn】少【shǎo】/去除 "name:alias"                                      // 新【xīn】建【jiàn】别名"@column":"id,sex,name"                           // 返【fǎn】回字段"@group":"userId"                                 // 分组方【fāng】式"@having":"max(id)>=100"                          // 聚合函数"@order":"date-,name+"                            // 排序方【fāng】式

以上都是查询请求，再试试增删改和统计：

增: http://apijson.cn:8080/post

{    "Comment": {        "userId": 82001,        "momentId": 15,        "content": "测试新增评论【lùn】"    },    "tag": "Comment"}

删: http://apijson.cn:8080/delete

{    "Comment": {        "id": 1510394480987    },    "tag": "Comment"}

改: http://apijson.cn:8080/put

{    "Comment": {        "id": 22,        "content": "测【cè】试修改评【píng】论"    },    "tag": "Comment"}

批量删: http://apijson.cn:8080/delete

{    "Comment": {        "id{}": [1510394480987, 1510394804925]    },    "tag": "Comment[]"}

批量改: http://apijson.cn:8080/put

{    "Comment": {        "id{}": [22, 114],        "content": "测试批量【liàng】修【xiū】改评论"    },    "tag": "Comment[]"}

统计: http://apijson.cn:8080/head

{    "Comment": {        "content$": "%测试%" //内容包含 测试 两个字【zì】    }}

写操作需要对应的权限，就是用 3 行代码配置的，请求报错：

登【dēng】录【lù】后角色自动变为 LOGIN(可【kě】传@role 来【lái】自定义)，符合 Comment 的 POST 权限配置，成功：

总结

回想下【xià】，代【dài】码才写【xiě】了【le】 3 行，就实【shí】现了包括增删改查等各种操作的 8 个接【jiē】口以【yǐ】及这么多种查询！

事【shì】实上用【yòng】 APIJSON 根本就不用自己【jǐ】写接口！这 3 行代【dài】码其实是为了做权限【xiàn】管理！

像个人博客、非商业的新闻资讯网站这种可以没有权限控制的，

改下全局配置，不做权限校验，那就连一行代码都不用写了！！！