接口使用规范
-
开发代码的程序员分为两种角色
- 作者(服务端程序员-提供接口服务的人)
- 用户(客户端程序员-使用接口提供的服务的人)
-
一般使用第三方提供的服务时,使用者手里是没有源码的,即使有也不能修改。
7大设计原则
-
开闭原则
- 解释:
- 当应用的需求改变时,在不修改软件实体的源代码或者二进制代码的前提下,可以扩展模块的功能,使其满足新的需求。对于扩展是开放的,但是对于修改是封闭的。
- 作用:开闭原则是面向对象程序设计的终极目标,它使软件实体拥有一定的适应性和灵活性的同时具备稳定性和延续性
- 测试便捷:软件遵守开闭原则的话,软件测试时只需要对扩展的代码进行测试就可以了,因为原有的测试代码仍然能够正常运行。
- 提高可复用性:粒度越小,被复用的可能性就越大;在面向对象的程序设计中,根据原子和抽象编程可以提高代码的可复用性。
- 提高可维护性:遵守开闭原则的软件,其稳定性高和延续性强,从而易于扩展和维护。
- 实现方法:
- 可以通过“抽象约束、封装变化”来实现开闭原则,即通过接口或者抽象类为软件实体定义一个相对稳定的抽象层,而将相同的可变因素封装在相同的具体实现类中
- 解释:
-
里氏替换原则
-
解释:
- 子类可以扩展父类的功能,但不能改变父类原有的功能
- 子类继承父类时,除添加新的方法完成新增功能外,尽量不要重写父类的方法
-
作用
- 里氏替换原则是实现开闭原则的重要方式之一。
- 任何能使用父类对象的地方,都应该能替换为子类对象。
- 替换后,语法不报错,逻辑无问题。
- 保证了转型的正确性
-
实现方法
- 子类可以实现父类的抽象方法,但不能覆盖父类的非抽象方法
- 子类中可以增加自己特有的方法
- 当子类的方法重载父类的方法时,方法的前置条件(即方法的输入参数)要比父类的方法更宽松
- 当子类的方法实现父类的方法时(重写/重载或实现抽象方法),方法的后置条件(即方法的的输出/返回值)要比父类的方法更严格或相等
-
-
依赖倒置原则
- 解释:
- 上层(调用者)不能直接依赖下层(被调用者),它们都应该依赖于抽象。
- 当下层剧烈变动时上层也要跟着变动,上层过于依赖于下层,就违反了依赖倒置规则。
- 抽象不应该依赖于具体,具体应该依赖于抽象。
- 作用·:依赖倒置原则是实现开闭原则的重要途径之一,它降低了客户与实现模块之间的耦合。
- 降低类间的耦合性。
- 提高系统的稳定性。
- 减少并行开发引起的风险。
- 提高代码的可读性和可维护性。
- 实现:
- 每个类尽量提供接口或抽象类,或者两者都具备
- 变量的声明类型尽量是接口或者是抽象类。
- 任何类都不应该从具体类派生。
- 使用继承时尽量遵循里氏替换原则
- 解释:
-
单一原则
- 解释:
- 每个方法、每个类、每个框架只负责一件事情。
- 作用:单一职责原则的核心就是控制类的粒度大小、将对象解耦、提高其内聚性
- 降低类的复杂度。一个类只负责一项职责,其逻辑肯定要比负责多项职责简单得多。
- 提高类的可读性。复杂性降低,自然其可读性会提高。
- 提高系统的可维护性。可读性提高,那自然更容易维护了。
- 变更引起的风险降低。变更是必然的,如果单一职责原则遵守得好,当修改一个功能时,可以显著降低对其他功能的影响。
- 实现:
- 单一职责原则是最简单但又最难运用的原则
- 需要设计人员发现类的不同职责并将其分离,再封装到不同的类或模块中
- 解释:
-
迪米特法则
- 解释:
- 一个类对其他类知道的越少越好(封装),只和朋友通信。
- ”朋友“指的是:对象本身、对象的成员对象、对象所创建的对象、方法的参数、方法的返回值、方法中实例化出的对象。
- 作用:
- 降低了类之间的耦合度,提高了模块的相对独立性。
- 由于亲合度降低,从而提高了类的可复用率和系统的扩展性。
- 但是,过度使用迪米特法则会使系统产生大量的中介类,从而增加系统的复杂性,使模块之间的通信效率降低
- 实现:
- 从依赖者的角度来说,只依赖应该依赖的对象。
- 从被依赖者的角度说,只暴露应该暴露的方法。
- 在类的划分上,应该创建弱耦合的类。类与类之间的耦合越弱,就越有利于实现可复用的目标。
- 在类的结构设计上,尽量降低类成员的访问权限。
- 在类的设计上,优先考虑将一个类设置成不变类。
- 在对其他类的引用上,将引用其他对象的次数降到最低。
- 不暴露类的属性成员,而应该提供相应的访问器(set 和 get 方法)。
- 谨慎使用序列化(Serializable)功能。
- 解释:
-
接口隔离原则
- 解释:
- 客户端不应该依赖它不需要的接口。一个类对另一个类的依赖应该建立在最小的接口上,即不应该定义一个总接口,而是将其拆分为许多小接口。
- 作用:
- 单一职责原则注重的是职责,而接口隔离原则注重的是对接口依赖的隔离。
- 单一职责原则主要是约束类,它针对的是程序中的实现和细节;接口隔离原则主要约束接口,主要针对抽象和程序整体框架的构建
- 将臃肿庞大的接口分解为多个粒度小的接口,可以预防外来变更的扩散,提高系统的灵活性和可维护性。
- 接口隔离提高了系统的内聚性,减少了对外交互,降低了系统的耦合性。
- 如果接口的粒度大小定义合理,能够保证系统的稳定性;但是,如果定义过小,则会造成接口数量过多,使设计复杂化;如果定义太大,灵活性降低,无法提供定制服务,给整体项目带来无法预料的风险。
- 使用多个专门的接口还能够体现对象的层次,因为可以通过接口的继承,实现对总接口的定义。
- 能减少项目工程中的代码冗余。过大的大接口里面通常放置许多不用的方法,当实现这个接口的时候,被迫设计冗余的代码
- 实现:
- 接口尽量小,但是要有限度。一个接口只服务于一个子模块或业务逻辑。
- 为依赖接口的类定制服务。只提供调用者需要的方法,屏蔽不需要的方法。
- 了解环境,拒绝盲从。每个项目或产品都有选定的环境因素,环境不同,接口拆分的标准就不同深入了解业务逻辑。
- 提高内聚,减少对外交互。使接口用最少的方法去完成最多的事情。
- 解释:
-
组合优于继承原则
- 解释:
- 要求在软件复用时,要尽量先使用组合或者聚合等关联关系来实现,其次才考虑使用继承关系来实现
- 继承来的方法在未来底层实现可能改变,造成利用代码底层实现的当前代码错误,如果要使用继承关系,则必须严格遵循里氏替换原则
- 作用·:通常类的复用分为继承复用和合成复用两种
- 继承复用:继承复用虽然有简单和易实现的优点,但它也存在以下缺点
- 继承复用破坏了类的封装性。因为继承会将父类的实现细节暴露给子类,父类对子类是透明的,所以这种复用又称为“白箱”复用。
- 子类与父类的耦合度高。父类的实现的任何改变都会导致子类的实现发生变化,这不利于类的扩展与维护。
- 它限制了复用的灵活性。从父类继承而来的实现是静态的,在编译时已经定义,所以在运行时不可能发生变化。
- 合成复用:可以将已有对象纳入新对象中,成为新对象的一部分,新对象可以调用已有对象的功能
- 它维持了类的封装性。因为成分对象的内部细节是新对象看不见的,所以这种复用又称为“黑箱”复用。
- 新旧类之间的耦合度低。这种复用所需的依赖较少,新对象存取成分对象的唯一方法是通过成分对象的接口。
- 复用的灵活性高。这种复用可以在运行时动态进行,新对象可以动态地引用与成分对象类型相同的对象。
- 继承复用:继承复用虽然有简单和易实现的优点,但它也存在以下缺点
- 实现:
- 将已有的对象纳入新对象中,作为新对象的成员对象来实现的,新对象可以调用已有对象的功能,从而达到复用。
- 解释:
7大设计模式总结
这些原则的目的只有一个:降低对象之间的耦合,增加程序的可复用性、可扩展性和可维护性。
UML线条含义
-
泛化:
场景:是对象之间耦合度最大的一种关系,是父类与子类之间的关系,是一种继承关系
标志:空心三角箭头的实线,箭头从子类指向父类
-
实现关系:
场景:接口与实现类之间的关系
标志:空心三角箭头的虚线,箭头从实现类指向接口
-
依赖:
场景:一个类作为另一个类的局部变量,方法参数,或者对该类静态方法的引用
标志:虚线加箭头,箭头从使用类指向被依赖的类
-
一般关联:
场景:通常将一个类的对象作为另一个类的成员变量来实现关联关系
标志:
- 双向的关联可以用带两个箭头或者没有箭头的实线来表示
- 单向的关联用菱形加实线加箭头(箭头指向被关联者) / 实线加箭头,箭头从使用类指向被关联的类
-
组合
场景:强关联,部分与整体离不开,例如嘴与头
标志:实心菱形实线,菱形指向整体
-
聚合
场景:弱关联,整体可以离开部分,例如老师可以离开学校而存在
标志:空心菱形实线,菱形指向整体
UML关系示例图