你怎么总是能写出两三千行的controller类?(上)

简介: 你一定经常见到一个两三千行的 controller 类,类之所以发展成如此庞大,有如下原因:长函数太多类里面有特别多的字段和函数量变引起质变,可能每个函数都很短小,但数量太多

你一定经常见到一个两三千行的 controller 类,类之所以发展成如此庞大,有如下原因:

  • 长函数太多
  • 类里面有特别多的字段和函数
    量变引起质变,可能每个函数都很短小,但数量太多

1 程序的modularity

你思考过为什么你不会把all code写到一个文件?因为你的潜意识里明白:

  • 相同的功能模块无法复用
  • 复杂度远超出个人理解极限

一个人理解的东西是有限的,在国内互联网敏捷开发环境下,更没有人能熟悉所有代码细节。

解决复杂的最有效方案就是分而治之。所以,各种程序设计语言都有自己的模块划分(modularity)方案:

  • 从最初的按文件划分
  • 到后来使用OO按类划分

开发者面对的不再是细节,而是模块,模块数量显然远比细节数量少,理解成本大大降低,开发效率也提高了,再也不用 996, 每天都能和妹纸多聊几句了。

modularity,本质就是分解问题,其背后原因,就是个人理解能力有限。

说这么多我都懂,那到底怎么把大类拆成小类?

2 大类是怎么来的?

2.1 职责不单一

最容易产生大类的原因

CR一段代码:

image.png

该类持有大类的典型特征,包含一坨字段:这些字段都缺一不可吗?

  • userId、name、nickname等应该是一个用户的基本信息
  • email、phoneNumber 也算是和用户相关联
    很多应用都提供使用邮箱或手机号登录方式,所以,这些信息放在这里,也能理解
  • authorType,作者类型,表示作者是签约作者还是普通作者,签约作者可设置作品的付费信息,但普通作者无此权限
  • authorReviewStatus,作者审核状态,作者成为签约作者,需要有一个申请审核的过程,该状态字段就是审核状态
  • editorType,编辑类型,编辑可以是主编,也可以是小编,权限不同

这还不是 User 类的全部。但只看这些内容就能看出问题:

  • 普通用户既不是作者,也不是编辑
    作者和编辑这些相关字段,对普通用户无意义
  • 对那些成为作者的用户,编辑的信息意义不大
    因为作者不能成为编辑。编辑也不会成为作者,作者信息对成为编辑的用户无意义

总有一些信息对一部分人毫无意义,但对另一部分人又必需。出现该问题的症结在于只有“一个”用户类。

普通用户、作者、编辑,三种不同角色,来自不同业务方,关心的是不同内容。仅因为它们都是同一系统的用户,就把它们都放到一个用户类,导致任何业务方的需求变动,都会反复修改该类,严重违反单一职责原则。

所以破题的关键就是职责拆分。


虽然这是一个类,但它把不同角色关心的东西都放在一起,就愈发得臃肿了。


只需将不同信息拆分即可:

public class User {
  private long userId;
  private String name;
  private String nickname;
  private String email;
  private String phoneNumber;
  ...
}
public class Author {
  private long userId;
  private AuthorType authorType;
  private ReviewStatus authorReviewStatus;
  ...
}
public class Editor {
  private long userId;
  private EditorType editorType;
  ...
}

拆出 Author、Editor 两个类,将和作者、编辑相关的字段分别移至这两个类里。

这俩类分别有个 userId 字段,用于关联该角色和具体用户。

2.2 字段未分组

有时觉得有些字段确实都属于某个类,结果就是,这个类还是很大。

之前拆分后的新 User 类:

public class User {
  private long userId;
  private String name;
  private String nickname;
  private String email;
  private String phoneNumber;
  ...
}

这些字段应该都算用户信息的一部分。但依然也不算是个小类,因为该类里的字段并不属于同一种类型的信息。

如,userId、name、nickname算是用户的基本信息,而 email、phoneNumber 则属于用户的联系方式。


需求角度看,基本信息是那种一旦确定一般就不变的内容,而联系方式则会根据实际情况调整,如绑定各种社交账号。把这些信息都放到一个类里面,类稳定程度就差点。


据此,可将 User 类的字段分组:

public class User {
  private long userId;
  private String name;
  private String nickname;
  private Contact contact;
  ...
}
public class Contact {
  private String email;
  private String phoneNumber;
  ...
}

引入一个 Contact 类(联系方式),把 email 和 phoneNumber 放了进去,后面再有任何关于联系方式的调整就都可以放在这个类里面。

此次调整,把不同信息重新组合,但每个类都比原来要小。

前后两次拆分到底有何不同?

  • 前面是根据职责,拆分出不同实体
  • 后面是将字段做了分组,用类把不同的信息分别封装

大类拆解成小类,本质上是个设计工作,依据单一职责设计原则。

若把大类都拆成小类,类的数量就会增多,那人们理解的成本是不是也会增加呢?

这也是很多人不拆分大类的借口。

各种程序设计语言中,本就有如包、命名空间等机制,将各种类组合在一起。在你不需要展开细节时,面对的是一个类的集合。

再进一步,还有各种程序库把这些打包出来的东西再进一步打包,让我们只要面对简单的接口,而不必关心各种细节。

软件正这样层层封装构建出来的。

目录
相关文章
|
3月前
|
XML JSON 前端开发
@RestController和@Controller的区别
【9月更文挑战第18天】@RestController和@Controller的区别
330 5
|
4月前
|
前端开发 Java 调度
女朋友要我讲解@Controller注解的原理,真是难为我了
该文章详细解析了Spring MVC中@Controller注解的工作原理,包括Spring如何解析该注解、处理标注的方法以及调度控制器方法以完成HTTP请求的过程。
女朋友要我讲解@Controller注解的原理,真是难为我了
|
开发框架 Java Spring
Service有多个实现类,它怎么知道该注入哪个ServiceImpl类?
@Service注解,其实做了两件事情: @Autowired注解的意思就是: @Autowired和@Resource两个注解的区别:
|
前端开发 Java Spring
controller层注入的service为null
controller层注入的service为null
187 0
|
Dubbo Java 应用服务中间件
compoment注解与Controller、Service、Repository注解的关系
Controller、Service、Repository这三个注解都是Spring提供的,他们三个有着相似的作用,即将被注解类的实例放入到Spring容器中,作用很相似那他们有什么区别呢?
169 0
compoment注解与Controller、Service、Repository注解的关系
|
Dubbo Java 应用服务中间件
controller层中注入controller
在controller中注入了另一个controller,按理说,三个注解controller、service、respository都是component衍生而来,任何被注入容器中的bean都可以以同样方式获取,但是在使用springboot项目时,controller中注入另一个controller发现失败。改成注入service成功。
505 0
|
Java Spring 数据格式
Controller和RestController的区别
1. Controller, RestController的共同点      都是用来表示Spring某个类的是否可以接收HTTP请求   2.  Controller, RestController的不同点      @Controller:  标识一个Spring类是Spring MVC controller处理器      @RestController:    @RestController是@Controller和@ResponseBody的结合体,两个标注合并起来的作用。
6990 0
|
数据库
关于静态方法利用@Autowired注入的service类问题
关于静态方法利用@Autowired注入的service类问题
203 0
|
网络架构
编写 Controller 类
编写 Controller 类
126 0
|
设计模式 Java 数据库连接
Spring - @Service、@Repository注解(service类、dao类)(实现类 & 接口类)
Spring - @Service、@Repository注解(service类、dao类)(实现类 & 接口类)
655 0