From 8b9fc8191962303c6c84f29e10ef20fc7eff1e39 Mon Sep 17 00:00:00 2001 From: Charles7c Date: Fri, 9 Sep 2022 22:47:24 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=EF=BC=9A=E3=80=8A=E8=AE=BE?= =?UTF-8?q?=E8=AE=A1=E6=A8=A1=E5=BC=8F=E4=B9=8B=E5=8D=95=E4=BE=8B=E6=A8=A1?= =?UTF-8?q?=E5=BC=8F=E3=80=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2021/05/29/设计模式之单例模式.md | 324 ++++++++++++++++++ ...nx转发请求,报13:Permission denied错误.md | 4 +- .../public/img/2021/05/29/202105291230868.jpg | Bin 0 -> 41638 bytes 3 files changed, 326 insertions(+), 2 deletions(-) create mode 100644 docs/categories/fragments/2021/05/29/设计模式之单例模式.md create mode 100644 docs/public/img/2021/05/29/202105291230868.jpg diff --git a/docs/categories/fragments/2021/05/29/设计模式之单例模式.md b/docs/categories/fragments/2021/05/29/设计模式之单例模式.md new file mode 100644 index 000000000..918bff6c2 --- /dev/null +++ b/docs/categories/fragments/2021/05/29/设计模式之单例模式.md @@ -0,0 +1,324 @@ +--- +title: 设计模式之单例模式 +author: 查尔斯 +date: 2021/05/29 13:14 +categories: + - 杂碎逆袭史 +tags: + - 设计模式 +--- + +# 设计模式之单例模式 + +**C:** 在现代程序开发过程中,无论是新手还是老手,都要熟练掌握面向对象的编程思想及编程方式。 + +而在面向对象的编程方式中,我们作为程序的掌控者,在操作一些业务单元时,都要先创建好对应的对象,然后通过操作对象来实现业务处理。 + + + +正因如此,对象的创建自然是每个程序员都手到擒来的事情了。 + +![202105291230868](../../../../../public/img/2021/05/29/202105291230868.jpg) + +大多数情况下,我们创建对象都是采用如下方式实现的: + +```java +类名 对象名 = new 类名(); +``` + +这种方式是最基本的对象创建方式,每次执行 new 关键字,都会为该类产生一个新的对象。 + +但在一些特殊的场景下,对于一个特定的类,我们可能希望它在全局只产生一个对象,即每次我们获取它的对象时,获取到的永远都是同一个! + +这个需求很常见,在众多设计模式中也恰好有一种可以满足我们这项需求的模式,它就是单例模式。 + +## 简介 + +单例模式(Singleton Pattern)是 Java 中最简单的设计模式之一。这种类型的设计模式属于创建型模式,它提供了一种创建对象的最佳方式。 + +这种模式涉及到一个单一的类,该类负责创建自己的对象,同时确保只有单个对象被创建。这个类提供了一种访问其唯一的对象的方式,可以直接访问,不需要实例化该类的对象。 + +作为创建型设计模式一员的单例模式,无论是在日常工作使用中,还是在基础面试过程中,亦或是面试一些框架原理时,都或多或少会提及它。 + +但是,大多数初级程序员对单例模式,仅仅是了解到两种实现方式,即懒汉式、饿汉式的程度,而实际上呢,在面对多线程的环境下,单例模式也诞生了很多性能又佳且线程安全的实现方式,本篇笔者就带你一起研究。 + +## 饿汉式 + +```java +public class Singleton { + + /** + * 私有化构造方法 + */ + private Singleton() {} + + /** + * 静态唯一实例 + */ + private static Singleton instance = new Singleton(); + + /** + * 公共的获取该类唯一实例的方法 + * + * @return 该类唯一实例 + */ + public static Singleton getInstance() { + return instance; + } + +} +``` + +首先,通过私有化构造方法,外界就不能再直接通过 new 的方式来创建该类的对象了。 + +其次,为了保证在全局只有一个该类的实例,那么就要考虑将该类的唯一实例设置为静态的,因为静态信息是随着类的加载而初始化的,所以它只会执行一次且会一直随着该类的存在而存在。 + +最后,为了让外界能够获取到该类的唯一实例,我们就必须要准备一个公共的静态方法来提供这一唯一实例。 + +## 懒汉式 + +饿汉式之所以称之为饿汉式,就是因为饿汉式不管你是不是立刻需要该类的唯一实例,只要它的类加载,这个唯一实例就创建好了,像一个饿了很久的大汉一样迫不及待。 + +但是,当我们暂时不需要该类的唯一实例时,饿汉式所提供的唯一实例依然会出现在内存中,占据着我们宝贵的内存空间。 + +所以,随之而来的就是,我们希望这个类在我们需要它的唯一实例时再去给我们提供好,懒汉式也就随之出现了。 + +```java +public class Singleton { + + /** + * 私有化构造方法 + */ + private Singleton() {} + + /** + * 静态唯一实例 + */ + private static Singleton instance; + + /** + * 公共的获取该类唯一实例的方法 + * + * @return 该类唯一实例 + */ + public static Singleton getInstance() { + if (null == instance) { + instance = new Singleton(); + } + return instance; + } + +} +``` + +通过在 getInstance 方法中判断没有唯一实例后,再进行初始化,就可以保证这个唯一实例会在我们需要它的时候才会进行创建,我们称之为懒加载。 + +## 线程安全的懒汉式 + +但是,因为我们把这个创建实例的过程放在了 getInstance 方法中,如果是单线程来操作该方法,那没有任何意外。 + +可惜的是,很多时候,我们的系统环境都是多线程的,当多线程来操作该方法时,因为线程抢占式执行,可能会出现:线程 1 在执行该方法,通过 if null 判断之后,被线程 2 抢占了 CPU 资源,这时候线程 2 在执行该方法的时候,因为该类唯一的实例还没创建,所以线程 2 也可以通过 if null 判断 ...,于是后面就会创建多个该类的实例了。 + +为了解决多线程的安全问题,首先应该想到的就是给这个方法添加 synchronized 关键字,这样就可以保证同一时刻只允许一个线程来操作该方法了。 + +```java +public class Singleton { + + /** + * 私有化构造方法 + */ + private Singleton() {} + + /** + * 静态唯一实例 + */ + private static Singleton instance; + + /** + * 公共的获取该类唯一实例的方法 + * + * @return 该类唯一实例 + */ + public synchronized static Singleton getInstance() { + if (null == instance) { + instance = new Singleton(); + } + return instance; + } + +} +``` + +## 双重校验锁(双检索) + +但是在方法层面添加锁之后,意味着后续哪怕已经创建好了唯一实例,每次还是要被锁 “严防死守”,效率太低,那怎么办才好呢? + +```java +public class Singleton { + + /** + * 私有化构造方法 + */ + private Singleton() {} + + /** + * 静态唯一实例,添加volatile关键字防止指令重排 + */ + private static volatile Singleton instance; + + /** + * 公共的获取该类唯一实例的方法 + * + * @return 该类唯一实例 + */ + public static Singleton getInstance() { + // 提升效率的实例检测 + if (null == instance) { + // 同步锁,解决线程安全问题 + synchronized (Singleton.class) { + // 再次实例检测 + if (null == instance) { + instance = new Singleton(); + } + } + } + return instance; + } + +} +``` + +在这种方式里,getInstance 方法不再添加 synchronized 关键字,而是通过在方法体中添加同步代码块的方式来解决线程安全问题。 + +为什么要先做一次 if null 判断呢?上一种方式中也提到了,懒汉式实现中,线程不安全的地方是因为最开始还没有创建好唯一实例的时候,多个线程可能都通过了 if null 判断,然后导致多个实例被创建。而如果在创建了唯一实例之后,是不是多线程环境其实就没有什么影响了,因为多个线程过来都是无法通过 if null 判断,直接获取该类的唯一实例就可以了,所以它可以有效地提升后续多线程操作该方法的效率。 + +至于后面的同步代码块,笔者觉得不需要解释了吧?它就是对上一种方式的锁范围进行了缩小而已,缩小之后,之前该如何,现在自然还如何。 + +当然,笔者也明白,还是会有同学疑惑为什么同步锁内还要再判断,为什么不用对象锁?一个个再解答一下。 + +同步锁内还要进行判断,是因为 getInstance 方法这回没加锁,如果是最开始没创建好唯一实例的时候,多线程来操作该方法,可能都会通过 if null 判断,如果同步锁内不加判断,那只不过是让创建多个实例的过程变成排队方式而已,最终它还是会出现多个实例。所以必须再加一次判断,来让即使通过了 if null 判断的线程也不能 “放肆”。正因为如此,这种方式被称为双重校验。 + +还有,不用对象锁是因为它也用不了,静态方法内只能用静态信息啊。 + +当然,笔者也差点忘记提的是,我们在这个静态唯一实例前添加了一个 volatile 关键字,这也是你们容易忽视掉的。 + +为什么要添加这个关键字呢?因为 Java 中通过 new 来创建对象过程中有一些小问题存在。想要看看 new 对象究竟是如何执行的,可以通过 **javap -c 字节码文件** 指令来查看一下它所执行的 JVM 指令。 + +笔者这里就不贴 JVM 指令代码了,简单说一下创建对象的流程。 + +1.分配对象的内存空间 + +2.调用构造器方法,执行对象初始化 + +3.将对象内存地址赋值给引用变量 + +在这些指令实际执行的过程中,指令顺序是有可能经过 JVM 和 CPU 优化而重排顺序的。以上代码 2,3 可能发生重新排序,也就是说,最终执行的顺序可能是 1,3,2,即先将分配的内存地址赋值给引用变量再初始化对象。 + +单线程情况下,自然没有问题,但如果是多线程环境的话,当线程 1 执行完了 1,3 之后,唯一实例虽然还没有完成初始化,但是此时它也不再指向 null 了,如果这时候线程 2 抢占到了 CPU 资源,执行外层的 if null 判断后发现实例已经不为 null 了,直接返回,这时候返回的是一个未初始化的实例,如果线程 2 恰好又立即使用上了这个未初始化的实例,就会出现一系列的问题。 + +所以,我们要禁止在 new 这个唯一实例时发生指令重排序,那就需要将它用 volatile 关键字来进行修饰,volatile 关键字可以阻止变量访问前后的指令重排,保证指令执行顺序。这样它就不会发生这个问题了,也就保证了多线程环境内的系统安全。 + +## 静态内部类(登记式) + +双重校验锁形式设计的还真的挺不错的。不过,笔者相信还是会有同学不太甘心,难道就没有又能拥有懒汉式的懒加载特点,又拥有饿汉式无需关注线程安全的方式吗? + +你再看看下面的这种方式。 + +```java +public class Singleton { + + /** + * 私有化构造方法 + */ + private Singleton() {} + + /** + * 静态内部类 + */ + private static class SingletonHolder { + private static final Singleton INSTANCE = new Singleton(); + } + + /** + * 公共的获取该类唯一实例的方法 + * + * @return 该类唯一实例 + */ + public static Singleton getInstance() { + return SingletonHolder.instance; + } + +} +``` + +在这种方式里,我们定义了一个静态内部类,在静态内部类中,定义了一个静态常量,它就是当前类的唯一实例。然后在 getInstance 方法中,我们只需要从静态内部类中将这个唯一实例取出来就可以了。 + +因为这个唯一实例是定义在静态内部类中的,静态内部类是在使用时才会加载的,而不是在 Singleton 类加载的时候加载的,所以它拥有了懒汉式的懒加载特点。 + +又因为它是定义在一个静态内部类中的静态常量,所以它也不存在线程安全问题,真可谓是一举两得。 + +## 枚举 + +除了双重校验锁方式之外,还有优雅的静态内部类方式,看起来似乎已经能够满足我们使用了。没错,在大多数情况下,它们已经没有问题了。但还不算完,上述的这些方式,它们都还存在着一种致命的问题,这个问题会破坏我们设计的单例实现。 + +不知道你还认不认识 Java 的一个高级特性:反射呢?这个让我们又爱又恨的特性,在这个时候只能给我们带来无穷的碎碎念了。 + +通过暴力反射,我们对这个单例类所设置的构造方法私有化,就失去了它的价值。 + +```java +// 获取字节码对象 +Class singletonClass = Singleton.class; +// 获取无参构造方法 +Constructor constructor = singletonClass.getDeclaredConstructor(); +// 暴力反射 +constructor.setAccessible(true); +// 创建两个对象 +Singleton singleton1 = constructor.newInstance(); +Singleton singleton2 = constructor.newInstance(); +// 比较结果,并非同一个对象 +System.out.println(singleton1 == singleton2); // false +``` + +不要急,我们再来认识最后一种比较优雅的单例实现:枚举。通过定义一个枚举类型就可以实现单例模式,并且还可以解决掉反射的问题。 + +我们都知道枚举类型实际上就是一个继承自 Enum 类型的 final 类,枚举类型的构造默认也是私有的,而在枚举类型中定义的枚举值们则实际上是该类的一个个静态实例对象而已。所以,我们只定义一个枚举值,这不就是该类的单例了吗? + +再加上枚举是 Java 团队制定的一种语法,在运行时,JVM 会阻止反射方式获取枚举类的私有构造方法。这样我们的单例模式就不会被破坏掉了。 + +```java +public enum Singleton { + + /** + * 静态唯一实例 + */ + INSTANCE + +} +``` + +如果你不相信,可以用反射去试试,你将会遇见下方的结果。 + +```java +Exception in thread "main" java.lang.NoSuchMethodException: com.example.pattern05.SingletonPattern.demo6.Singleton.() + at java.lang.Class.getConstructor0(Class.java:3082) + at java.lang.Class.getDeclaredConstructor(Class.java:2178) + at com.example.pattern05.SingletonPattern.demo6.Test.main(Test.java:16) +``` + +另外,其实枚举式还有一个好处,就是如果涉及到反序列化创建单例对象时,它可以保证反序列化的返回结果是同一对象。对于其他方式实现的单例模式,如果既想要做到可序列化,又想要反序列化为同一对象,则必须实现 readResolve 方法。 + +## 后记 + +**C:** 其实,还有一些像 CAS 等方式实现的单例模式,有兴趣的同学们可以自行去了解一下。而上述的这些方式,是我们平时用到最多的单例模式实现方式。 + +在实际使用的时候,需要根据实际的需求来灵活进行选择,当你确定要在全局持续使用的时候,那么饿汉式、枚举式都比较适合,而如果明确需要懒加载的时候,那么双重校验锁、静态内部类的方式就比较适合。而如果你想防止反射破坏的话,那就可以选择枚举式。如果你需要涉及反序列化创建对象,那也可以选择枚举式。但是,如果你需要对单例类进行继承等操作,那就不能选择它了。 + +总之,能够解决需求的方式就是好方式。 + +## 参考资料 + +[1]单例模式:https://www.runoob.com/design-pattern/singleton-pattern.html + +[2]为什么双重检查锁模式需要 volatile ?https://www.cnblogs.com/goodAndyxublog/p/11356402.html + +[3]如何写出更优雅的单例模式?https://mp.weixin.qq.com/s/AdJI5a4w515SPPI_4gVImA diff --git a/docs/categories/issues/2022/09/05/Nginx转发请求,报13:Permission denied错误.md b/docs/categories/issues/2022/09/05/Nginx转发请求,报13:Permission denied错误.md index 8c982b104..cf9093872 100644 --- a/docs/categories/issues/2022/09/05/Nginx转发请求,报13:Permission denied错误.md +++ b/docs/categories/issues/2022/09/05/Nginx转发请求,报13:Permission denied错误.md @@ -105,6 +105,6 @@ setsebool -P httpd_can_network_connect 1 执行后,立竿见影。忍不住感叹:Linux 知识学无止境。 -## 参考文献 +## 参考资料 -[1]liweitao7610. 解决SELinux阻止Nginx访问服务[EB/OL]. https://blog.csdn.net/liweitao7610/article/details/107073852. 2022-09-05 +[1]解决SELinux阻止Nginx访问服务:https://blog.csdn.net/liweitao7610/article/details/107073852 diff --git a/docs/public/img/2021/05/29/202105291230868.jpg b/docs/public/img/2021/05/29/202105291230868.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6034be66e8494351ddad6efaa4bc4c54fc7ab57b GIT binary patch literal 41638 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