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

admin 2024-9-21 14:31:12

前言：

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

基本需求

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

就算用几乎零配置的 SpringBoot，写一个最简单的接【jiē】口也【yě】得有【yǒu】 3 行代【dài】码【mǎ】啊！

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

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

这还没算【suàn】拼 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】仅是查询【xún】，一张表(对应客【kè】户端的 model)就要两个接口了，如果再加上增删改，批量改【gǎi】批【pī】量【liàng】删【shān】，还有统计，那就【jiù】得有 8 个接口【kǒu】了！

那么我是怎么解决的呢？

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

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

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

获取一个用户：

base_url/get/

获取一个用户列表：

base_url/get/

获取一个评论：

base_url/get

获取一个评论列表：

base_url/get

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

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

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

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

项目演示：

如何做到

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

APIJSON，对，就它！

我【wǒ】们用 APIJSON 来操作一张【zhāng】表，例如用户【hù】表 User，代码写 3 行【háng】就够【gòu】了：

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

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

@MethodAccess(  POST = {UNKNOWN, ADMIN} //只允许【xǔ】未登【dēng】录角色和管理员角【jiǎo】色新增 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"}

上面只是查了一个 User，如果我们要【yào】查【chá】女【nǚ】性用户列表，可【kě】以这样【yàng】：

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

表单：

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

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

User 被多包裹了一层？给数【shù】组命名为 User[] 来【lái】去掉吧【ba】：

表单：

{    "User[]": { //提取【qǔ】User        "User": {            "sex": 1, //性别为【wéi】女【nǚ】            "@column": "id,name" //只需【xū】要id,name这两个字段        }    }

{    "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" //只需要name这【zhè】个【gè】字段        }    }}

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

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

表单：

{    "[]": {        "Comment": {}, //评【píng】论        "User": {      //发布【bù】评【pí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】赞列表praiseUserIdList内        }    }}

类似微信个人资料界面：

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

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

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

...

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

想要什么【me】 JSON 结构、字段内容、表关联组合查询【xún】都可以【yǐ】完全自定【dìng】义！

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

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

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

{    "Comment": {        "userId": 82001,        "momentId": 15,        "content": "测试新【xīn】增【zēng】评论"    },    "tag": "Comment"}

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

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

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

{    "Comment": {        "id": 22,        "content": "测试【shì】修改评【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": "测试批量修改评论"    },    "tag": "Comment[]"}

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

{    "Comment": {        "content$": "%测试%" //内容包含【hán】 测试 两个【gè】字    }}

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

登录后角色自动变为 LOGIN(可【kě】传@role 来自定义)，符【fú】合【hé】 Comment 的 POST 权限配置，成功：

总结

回想下，代码【mǎ】才写【xiě】了 3 行，就实现了包【bāo】括增【zēng】删【shān】改查等【děng】各种操作的【de】 8 个接口以及这么多种查询！

事实上用【yòng】 APIJSON 根本就不【bú】用自【zì】己写接口【kǒu】！这 3 行代码其实是为了【le】做权【quán】限管理！

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

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