springboot 同一请求入口,根据不同入参用不同实体类接收&调用不同接口实现类(枚举、泛型、多态综合运用)

1.情景展示

  请求入参:

  这是一个对外提供的请求总入口,入参interfaceMethod对应不同的接口名称,具体的接口请求参数封装到xcParams里面。

  对外只提供这一个接口,而不是不同接口提供不同地址,这样一来,无论是接口提供方还是接口调用方只要遵循这种规范,就可以完成不同接口的调用,也利于后期接口的启用、禁用、扩展新接口,提高系统的可维护性。

  像这样,用实体类接收到请求入参,获取将要调取的接口方法,根据不同接口名称匹配调用不同的业务实现类进行业务处理。

2.现状分析

  在实际开发过程中,公司与公司之间或者公司内部项目与项目之间往往会存在这种需求,公司A提供接口,公司B调用接口,如果是多个接口,那么就可以像上面那样搞一个总入口:

  使用switch判断具体需要调用哪一个接口,以及负责处理的业务实现类就可以了。

  以上的代码是完全没有问题的,已经满足了实际业务需要,这种入门级的代码,基本不要动什么脑子;

  但是,如果我们想要使用高逼格的代码实现这种功能,能够让我们用更多java知识应用到实际开发过程中,学以致用,使自己的能力得到升华,换句话说就是:想装X,请欣赏下面的高逼格代码。

  (其实,对于产品来说,不管你是低级代码还是高级代码实现,只要能满足产品需求就是OK的,这一点我们一定要摆好自己位置,不能沾沾自喜)

3.高级代码实现

  先看效果

  请求入参使用了泛型控制,不同接口自动映射到对应的实体类去接收(上图)

  调对应接口时,一行代码搞定,无需手动加判断该调哪个业务实现类。

  想实现这种效果,就继续往下看哈。

  用实体类接收请求入参是本文的重中之重,先来看一下

  第一,注解@Getter、@Setter;

  使用的是lombok插件,其作用是生成私有属性的Get、Set方法,不想用或者没有的,自己手动生成替代就可以了(类的属性私有化,再对外提供Get和Set方法,其实就是java三大特性之一:封装)。

  第二,注解@ApiModelProperty;

  对请求参数进行介绍,使用的是knife4j,为接口提供的API文档,最终效果如下图所示:

 

  这样一来,接口的请求参数、响应参数都有详细介绍,与别人对接接口的时候再也不用一遍一遍的跟不同的人解释了,把文档地址扔给他,清晰明了。

  注意:这不是本文介绍的重点,心有余力的,见文末推荐文章。

  第三,注解@JsonProperty;

  反序列化:将json对象的key与实体类的指定属性对照起来,并完成赋值操作;

  @JsonProperty,隶属于Jackson,springboot内部集成,请求入参转实体类默认使用的就是Jackson;

  由于将请求参数与泛型进行映射,所以,每个属性都需要加上@JsonProperty注解进行对照。

  第四,注解@NotBlank

  字符串非空校验:只用在String上,表示传进来的值不能为null,而且调用trim()后,长度必须大于0,即:必须有实际字符。

  说明:泛型无法使用注解进行非空校验,所以,上图中的注解@NotNull无效

  第五,用枚举类来接收请求入参的其中一个参数值;

  在这里,使用枚举类CzInterfaceEnum来接收请求参数InterfaceMethod的值,这个说法并不对,因为枚举类往往不止有一个属性,而InterfaceMethod却只有一个值,按正常逻辑来想,json是完全不能实现发序列化的。

  这我们就不得不提及注解@JsonValue啦

  被加上注解@JsonValue的属性,将会完成值的映射,也就是InterfaceMethod的值最终会被赋值到枚举类的interfaceName属性上,这样就没有一点问题了。

  第六,往枚举类注入对象;

  如果枚举类只有这一点点作用,那我们也不用废这么大劲用它接收,干脆用String类来接收岂不方便?

  如果这样想,就大错特错了,再来回想一下,如果我们用String类来接收InterfaceMethod的值,那我们岂不是又回到了原点:后续还得用switch来判断,进而调用不同的业务实现类。

  之所以想用枚举类来接收InterfaceMethod,是因为,这个时候,我们已经拿到了InterfaceMethod的值,换句话说,我们这个时候就已经知道,它调用的是哪个接口,该用哪个接口实现类来处理!

  难点在于:如何往枚举类注入对象?

  见文末推荐。

  第七,不同接口的请求参数使用不同实体类接收;

  通过注解@JsonTypeInfo和@JsonSubTypes结合实现

  由最开始的时候,我们得知:不同的接口虽然请求参数不同,但都会塞到CzParams这个参数中,所以,我们就能根据参数InterfaceMethod来判断当前请求该用哪个请求实体类来接收;

  所以,CzParams的类型只能用泛型来接收(只有在运行调用的时候,才能知道它是谁);

  这样一来,请求实体类只需继承抽象类CzRequestParams,并在该父类中设置@JsonSubType.Type注解即可。

  如此,就能实现刚开始提到的效果;

  对于高频接口,还可以开启多线程,解决并发问题(本文未做展示)。

4.多态的另一种用法

  2020-12-15

  关于用泛型接收类的方式,其实也是可以去掉的,只是,可能会让看代码的人一脸懵逼。

  上面说的很清楚,这个地方用的是泛型,并在class类上用了泛型限定<T extends CzRequestParams>,这样方便其它人员维护,看到立马就知道实际接收参数的是CzRequestParams的子类。

  既然是子类,那我们何不用的干脆一点?

  把泛型干掉,直接用父类接收完事(向上泛型),实际负责接收的还是那些子类。

5.嵌套实体类校验不生效问题

2020-12-16

  使用@Valid或@Validator注解进行相关检验时,会造成嵌套类上相关校验不生效的问题(嵌套验证),比如:

  CzRequestDto类能够使用注解进行校验,这没有一点问题。

  问题是:CzRequestDto类里又使用其他实体类接收请求参数,例如:上图中的泛型,它对应的其中一个实体类是下面这个类,

  这就是所谓的嵌套。

  在这个类里面,使用参数校验注解,不会生效。

  如何解决这个问题?

  这个问题困扰了我很久,其实很简单,在嵌套实体类的地方,再次声明校验注解就完事了。

写在最后

  哪位大佬如若发现文章存在纰漏之处或需要补充更多内容,欢迎留言!!!

 相关推荐:

原文地址:https://www.cnblogs.com/Marydon20170307/p/13970490.html