通常一个 Controller 是以 class 的形式创建的,需要在里面注入 Service,写方法体,调用 Service 的方法,来完成数据交互。
而声明式 API 是将 class 变成一个 interface,节省了一些代码量,从而提高开发效率,同时因为这只是一个抽象方法,重新编写的成本极低,所以当不需要的时候 可以直接无脑删,不用担心后面又需要了咋办。
假设现在有一个 Service,bean 名称为 aService,现在需要通过 Controller 来调用 aService 里面的 selectList 方法
@MarsApi(refBean="aService")
public interface TestApi {
返回类型 selectList(TestDTO testDTO);
}
当我们请求这个接口的时候,他会自动调用 aService 里面的 selectList 方法,并将返回值转成 json 返回。
@MarsApi(refBean="aService")
public interface TestApi {
// 这个注解可以覆盖类上面的 refBean
@MarsReference(beanName = "bService")
返回类型 selectList(TestDTO testDTO);
}
@MarsApi(refBean="aService")
public interface TestApi {
@MarsReference(refName = "要调用的 service 的方法名")
返回类型 selectList(TestDTO testDTO);
}
@MarsApi(refBean="aService")
public interface TestApi {
@MarsReference(refName = "要调用的属性名", refType = RefType.PROPERTY)
返回类型 selectList(TestDTO testDTO);
}
在接参对象的属性上添加 @MarsDataCheck 注解接口
// 不可为空,且长度在 2-3 位
@MarsDataCheck(notNull = true,maxLength = 3L,minLength = 2L, msg = "id 不可为空且长度必须在 2-3 位之间")
private Integer id;
// 正则校验
@MarsDataCheck(reg = "^(?![0-9]+$)(?![a-zA-Z]+$)[0-9A-Za-z]{6,12}$",msg = "密码不可以为空且必须是 6-12 位数字字母组合")
private String password;
不会,加一个 apis 属性即可搞定
public class ExpVO {
/*
* expGetRequest 和 expPostRequest 两个接口都不允许 name 为空
* 只需要在 apis 属性里配置这两个接口即可,但是由于他们都是 exp 开头的
* 所以用通配符即可
*/
@MarsDataCheck(notNull = true, msg = "名称不可以为空", apis={"exp*"})
private String name;
/*
* saveRequest 和 expPostRequest 两个接口都不允许 address 为空
* 只需要在 apis 属性里配置这两个接口即可
*/
@MarsDataCheck(notNull = true, msg = "地址不可以为空", apis={"expPostRequest","saveRequest"})
private String address;
}
这个不用使用者关心了,因为这个框架是纯粹面向前后端分离的,所以无论出现什么情况,前端都可以收到 json, 假如出异常了,那么前端会收到这样一个 json
{error_code:500, error_info:"异常提示"}
没关系,我们兼容常规的 Controller 写法
@MarsApi
public class DemoController {
@MarsWrite("userInfoServiceImpl")
private UserInfoService userInfoService;
public String demo(UserInfoDTO userInfoDTO, HttpMarsRequest request){
return "";
}
}
2
SorcererXW 2020-12-16 12:50:43 +08:00
你需要 GraphQL
|
3
Joker123456789 OP @SorcererXW 跟我这个完全不搭噶, 拿其他项目压我,也要压在点上啊。 弄个完全不搭噶的 干嘛。
|
4
Joker123456789 OP |
5
Kirsk 2020-12-16 13:54:01 +08:00 via Android
没有用过你项目的 这什么奇葩写法 调用顺序是什么 用过 spring 的 哦 我去找声明 bean 注入的地方 做框架是要解耦 不解耦要他干嘛 你这个侵入程度很明显 只适合自己内部用 比 autowired 更费心力
|
6
eric96 2020-12-16 14:28:10 +08:00 1
你们怎么会有这么多奇怪的想法
|
7
efaun 2020-12-16 14:29:53 +08:00 1
@Joker123456789 #4 开源不是挡箭牌,只要帖子里有外部链接且利益相关的,一律算推广
|
8
disk 2020-12-16 14:31:17 +08:00
如果接口和服务是绑定的,用这个注解可以省些代码量。解耦的话完全就不合适这种。
|
9
Joker123456789 OP @efaun
是算推广啊,不然我分享出来干嘛? 推上 github,静静等待,一切看缘分不是更好。 而且谁写东西不是为了利益的? 我还真不信有这种人, 不为推广,不为让更多人看到,那么放自己网盘加密不是更好。 我之所以声明是正儿八经的开源项目,不是为了当挡箭牌,只是为了明确调性,技术社区发技术帖子,我个人认为完全没问题, 我之所以有罪 就是因为这个项目是我做的,如果不是我做的,估计就没人说啥了。 |
10
jaylee4869 2020-12-16 14:46:14 +08:00
Java 开发者使用声明式 API 无非就是注解。
https://lawrenceli.me/blog/declarative-programming |
11
Joker123456789 OP |
12
Joker123456789 OP |
13
efaun 2020-12-16 14:49:34 +08:00 2
@Joker123456789 #9 “你之所以有罪 就是因为”你的贴子应该发在了 java 节点而不是推广节点,懂?
|
14
Joker123456789 OP @efaun 如果不是我做的呢?? 你还会说这句话吗? 如果我介绍的是 spring 里的 某个技术点呢?
还有,这整篇文章都是在正儿八经的介绍这个结束点啊,你看到什么推广的字眼了没? 不就因为这个项目是我做的,你们很排斥嘛。 |
15
zhuangzhuang1988 2020-12-16 14:54:52 +08:00
不喜欢写一堆注解来做 dependency-injection
还是 asp.net 来得好, https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/dependency-injection?view=aspnetcore-5.0 |
16
efaun 2020-12-16 14:57:08 +08:00 2
@Joker123456789 #14 看不懂人话?我第一句就说了“只要帖子里有外部链接且利益相关的,一律算推广”,第二句也说了“你的贴子应该发在了 java 节点而不是推广节点”,全篇跟是不是你做的有关系吗?你算什么东西?不是你做的几个 star 怎样,是你做的几万个 star 又怎样?推广就应该发在推广节点,你自己的回复也承认了这是推广,现在又翻脸不认?什么玩意
|
17
brezp 2020-12-16 15:00:00 +08:00
点进去看了下, 野心很大啊, 想自己再造一个 spring?
|
18
Joker123456789 OP @efaun 那你又算什么东西? 轮得到你指指点点?? 我发个技术文章关你屁事啊? 不喜欢就滚蛋,我求你用还是怎么着?
你说我该发到推广节点,不就是因为 [这是我做的吗?] 除此之外还有什么原因吗?? 你从我的文章里一五一十指出问题来,去指啊。 如果我的文章是 [分享一下 AOP 的写法] 你还会跟我说这些屁话吗? 连你自己为什么要骂我的原因 自己心里都没数吗?? 是你莫名其妙的出来一顿乱喷,还好意思对我发火,什么玩意。 |
19
efaun 2020-12-16 15:09:48 +08:00
@Joker123456789 #18 两次好言好语回复不看,非要被喷才舒服,看来你现在还是不知道自己的项目为什么不被 V2EX 的人看好,哎,可怜、可悲、可叹,希望其他开源项目没事🙏
|
20
Joker123456789 OP @efaun 好言好语??? 哈哈哈 XSWL, 知道自己理亏了 就开始扯别的了? 还希望别的没事,别的项目 一样被你们这种人喷。 在这装什么无辜呢
|
21
11ssss 2020-12-16 15:17:47 +08:00
‘我之所以声明是正儿八经的开源项目’ 路过,GitHub 开源协议不加一下吗?
|
22
Joker123456789 OP @11ssss 你应该没认真看,或者你的网卡了 没加载出来
|
23
efaun 2020-12-16 15:21:42 +08:00 2
|
24
11ssss 2020-12-16 15:22:40 +08:00
@Joker123456789 看错了 当我没说
|
25
Joker123456789 OP @efaun 那你又知道自己错在哪了吗? 呜呼哀哉你 MB 啊。真当自己是上帝啊,我做什么轮得到你指指点点? 赶紧滚吧,有意见就举报一波,让管理员来删帖,比跟我 BB,看你来气。
|
26
shuige 2020-12-16 15:43:49 +08:00
楼下吃瓜
|
28
liuhuansir 2020-12-16 15:47:42 +08:00
吃瓜,看看最后怎么处理这个帖子,劝 LZ 还是别爆粗口,注意下素质
|
29
qwertyzzz 2020-12-16 16:22:39 +08:00
吃瓜 我觉得这还好吧 没那么多推广味 发哪我也不那么在意 不看 x 了得了 没必要当个圣母指指点点
|
30
Joker123456789 OP @liuhuansir 谢谢提醒,但是没办法,直性子被喷了忍不住要反击。
|
31
shenlanAZ 2020-12-16 16:23:35 +08:00
相当于把 controller 层砍掉了,如果 controller 需要根据参数来调用不同的 service 乃至不同的方法 这样就很难实现了。
另外 refBean 为什么要 Bean 名称,既然已经确认类型了 为什么不用 IxxService.class ?我为什么还要手动拼出来 bean 名称 还是说你框架可以帮我自动取到 bean 名称。 另外一点 在异常的时候返回 我比较关心你那个 error_code 为 500 的时候 http status 是不是 500,error_code 是否可以定制,如果不可定制 那和 http status 重复的意义在哪里? |
32
Kirsk 2020-12-16 17:28:39 +08:00 via Android
@Joker123456789 如果你认为使用你的东西要仔细阅读文档 而不是像多数人使用 spring 时一些约定俗成的写法 那 ok 如果不是我怎么知道你封装的注解有什么操作 而且你这个设计等于在 spring 上再自己封装一层 你能给使用者带来更高效的开发吗 如果我不用你框架了 是不是全部爆红? 影响到整体项目没? 打个比方 我从 orm1 框架换 orm2 他影响的范围是数据存取部分 如果 orm12 都遵守一样的范式协议影响更小 你说你能直接删 你的返回单个参数涉及业务逻辑没? 参数校验规则涉及没 你见过哪个框架是这么设计的 我把框架删了要不要补大量的逻辑?
|
33
mmrx 2020-12-16 18:42:18 +08:00
spring boot 小白,我想问这个 interface 的写法兼容 Swagger 么,支持注解方式的跨域配置么
如果不支持,只能用你说的兼容常规 Controller 写法,那这个框架还有什么意义呢 |
34
Joker123456789 OP @mmrx swagger 是 自动生成文档的,不是硬需求,支不支持看后面规划。 跨域问题,这个肯定是支持的,不然我敢纯粹面向前后端分离吗
|
35
Joker123456789 OP @shenlanAZ 根据返回的数据,判断是否成功 并不难吧, 为什么必须要 http status 告诉你, 我不太理解。
|
36
Joker123456789 OP |
37
Joker123456789 OP @shenlanAZ 而且 现在流行的做法 不都是 catch 里返回 json 吗,或者用异常监听, 就是为了避免 500 啊
|
38
Joker123456789 OP @Kirsk 最后,我说的删 不是指删框架, 你可能没看懂, 又或者是我没写明白
|
39
xuanbg 2020-12-16 20:19:29 +08:00
我今天下午 40 多个接口居然一气呵成写完鸟……,中间还玩了几把游戏,这效率还要什么自行车
|
40
mmrx 2020-12-17 10:04:10 +08:00
@Joker123456789 Swagger 目前我接触到的基本上都是用的,输出 API 文档目前应该就是硬需求了吧..
另外这些基础的注解配置我专门看了一下你官网的文档,貌似都么有提及,都是在讲一些新的,不一样的点。个人感觉没有兼容说明对于大多数人都是比较劝退的,因为没多少人原因当小白鼠 |
42
alienx717 2020-12-17 10:55:20 +08:00
有想法
|
43
Joker123456789 OP @mmrx 另外的注解配置是指啥? 我不是很明白,可否细说一下。
然后关于 swagger 这个,支持当然是最好的,可以避免手工写文档嘛, 但不支持嘛 也不是很要命, 主要看使用者的想法吧。 不过我后面会考虑的。 |