前言
前面我们提到过 SOLID 原则,实际上 SOLID 由 5 个设计原则组成,分别是:单一职责原则、开闭原则、里氏替换原则、接口隔离原则和依赖反转原则。它们分别对应 SLOID 中的 S、O、L、I、D 这 5 个英文字母。
今天来学习下 SOLID 原则中的第一个原则:单一职责原则。
如何理解单一职责原则(SRP)
单一职责原则 (Single Responsibility Principle),缩写为 SRP。
英文原文的描述:A class or module should have a single responsibility。翻译成中文就是,一个类或模块只负责完成一个职责或功能。
注意,这个原则描述的对象包含两个,一个是类,一个是模块。不管是哪个对象,单一职责在应用到这两个面对对象的时候,道理都是相通的。接下来,我会只从"类"设计的角度,来讲解如何应用这个原则。
一个类只负责完成一个职责或者功能。也就是说,不要设计大而全的类,要设计粒度小、功能单一的类。要把大而全的类拆分成多个功能更加单一、粒度更细的类。
换个角度来说,一个类包含了两个或者两个以上业务不相干的功能,就不符合单一职责原则。
例如,一个类里面包含订单的一些操作,又包含用户的一些操作。而订单和用户是两个独立的业务领域模型,我们将两个不相干的功能放到同一个类中,就违反了单一职责原则。为了满足单一职责原则,需要将这个类拆分成两个粒度更细、功能更单一的两个类:订单类和用户类。
如何判断类的职责是否足够单一?
从刚刚的例子来看,单一职责原则看似不难应用。那是因为我举的例子比较极端,一眼就能看出订单和用户毫不相干。但大部分情况下,类里的方法是归类为同一类功能,还是归为不相关的两类功能,并不是那么容易判定的。在真实的软件开发中,对一个类是否职责单一的判定,是很难拿捏的。
在一个社交产品中,用下面的 UserInfo
来记录用户的信息。你觉得是否符合单一职责原则呢?
java
public class UserInfo {
private long userId;
private String username;
private String email;
private String telephone;
private long createTime;
private long lastLoginTime;
private String avatarUrl;
private String provinceOfAddress; // 省
private String cityOfAddress; // 市
private String regionOfAddress; // 区
private String detailOfAddress; // 详细地址
// 省略其他属性和方法...
}
对于这个问题,有两种不同的观点。
- 一种观点是,
UserInfo
类包含的都是跟用户相关的信息,所有的属性和方法都隶属于用户这样一个业务模型,满足单一职责原则; - 另一种观点是,地址信息在
UserInfo
类中,所占比重较高,可以继续拆分成独立的UserAddress
,UserInfo
只保留出UserAddress
之外的属性,拆分之后的两个类的职责更加单一。
实际上,要做出选择,我们不能脱离具体的应用常见。如果,在这个社交产品中,用户地址信息和其他信息一样,只是单纯地用于展示,那 UserInfo
现在的设计就是合理的。但是,如果这个社交产品发展地比较好,之后又在产品中添加了电商的模块,用户的地址信息还会用在电商物流中,那我们最好将地址信息从 UserInfo
中拆分出来,独立成用户物流信息。
再进一步延伸下,如果做这个社交产品的公司发展地越来越好,公司内部有开发出了很多其他产品。公司希望支持统一账号系统,也就是用户一个账号可以在公司内的所有产品中登录。这个时候,我们就需要对 UserInfo
进行拆分,将跟身份认证相关的信息(比如 email
、telephone
等)抽取成独立的类。
从上面的例子,可以总结出,在不同的应用场景、不同阶段的需求背景下,对同一个类的职责是否单一的判定,都是不一样的。在某种应用场景或者当下的需求背景下,一个类的设计可能符合单一职责原则了,但是如果换个应用场景或者未来的某个需求背景下,可能就不满足了,需要继续拆分成粒度更细的类。
此外,从不同的业务层面去看待同一个类的设计,对类是否职责单一,也会有不同的认识。比如,例子用的 UserInfo
类。如果从"用户"这个业务层面来看,UserInfo
包含的信息都属于用户,满足单一职责原则。如果从更加细分的"用户展示信息" "地址信息" "登录认证信息"等等这些细细粒度的业务层面来看,那 UserInfo
就应该继续拆分。
综上所述,评价一个类的职责是否足够单一,我们并没有非常明确的、可以量化的标准。实际上,在真正的软件开发中,也没必要过于未雨绸缪,过度设计。所以,我们可以先写一个粗粒度的类,满足业务需求。随着业务的发展,如果粗粒度的类越来越大,代码越来越多,这个时候,我们就可以将这个粗粒度的类,拆分成几个更细粒度的类。这个就是所谓的重构。
这里还有些小技巧,能够辅助你,从侧面判断一个类的职责是否足够单一:
- 类中的代码行数、函数或属性过多,会影响代码的可读性和可维护性,我们就需要考虑读类进行拆分。
- 类依赖的其他类过多,或者依赖的类的其他类过多,不符合高内聚、低耦合的设计思想,就需要考虑拆分。
- 私有方法过多,就要考虑是否将私有方法独立到新的类中,设置为 public 方法,供更多的类适用,从而提高代码的复用性。
- 比较难给类起合适的名字,很难用一个业务名词概括,或者只能用一些笼统的
Manager
、Context
之类的词语来命名,这就说明类的职责定义得可能不够清楚。 - 类中的大量方法都是集中操作类中的某几个属性 ,比如,在
UserInfo
中,如果有一办的方法都是在操作address
信息,那就可以考虑将这几个属性和对应的方法拆分出来。
不过,你可能有这样的疑问:在上面的小技巧中,提到的类的代码行数、函数或者属性过多,就有可能不满足单一职责原则。那多少行代码才算是行数过多呢?多少个函数、属性才称得上过多呢?
实际上,这个问题,很不好定量的回答。实际上,可以给你一个凑活能用的、比较宽泛的、可量化的标准,那就是一个类的代码行数最好不能超过 200
行,函数及属性的个数最好不要超过 10 个。
实际上,从另一种角度来看,当一个类的代码,读起来让你头大了,实现某个功能时不知道该用哪个函数了,想用哪个函数翻半天找不到了,只能用到一个小功能却要引入整个类的时候,这说明类的行数、函数、属性过多了。
类的职责是否设计地越单一越好?
为了满足单一职责,是不是把类拆得越细就越好呢?答案是否定的。通过一个例子来解释下。 Serialization
类实现了一个简单协议的序列化和反序列化功能,具体代码如下:
java
/**
* protocol format: identifier-string;(gson string)
* For example: UEUEUE; {"a":"A", "b":"B"}
*/
public classs Serialization {
private static final String IDENTIFIER_STRING = "UEUEUE;";
private Gson gson;
public Serialization() {
this.gson = new Gson();
}
public String serialize(Map<String, String> object) {
StringBuilder textBuilder = new StringBuilder();
textBuilder.append(IDENTIFIER_STRING);
textBuilder.append(gson.toJson(object));
return textBuilder.toString();
}
public Map<String, String> deserialize(String text) {
if(!text.startsWith(IDENTIFIER_STRING)) {
return Collections.emptyMap();
}
String gsonStr = text.substring(IDENTIFIER_STRING.length());
return gson.fromJson(gsonStr, Map.class);
}
}
如果我们想让类的职责更加单一,我们对 Serialization
类进一步拆分,拆分成一个只负责序列化工作的 Serializer
类和另一个只负责反序列化工作的 Deserializer
类。拆分后的代码如下所示:
java
public classs Serializer {
private static final String IDENTIFIER_STRING = "UEUEUE;";
private Gson gson;
public Serializer() {
this.gson = new Gson();
}
public String serialize(Map<String, String> object) {
StringBuilder textBuilder = new StringBuilder();
textBuilder.append(IDENTIFIER_STRING);
textBuilder.append(gson.toJson(object));
return textBuilder.toString();
}
}
public classs Deserializer {
private static final String IDENTIFIER_STRING = "UEUEUE;";
private Gson gson;
public Deserializer() {
this.gson = new Gson();
}
public Map<String, String> deserialize(String text) {
if(!text.startsWith(IDENTIFIER_STRING)) {
return Collections.emptyMap();
}
String gsonStr = text.substring(IDENTIFIER_STRING.length());
return gson.fromJson(gsonStr, Map.class);
}
}
虽然经过拆分之后,Serializer
类和 Deserializer
类的职责更加单一了,但也随之带来了新的问题。如果我们修改了协议的格式,数据标识从 UEUEUE
改成了 DFDFDF
,或者序列化方式从 JSON
改成了 XML
,那 Serializer
类和 Deserializer
类都需要做相应的改动,代码的内聚性显然没有原来的 Serialization
高了。而且,如果我们仅仅对 Serializer
类做了协议修改,而忘记了修改 Deserializer
类,那就会导致序列化和反序列化不匹配,程序运行出错,拆分之后,代码的可维护性变差了。
实际上,不管是应用设计原则还是设计模式,最终的目的还是提高代码的可读性、可扩展性、可维护性、复用性等。我们在考虑应用某一设计原则是否合理的时候,也可以以此作为最终的考量标准。
回顾
1.如何理解单一职责原则(SRP)?
一个类只负责完成一个职责或功能。不要设计大而全的类,要设计粒度小、功能单一的类。单一职责原则是为了提高代码的高内聚、低耦合,提高代码的复用性、可读性、可维护性。
2.如何判断类的职责是否足够单一?
不同的应用场景、不同阶段的需求、不同的业务背景,对同一个类的职责是否单一,可能会有不同的判定结果。实际上,一些侧面的指标更具有指导意义和可执行性,比如,出现下面这些情况,就有可能说明这个类的设计不满足单一职责原则:
- 类中的代码行数、函数、属性过多。
- 类依赖的其他类过多,或者依赖类的其他类过多。
- 私有方法过多。
- 比较难给一个类起一个合适的名字。
- 类中的大量方法都是集中操作类中的几个属性。
3.类的职责是否设计的越细越好?
单一职责原则通过避免设计大而全的类,避免将不相关的功能聚合在一起,来提高类的高内聚性。同时,类职责单一,类依赖和被依赖的其他类也会变少,减少了代码的耦合性,以此来实现代码的高内聚、低耦合。但是,如果拆分地过细,实际上会适得其反,反倒会降低代码的内聚性,也会影响代码的可维护性。