关于java:3-行代码写出-8-个接口牛逼这也行

起源：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开发手册（嵩山版）》最新公布，速速下载！

感觉不错，别忘了顺手点赞+转发哦！

关于java:3-行代码写出-8-个接口牛逼这也行

评论

发表回复取消回复

更多文章

DDN HPC 存储硬件架构设计深度分析

探秘IO500：从Lustre并行文件系统出发，开启HPC存储性能新征程

苹果iOS打包的ipa应用无法安装？一篇文章带你了解可能的原因及排查方法

图解Golang：从零开始实现简易版过期LRU缓存

关于java:3-行代码写出-8-个接口牛逼这也行

评论

发表回复 取消回复

更多文章

DDN HPC 存储硬件架构设计深度分析

探秘IO500：从Lustre并行文件系统出发，开启HPC存储性能新征程

苹果iOS打包的ipa应用无法安装？一篇文章带你了解可能的原因及排查方法

图解Golang：从零开始实现简易版过期LRU缓存

发表回复取消回复