From 90343d493de78fc794e097817363a4ca97b6a2d3 Mon Sep 17 00:00:00 2001 From: luoxiang <2806718453@qq.com> Date: Tue, 10 Dec 2019 23:49:33 +0800 Subject: [PATCH] =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E6=A8=A1=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../chain_of_responsibility/Leader.java | 1 + .../behavioral/state/SpeedState.java | 2 +- .../heibaiying/behavioral/state/ZTest.java | 1 + .../heibaiying/behavioral/template/Phone.java | 3 + notes/Java_设计模式.md | 911 +++++++++++++++++- pictures/23_chain_of_responsibility.png | Bin 0 -> 9710 bytes pictures/23_state.png | Bin 0 -> 7245 bytes pictures/23_visitor.png | Bin 0 -> 10298 bytes 8 files changed, 916 insertions(+), 2 deletions(-) create mode 100644 pictures/23_chain_of_responsibility.png create mode 100644 pictures/23_state.png create mode 100644 pictures/23_visitor.png diff --git a/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/chain_of_responsibility/Leader.java b/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/chain_of_responsibility/Leader.java index daee062..315973e 100644 --- a/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/chain_of_responsibility/Leader.java +++ b/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/chain_of_responsibility/Leader.java @@ -4,6 +4,7 @@ public abstract class Leader { protected Leader leader; + // 责任链模式的核心：其需要持有一个后继者 public Leader setNextLeader(Leader leader) { this.leader = leader; return leader; diff --git a/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/state/SpeedState.java b/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/state/SpeedState.java index 000af72..9a36f0a 100644 --- a/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/state/SpeedState.java +++ b/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/state/SpeedState.java @@ -4,6 +4,6 @@ public class SpeedState extends State { @Override public void paly() { - System.out.println("你当前已处于加速播放状态"); + System.out.println("系统提示：你当前已处于加速播放状态"); } } diff --git a/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/state/ZTest.java b/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/state/ZTest.java index 7be8189..70ab183 100644 --- a/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/state/ZTest.java +++ b/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/state/ZTest.java @@ -6,6 +6,7 @@ public class ZTest { player.speed(); player.paly(); player.speed(); + player.paly(); player.pause(); player.close(); player.speed(); diff --git a/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/template/Phone.java b/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/template/Phone.java index 32d6af8..a22572d 100644 --- a/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/template/Phone.java +++ b/code/Java/design-pattern/src/main/java/com/heibaiying/behavioral/template/Phone.java @@ -2,6 +2,7 @@ package com.heibaiying.behavioral.template; public abstract class Phone { + // 模板方法 public void assembling() { adCamera(); addBattery(); @@ -11,6 +12,7 @@ public abstract class Phone { packaged(); } + // 具体方法 private void adCamera() { System.out.println("组装摄像头"); } @@ -26,5 +28,6 @@ public abstract class Phone { // 钩子方法 abstract boolean needAddNFC(); + // 抽象方法 abstract void packaged(); } diff --git a/notes/Java_设计模式.md b/notes/Java_设计模式.md index 809a03c..7609469 100644 --- a/notes/Java_设计模式.md +++ b/notes/Java_设计模式.md @@ -1654,28 +1654,937 @@ public class Business implements Observable { 观察者接口及用户实现类： ```java +public interface Observer { + void receive(String message); +} +``` +```java +public class User implements Observer { + + private String name; + + public User(String name) { + this.name = name; + } + + @Override + public void receive(String message) { + System.out.println(getName() + "收到消息：" + message); + } +} +``` + +测试商户发送消息： + +```java +Business business = new Business(); +business.addObserver(new User("用户1")); +business.addObserver(new User("用户2")); +business.addObserver(new User("用户3")); +business.notifyObservers("商品促销通知"); + +// 输出： +用户1收到消息：商品促销通知 +用户2收到消息：商品促销通知 +用户3收到消息：商品促销通知 ``` ## 2. 责任链模式 +### 2.1 定义 + +使多个对象都有机会处理请求，从而避免请求的发送者和接受者之间的耦合关系。将这些对象连接成一条链，并沿着这条链传递该请求，直到有一个对象处理它为止。 + +### 2.2 优点 + +- 降低了对象之间的耦合度； +- 增强了系统的可扩展性。可以根据需求增加新的处理类，满足开闭原则； +- 增强了系统的灵活性。当工作流程发生变化，可以动态地新增，删除成员或修改其调动次序； +- 每个对象只需保持一个指向其后继者的引用，而无需保持其他所有处理者的引用，从而可以避免了过多的条件判断语句； +- 每个类只需要处理自己该处理的工作，不能处理的则传递给下一个对象完成，符合类的单一职责原则。 + +### 2.3 示例 + +假设一个正常的流程，根据请假天数的不同，需要不同的领导共同审批： + +![23_chain_of_responsibility](D:\Full-Stack-Notes\pictures\23_chain_of_responsibility.png) + +申请单： + +```java +public class Application { + private String title; + /*请假天数*/ + private int dayNum; +} +``` + +抽象的领导类： + +```java +public abstract class Leader { + + protected Leader leader; + + // 责任链模式的核心：其需要持有一个后继者 + public Leader setNextLeader(Leader leader) { + this.leader = leader; + return leader; + } + + public abstract void approval(Application application); + +} +``` + +3天以下的请假只需要组长审核即可： + +```java +public class GroupLeader extends Leader { + @Override + public void approval(Application application) { + System.out.println(application.getTitle() + "被组长审批通过"); + if (application.getDayNum() >= 3) { + leader.approval(application); + } + } +} +``` + +3天以上5天以下的请假则需要组长和部门经理共同审核： + +```java +public class DepartManager extends Leader { + @Override + public void approval(Application application) { + System.out.println(application.getTitle() + "被部门经理审批通过"); + if (application.getDayNum() >= 5) { + leader.approval(application); + } + } +} +``` + +5 天以上的请假则还需要总经理审核： + +```java +public class President extends Leader { + @Override + public void approval(Application application) { + System.out.println(application.getTitle() + "被总经理审批通过"); + } +} +``` + +组建责任链并测试： + +```java +GroupLeader groupLeader = new GroupLeader(); +DepartManager departManager = new DepartManager(); +President president = new President(); +groupLeader.setNextLeader(departManager).setNextLeader(president); +groupLeader.approval(new Application("事假单", 3)); +groupLeader.approval(new Application("婚假单", 10)); + +// 输出： +事假单被组长审批通过 +事假单被部门经理审批通过 + +婚假单被组长审批通过 +婚假单被部门经理审批通过 +婚假单被总经理审批通过 +``` + + + ## 3. 模板方法模式 +### 3.1 定义 + +定义一个操作中的算法骨架，而将算法的一些步骤延迟到子类中，使得子类可以不改变该算法结构的情况下重定义该算法的某些特定步骤。它通常包含以下角色： + +**抽象父类 (Abstract Class) **：负责给出一个算法的轮廓和骨架。它由一个模板方法和若干个基本方法构成： + ++ 模板方法：定义了算法的骨架，按某种顺序调用其包含的基本方法。 + ++ 基本方法：可以是具体的方法也可以是抽象方法，还可以是钩子方法（在抽象类中已经实现，包括用于判断的逻辑方法和需要子类重写的空方法两种）。 + +**具体子类 (Concrete Class) **：实现抽象类中所定义的抽象方法和钩子方法。 + +### 3.2 优点 + ++ 父类定义了公共的行为，可以实现代码的复用； ++ 子类可以通过扩展来增加相应的功能，符合开闭原则。 + +### 3.3 示例 + +手机一般都有电池，摄像头等模块，但不是所有手机都有 NFC 模块，如果采用模板模式构建，则相关代码如下： + +![23_chain_of_responsibility](D:\Full-Stack-Notes\pictures\23_template.png) + +抽象的父类： + +```java +public abstract class Phone { + + // 模板方法 + public void assembling() { + adCamera(); + addBattery(); + if (needAddNFC()) { + addNFC(); + } + packaged(); + } + + // 具体方法 + private void adCamera() { + System.out.println("组装摄像头"); + } + + private void addBattery() { + System.out.println("安装电池"); + } + + private void addNFC() { + System.out.println("增加NFC功能"); + } + + // 钩子方法 + abstract boolean needAddNFC(); + + // 抽象方法 + abstract void packaged(); +} +``` + +具体的子类： + +```java +public class OlderPhone extends Phone { + + @Override + boolean needAddNFC() { + return false; + } + + @Override + void packaged() { + System.out.println("附赠一个手机壳"); + } +} +``` + +```java +public class SmartPhone extends Phone { + + @Override + boolean needAddNFC() { + return true; + } + + @Override + void packaged() { + System.out.println("附赠耳机一副"); + } +} +``` + +测试与输出结果如下： + +```java +OlderPhone olderPhone = new OlderPhone(); +olderPhone.assembling(); +// 输出： +组装摄像头 +安装电池 +附赠一个手机壳 + +SmartPhone smartPhone = new SmartPhone(); +smartPhone.assembling(); +// 输出： +组装摄像头 +安装电池 +增加NFC功能 +附赠耳机一副 +``` + + + ## 4. 策略模式 -## 5. 命令模式 +### 4.1 定义 + +定义一系列的算法，把它们一个个封装起来，并且使它们可以相互替换，且算法的变化不会影响使用算法的客户。策略模式实际上是一种无处不在的模式，比如根据在 controller 层接收到的参数不同，调用不同的 service 进行处理，这也是策略模式的一种体现。 + +### 4.2 示例 + +假设公司需要根据营业额的不同来选择不同的员工激励策略： + +![23_strategy](D:\Full-Stack-Notes\pictures\23_strategy.png) + +策略接口及其实现类： + +```java +public interface Strategy { + void execute(); +} + +public class TravelStrategy implements Strategy { + @Override + public void execute() { + System.out.println("集体旅游"); + } +} + +public class BonusStrategy implements Strategy { + @Override + public void execute() { + System.out.println("奖金激励"); + } +} + +public class WorkOvertimeStrategy implements Strategy { + @Override + public void execute() { + System.out.println("奖励加班"); + } +} +``` + +公司类： + +```java +public class Company { + + private Strategy strategy; + + public Company setStrategy(Strategy strategy) { + this.strategy = strategy; + return this; + } + + public void execute() { + strategy.execute(); + } +} +``` + +```java +public static void main(String[] args) { + // 营业额 + int turnover = Integer.parseInt(args[0]); + Company company = new Company(); + if (turnover > 1000) { + company.setStrategy(new BonusStrategy()).execute(); + } else if (turnover > 100) { + company.setStrategy(new TravelStrategy()).execute(); + } else { + company.setStrategy(new WorkOvertimeStrategy()).execute(); + } +} +``` ## 6. 状态模式 +### 6.1 定义 + +对有状态的对象，把复杂的判断逻辑提取到不同的状态对象中，允许状态对象在其内部状态发生改变时改变其行为。 + +### 6.2 优点 + +- 状态模式将与特定状态相关的行为局部化到一个状态中，并且将不同状态的行为分割开来，满足单一职责原则； +- 将不同的状态引入到独立的对象中，使得状态转换变得更加明确，且减少对象间的相互依赖； +- 有利于程序的扩展，通过定义新的子类很容易地增加新的状态和转换。 + +### 6.3 示例 + +假设我们正在开发一个播放器，它有如下图所示四种基本的状态：播放状态，关闭状态，暂停状态，加速播放状态。这四种状态间可以相互转换，但存在一定的限制，比如在关闭或者暂停状态下，都不能加速视频，采用状态模式来实现该播放器的相关代码如下： + +![23_state](D:\Full-Stack-Notes\pictures\23_state.png) + +定义状态抽象类： + +```java +public class State { + + private Player player; + + public void setPlayer(Player player) { + this.player = player; + } + + public void paly() { + player.setState(Player.PLAY_STATE); + } + + public void pause() { + player.setState(Player.PAUSE_STATE); + } + + public void close() { + player.setState(Player.CLOSE_STATE); + } + + public void speed() { + player.setState(Player.SPEED_STATE); + } +} +``` + +定义四种状态的具体实现类，并限制它们之间的转换关系： + +```java +public class PlayState extends State { + +} +``` + +```java +public class CloseState extends State { + @Override + public void pause() { + System.out.println("操作失败：视频已处于关闭状态，无需暂停"); + } + @Override + public void speed() { + System.out.println("操作失败：视频已处于关闭状态，无法加速"); + } +} +``` + +```java +public class PauseState extends State { + @Override + public void speed() { + System.out.print("操作失败：暂停状态下不支持加速"); + } +} +``` + +```java +public class SpeedState extends State { + @Override + public void paly() { + System.out.println("系统提示：你当前已处于加速播放状态"); + } +} +``` + +组装播放器： + +```java +public class Player { + + private State state; + + public final static PlayState PLAY_STATE = new PlayState(); + public final static PauseState PAUSE_STATE = new PauseState(); + public final static CloseState CLOSE_STATE = new CloseState(); + public final static SpeedState SPEED_STATE = new SpeedState(); + + public State getState() { + return state; + } + + public void setState(State state) { + this.state = state; + this.state.setPlayer(this); + } + + Player() { + // 假设播放器初始状态为关闭 + this.state = new CloseState(); + this.state.setPlayer(this); + } + + public void paly() { + System.out.println("播放视频"); + state.paly(); + } + + public void pause() { + System.out.println("暂停视频"); + state.pause(); + } + + public void close() { + System.out.println("关闭视频"); + state.close(); + } + + public void speed() { + System.out.println("视频加速"); + state.speed(); + } + +} +``` + +调用我们自定义的播放器： + +```java +Player player = new Player(); +player.speed(); +player.paly(); +player.speed(); +player.paly(); +player.pause(); +player.close(); +player.speed(); + +// 输出： +视频加速 +操作失败：视频已处于关闭状态，无法加速 +播放视频 +视频加速 +播放视频 +系统提示：你当前已处于加速播放状态 +暂停视频 +关闭视频 +视频加速 +操作失败：视频已处于关闭状态，无法加速 +``` + + + ## 7. 中介者模式 +### 7.1 定义 + +定义一个中介对象来封装一系列对象之间的交互，使原有对象之间的耦合松散，且可以独立地改变它们之间的交互。 + +### 7.2 优点 + +降低了对象之间的耦合度。 + +### 7.3 示例 + +这里以房屋中介为例，定义一个抽象的中介类，负责接收客户以及在客户间传递消息： + +```java +abstract class Mediator { + + public abstract void register(Person person); + + public abstract void send(String from, String message); +} +``` + +具体的房屋中介，它会将卖方的出售消息广播给所有人： + +```java +public class HouseMediator extends Mediator { + + private List personList = new ArrayList<>(); + + @Override + public void register(Person person) { + if (!personList.contains(person)) { + personList.add(person); + person.setMediator(this); + } + } + + @Override + public void send(String from, String message) { + System.out.println(from + "发送消息：" + message); + for (Person person : personList) { + String name = person.getName(); + if (!name.equals(from)) { + person.receive(message); + } + } + } +} +``` + +定义用户类，它可以是买方也可以是卖方，它们都是中介的客户： + +```java +public class Person { + + private String name; + private Mediator mediator; + + public Person(String name) { + this.name = name; + } + + public void send(String message) { + mediator.send(this.name, message); + } + + public void receive(String message) { + System.out.println(name + "收到消息：" + message); + } +} +``` + +最后买卖双方通过中介人就可以进行沟通： + +```java +public class ZTest { + public static void main(String[] args) { + HouseMediator houseMediator = new HouseMediator(); + Person seller = new Person("卖方"); + Person buyer = new Person("买方"); + houseMediator.register(seller); + houseMediator.register(buyer); + buyer.send("价格多少"); + seller.send("10万"); + buyer.send("太贵了"); + } +} + +// 输出： +买方发送消息：价格多少 +卖方收到消息：价格多少 +卖方发送消息：10万 +买方收到消息：10万 +买方发送消息：太贵了 +卖方收到消息：太贵了 +``` + + + ## 8. 迭代器模式 +### 8.1 定义 + +提供了一种方法用于顺序访问一个聚合对象中的各个元素，而又不暴露该对象的内部表示。 + +### 8.2 示例 + +假设现在对书架中的所有书籍进行遍历，首先定义书籍类： + +```java +public class Book { + private String name; + public Book(String name) { + this.name = name; + } +} +``` + +定义书柜接口及其实现类： + +```java +public interface Bookshelf { + void addBook(Book book); + void removeBook(Book book); + BookIterator iterator(); +} + +public class BookshelfImpl implements Bookshelf { + + private List bookList = new ArrayList<>(); + + @Override + public void addBook(Book book) { + bookList.add(book); + } + + @Override + public void removeBook(Book book) { + bookList.remove(book); + } + + @Override + public BookIterator iterator() { + return new BookIterator(bookList); + } +} +``` + +定义迭代器接口及其实现类： + +```java +public interface Iterator { + E next(); + boolean hasNext(); +} + +public class BookIterator implements Iterator { + + private List bookList; + private int position = 0; + + public BookIterator(List bookList) { + this.bookList = bookList; + } + + @Override + public Book next() { + return bookList.get(position++); + } + + @Override + public boolean hasNext() { + return position < bookList.size(); + } +} +``` + +调用自定义的迭代器进行遍历： + +```java +BookshelfImpl bookshelf = new BookshelfImpl(); +bookshelf.addBook(new Book("Java书籍")); +bookshelf.addBook(new Book("Python书籍")); +bookshelf.addBook(new Book("Go书籍")); +BookIterator iterator = bookshelf.iterator(); +while (iterator.hasNext()) { + System.out.println(iterator.next()); +} +``` + + + ## 9. 访问者模式 +### 9.1 定义 + +表示一个作用于某对象结构中各个元素的操作，它使得用户可以在不改变各个元素所对应类的前提下定义对这些元素的操作。 + +### 9.2 优缺点 + +优点： + +- 扩展性好：能够在不修改对象结构中的元素的情况下，为对象结构中的元素添加新的功能。 +- 复用性好：可以通过访问者来定义整个对象结构通用的功能，从而提高系统的复用程度。 +- 灵活性好：访问者模式将数据结构与作用于结构上的操作解耦，使得操作可相对自由地演化而不影响系统的数据结构。 + +缺点： + ++ 增加新的元素类很复杂； ++ 实现相对繁琐。 + + +### 9.3 示例 + +通常不同级别的员工对于公司档案的访问权限是不同的，为方便理解，如下图所示假设只有公开和加密两种类型的档案，并且只有总经理和部门经理才能进入档案室： + +![23_visitor](D:\Full-Stack-Notes\pictures\23_visitor.png) + +定义档案类及其实现类： + +```java +public interface Archive { + // 接受访问者 + void accept(Visitor visitor); +} + +public class PublicArchive implements Archive { + @Override + public void accept(Visitor visitor) { + visitor.visit(this); + } +} + +public class SecretArchive implements Archive { + @Override + public void accept(Visitor visitor) { + visitor.visit(this); + } +} +``` + +定义访问者接口及其实现类： + +```java +public interface Visitor { + // 访问公开档案 + void visit(PublicArchive publicArchive); + // 访问加密档案 + void visit(SecretArchive secretArchive); +} +``` + +```java +public class DepartManager implements Visitor { + + @Override + public void visit(PublicArchive publicArchive) { + System.out.println("所有公开档案"); + } + + @Override + public void visit(SecretArchive secretArchive) { + System.out.println("三级以下权限的加密档案"); + } +} +``` + +```java +public class President implements Visitor { + + @Override + public void visit(PublicArchive publicArchive) { + System.out.println("所有公开档案"); + } + + @Override + public void visit(SecretArchive secretArchive) { + System.out.println("所有加密档案"); + } +} +``` + +通过公司类来管理访问： + +```java +public class Company { + + private List archives = new ArrayList<>(); + + // 接收档案 + void add(Archive archive) { + archives.add(archive); + } + + // 移除档案 + void remove(Archive archive) { + archives.remove(archive); + } + + // 接待访问者 + void accept(Visitor visitor) { + for (Archive archive : archives) { + archive.accept(visitor); + } + } + +} +``` + +测试及输出结果： + +```java +Company company = new Company(); +company.add(new SecretArchive()); +company.add(new PublicArchive()); + +company.accept(new DepartManager()); +// 输出： +三级以下权限的加密档案 +所有公开档案 + +company.accept(new President()); +// 输出： +所有加密档案 +所有公开档案 +``` + + + ## 10. 备忘录模式 +### 10.1 定义 + +在不破坏封装性的前提下，捕获一个对象的内部状态，并在该对象之外保存这个状态，以便在需要时能将该对象恢复到原有状态。 + +### 10.2 优缺点 + +优点是能够用于异常情况下的恢复，能够提高系统的安全性；缺点是需要额外的存储空间来保存历史状态。 + +### 10.3 示例 + +编辑器的撤销功能，数据库的快照功能都是备忘录模式的一种典型实现，这里我们以 Git 保存历史版本信息为例，进行演示： + +文章类： + +```java +public class Article { + private String title; + private String content; +} +``` + +根据业务的需求，你可能只需要保存数据的部分字段，或者还需要额外增加字段（如保存时间等），所以需要在保存时需要将目标对象转换为备忘录对象： + +```java +// 备忘录对象 +public class Memorandum { + + private String title; + private String content; + private Date createTime; + + public Memorandum(Article article) { + this.title = article.getTitle(); + this.content = article.getContent(); + this.createTime = new Date(); + } + + public Article toArticle() { + return new Article(this.title, this.content); + } + +} +``` + +管理者类： + +```java +public class GitRepository { + + private List repository = new ArrayList<>(); + + // 保存当前数据 + public void save(Article article) { + Memorandum memorandum = new Memorandum(article); + repository.add(memorandum); + } + + // 获取指定版本类的数据 + public Article get(int version) { + Memorandum memorandum = repository.get(version); + return memorandum.toArticle(); + } + + // 撤销当前操作 + public Article back() { + return repository.get(repository.size() - 1).toArticle(); + } +} +``` + +测试类： + +```java +GitRepository repository = new GitRepository(); +Article article = new Article("Java手册", "版本一"); +repository.save(article); +article.setContent("版本二"); +repository.save(article); +article.setContent("版本三"); +repository.save(article); +System.out.println(repository.back()); +System.out.println(repository.get(0)); +``` + + + ## 11. 解释器模式 +给分析对象定义一种语言，并定义该语言的文法表示，然后设计一个解析器来解释语言中的语句，用编译语言的方式来分析应用中的实例。解释器模式的实现比较复杂，在通常的开发也较少使用，这里就不提供示例了。 + + + +以上所有示例的源码见：[design-pattern](https://github.com/heibaiying/Full-Stack-Notes/tree/master/code/Java/design-pattern) + + + + + +## 参考资料 + +1. Erich Gamma / Richard Helm / Ralph Johnson / John Vlissides . 设计模式（可复用面向对象软件的基础）. 机械工业出版社 . 2000-9 +2. 秦小波 . 设计模式之禅（第2版）. 机械工业出版社 . 2014-2-25 +3. [Java 设计模式](http://c.biancheng.net/view/1317.html) +4. [Java 设计模式精讲 Debug 方式 + 内存分析](https://coding.imooc.com/class/270.html) + diff --git a/pictures/23_chain_of_responsibility.png b/pictures/23_chain_of_responsibility.png new file mode 100644 index 0000000000000000000000000000000000000000..92c472bf8486b8634f1e9959d6f14550121821bc GIT binary patch literal 9710 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