From 66382fd7700a28a4ef7a1ccfe46c4404cc8d1f43 Mon Sep 17 00:00:00 2001
From: root <625826499@qq.com>
Date: Sun, 15 Mar 2020 23:47:06 +0800
Subject: [PATCH] =?UTF-8?q?Spring=E5=AE=98=E7=BD=91=E9=98=85=E8=AF=BB?=
=?UTF-8?q?=EF=BC=88=E5=8D=81=E4=BA=8C=EF=BC=89ApplicationContext=E8=AF=A6?=
=?UTF-8?q?=E8=A7=A3=EF=BC=88=E4=B8=AD=EF=BC=89=20=E5=AF=B9ApplicationCont?=
=?UTF-8?q?ext=E5=81=9A=E4=BA=86=E8=BF=9B=E4=B8=80=E6=AD=A5=E7=9A=84?=
=?UTF-8?q?=E8=A7=A3=E6=9E=90=20=E4=BB=A5ApplicationContext=E4=B8=BA?=
=?UTF-8?q?=E5=88=87=E5=85=A5=E7=82=B9=EF=BC=8C=E5=88=86=E6=9E=90=E4=BA=86?=
=?UTF-8?q?Spring=E4=B8=AD=E7=9A=84resource=E8=B7=9F=E6=97=B6=E9=97=B4?=
=?UTF-8?q?=E7=9B=91=E5=90=AC=E6=9C=BA=E5=88=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
...43\357\274\210\344\270\255\357\274\211.md" | 812 ++++++++++++++++++
.../image/2020010601.png" | Bin 0 -> 857311 bytes
.../image/2020030901.png" | Bin 0 -> 6137 bytes
.../image/2020031001.png" | Bin 0 -> 17813 bytes
.../image/2020031002.png" | Bin 0 -> 4104 bytes
.../image/2020031101.png" | Bin 0 -> 31442 bytes
.../image/2020031102.png" | Bin 0 -> 13105 bytes
.../image/2020031201.png" | Bin 0 -> 7724 bytes
8 files changed, 812 insertions(+)
create mode 100644 "docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211.md"
create mode 100644 "docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020010601.png"
create mode 100644 "docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020030901.png"
create mode 100644 "docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020031001.png"
create mode 100644 "docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020031002.png"
create mode 100644 "docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020031101.png"
create mode 100644 "docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020031102.png"
create mode 100644 "docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020031201.png"
diff --git "a/docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211.md" "b/docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211.md"
new file mode 100644
index 0000000..4f7fe3c
--- /dev/null
+++ "b/docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211.md"
@@ -0,0 +1,812 @@
+Spring官网阅读（十二）ApplicationContext详解（中）
+
+> 在上篇文章中我们已经对ApplicationContext的一部分内容做了介绍，ApplicationContext主要具有以下几个核心功能：
+>
+> 1. 国际化
+>
+> 2. 借助Environment接口，完成了对Spring运行环境的抽象，可以返回环境中的属性，并能出现出现的占位符
+> 3. 借助于Resource系列接口，完成对底层资源的访问及加载
+> 4. 继承了ApplicationEventPublisher接口，能够进行事件发布监听
+> 5. 负责创建、配置及管理Bean
+>
+> 在上篇文章我们已经分析学习了1，2两点，这篇文章我们继续之前的学习
+
+# 1、Spring的资源（Resource）
+
+首先需要说明的是，Spring并没有让ApplicationContext直接继承Resource接口，就像ApplicationContext接口也没有直接继承Environment接口一样。这应该也不难理解，采用这种组合的方式会让我们的类更加的轻量，也起到了解耦的作用。ApplicationContext跟Resource相关的接口的继承关系如下
+
+
+
+不管是ResourceLoader还是ResourcePatternResolver其实都是为了获取Resource对象，不过ResourcePatternResolver在ResourceLoader的基础上扩展了一个获取多个Resource的方法，我们在后文会介绍。
+
+## 接口简介
+
+Resouce接口继承了 InputStreamSource.
+
+```java
+public interface InputStreamSource {
+ // 每次调用都将返回一个当前资源对应的java.io. InputStream字节流
+ InputStream getInputStream() throws IOException;
+}
+```
+
+```java
+public interface Resource extends InputStreamSource {
+
+ // 用于判断对应的资源是否真的存在
+ boolean exists();
+
+ // 用于判断对应资源的内容是否可读。需要注意的是当其结果为true的时候，其内容未必真的可读，但如果返回false，则其内容必定不可读
+ default boolean isReadable() {
+ return exists();
+ }
+
+ // 用于判断当前资源是否代表一个已打开的输入流，如果结果为true，则表示当前资源的输入流不可多次读取，而且在读取以后需要对它进行关闭，以防止内存泄露。该方法主要针对于实现类InputStreamResource，实现类中只有它的返回结果为true，其他都为false。
+ default boolean isOpen() {
+ return false;
+ }
+
+ // 当前资源是否是一个文件
+ default boolean isFile() {
+ return false;
+ }
+
+ //当前资源对应的URL。如果当前资源不能解析为一个URL则会抛出异常
+ URL getURL() throws IOException;
+
+ //当前资源对应的URI。如果当前资源不能解析为一个URI则会抛出异常
+ URI getURI() throws IOException;
+
+ // 返回当前资源对应的File。如果当前资源不能以绝对路径解析为一个File则会抛出异常。
+ File getFile() throws IOException;
+
+ // 返回一个ReadableByteChannel
+ default ReadableByteChannel readableChannel() throws IOException {
+ return Channels.newChannel(getInputStream());
+ }
+
+ // 返回资源的长度
+ long contentLength() throws IOException;
+
+ // 最后修改时间
+ long lastModified() throws IOException;
+
+ // 根据当前资源以及相对当前资源的路径创建一个新的资源，比如当前Resource代表文件资源“d:/abc/a.java”,则createRelative（“xyz.txt”）将返回表文件资源“d:/abc/xyz.txt”
+ Resource createRelative(String relativePath) throws IOException;
+
+ // 返回文件一个文件名称，通常来说会返回该资源路径的最后一段
+ @Nullable
+ String getFilename();
+
+ // 返回描述信息
+ String getDescription();
+}
+```
+
+## UML类图
+
+
+
+因为实现了Resource接口的类很多，并且一些类我们也不常用到或者很简单，所以上图中省略了一些不重要的分支，接下来我们就一个个分析。
+
+### 抽象基类AbstractResource
+实现了Resource接口，是大多数Resource的实现类的基类，提供了很多通用的方法。
+比如exists方法会检查是否一个文件或者输入流能够被打开。isOpen永远返回false。”getURL()” 和”getFile()”方法会抛出异常。toString将会返回描述信息。
+
+### FileSystemResource
+
+基于java的文件系统封装而成的一个资源对象。
+
+### AbstractFileResolvingResource
+
+将URL解析成文件引用，既会处理协议为：“file“的URL，也会处理JBoss的”vfs“协议。然后相应的解析成对应的文件系统引用。
+
+### ByteArrayResource
+
+根据一个给定的字节数组构建的一个资源。同时给出一个对应的输入流
+
+### BeanDefinitionResource
+
+只是对BeanDefinition进行的一次描述性的封装
+
+### InputStreamResource
+
+是针对于输入流封装的资源，它的构建需要一个输入流。 对于“getInputStream ”操作将直接返回该字节流，因此只能读取一次该字节流，即“isOpen”永远返回true。
+
+### UrlResource
+
+UrlResource代表URL资源，用于简化URL资源访问。
+UrlResource一般支持如下资源访问：
+-http：通过标准的http协议访问web资源，如new UrlResource(“http://地址”)；
+-ftp：通过ftp协议访问资源，如new UrlResource(“ftp://地址”)；
+-file：通过file协议访问本地文件系统资源，如new UrlResource(“file:d:/test.txt”)；
+
+### ClassPathResource
+
+JDK获取资源有两种方式
+
+1. 使用Class对象的getResource(String path)获取资源URL，getResourceAsStream(String path)获取资源流。 参数既可以是当前class文件相对路径（以文件夹或文件开头），也可以是当前class文件的绝对路径（以“/”开头,相对于当前classpath根目录）
+2. 使用ClassLoader对象的getResource(String path)获取资源URL，getResourceAsStream(String path)获取资源流。参数只能是绝对路径，但不以“/”开头
+
+ClassPathResource代表classpath路径的资源，将使用给定的Class或ClassLoader进行加载classpath资源。 “isOpen”永远返回false，表示可多次读取资源。
+
+### ServletContextResource
+
+是针对于ServletContext封装的资源，用于访问ServletContext环境下的资源。ServletContextResource持有一个ServletContext的引用，其底层是通过ServletContext的getResource()方法和getResourceAsStream()方法来获取资源的。
+
+## ResourceLoader
+
+### 接口简介
+
+ResourceLoader接口被设计用来从指定的位置加载一个Resource,其接口定义如下
+
+```java
+public interface ResourceLoader {
+
+ // classpath:
+ String CLASSPATH_URL_PREFIX = ResourceUtils.CLASSPATH_URL_PREFIX;
+
+ // 核心方法，从指定位置加载一个Resource
+ // 1.支持权限的的URL格式，如：file:C:/test.dat
+ // 2.支持classpath的格式,如：classpath:test.dat
+ // 3.支持文件相对路径，如：WEB-INF/test.dat
+ Resource getResource(String location);
+
+ // 返回用于加载该资源的ClassLoader
+ @Nullable
+ ClassLoader getClassLoader();
+
+}
+
+```
+
+### UML类图
+
+
+
+对于一些不是很必要的类我都省略了，其实核心的类我们只需要关注`DefaultResourceLoader`就可以了，因为其余子类（除了`GenericApplicationContext`）都是直接继承了`DefaultResourceLoader`的`getResource`方法。代码如下：
+
+```java
+ @Override
+ public Resource getResource(String location) {
+ Assert.notNull(location, "Location must not be null");
+
+ // 正常来说protocolResolvers集合是空的，除非我们调用了它的addProtocolResolver方法添加了自定义协议处理器，调用addProtocolResolver方法所添加的协议处理器会覆盖原有的处理逻辑
+ for (ProtocolResolver protocolResolver : this.protocolResolvers) {
+ Resource resource = protocolResolver.resolve(location, this);
+ if (resource != null) {
+ return resource;
+ }
+ }
+
+ // 如果是以“/”开头，直接返回一个classpathResource
+ if (location.startsWith("/")) {
+ return getResourceByPath(location);
+ }
+ // 如果是形如：classpath:test.dat也直接返回一个ClassPathResource
+ else if (location.startsWith(CLASSPATH_URL_PREFIX)) {
+ return new ClassPathResource(location.substring(CLASSPATH_URL_PREFIX.length()), getClassLoader());
+ }
+ else {
+ try {
+ // 否则将其解析为一个URL
+ URL url = new URL(location);
+ // 如果是一个文件，直接返回一个FileUrlResource，否则返回一个普通的UrlResource
+ return (ResourceUtils.isFileURL(url) ? new FileUrlResource(url) : new UrlResource(url));
+ }
+ catch (MalformedURLException ex) {
+ // 如果URL转换失败，还是作为一个普通的ClassPathResource
+ return getResourceByPath(location);
+ }
+ }
+ }
+```
+
+### 资源路径
+
+#### ant-style
+
+类似下面这种含有通配符的路径
+
+```xml
+/WEB-INF/*-context.xml
+com/mycompany/**/applicationContext.xml
+file:C:/some/path/*-context.xml
+classpath:com/mycompany/**/applicationContext.xml
+```
+
+#### classpath跟classpath*
+
+classpath:用于加载类路径（包括jar包）中的一个且仅一个资源；
+
+classpath*:用于加载类路径（包括jar包）中的所有匹配的资源，可使用Ant路径模式。
+
+# 2、Spring中的事件监听机制（publish-event）
+
+我们知道，ApplicationContext接口继承了ApplicationEventPublisher接口，能够进行事件发布监听，那么什么是事件的发布跟监听呢？我们从监听者模式说起
+
+### 监听者模式
+
+#### 概念
+
+事件源经过事件的封装传给监听器，当事件源触发事件后，监听器接收到事件对象可以回调事件的方法
+
+
+
+#### Spring对监听者模式的实践
+
+我们直接通过一个例子来体会下
+
+```java
+public class Main {
+ public static void main(String[] args) {
+ // 创建一个事件发布器（事件源），为了方便，我这里直接通过传入EventListener.class来将监听器注册到容器中
+ ApplicationEventPublisher ac = new AnnotationConfigApplicationContext(EventListener.class);
+ // 发布一个事件
+ ac.publishEvent(new MyEvent("hello event"));
+ // 程序会打印如下：
+ // 接收到事件：hello event
+ // 处理事件....
+ }
+
+ static class MyEvent extends ApplicationEvent {
+ public MyEvent(Object source) {
+ super(source);
+ }
+ }
+
+ @Component
+ static class EventListener implements ApplicationListener {
+ @Override
+ public void onApplicationEvent(MyEvent event) {
+ System.out.println("接收到事件：" + event.getSource());
+ System.out.println("处理事件....");
+ }
+ }
+}
+```
+
+在上面的例子中，主要涉及到了三个角色，也就是我们之前提到的
+
+1. 事件源：ApplicationEventPublisher
+2. 事件：MyEvent，继承了ApplicationEvent
+3. 事件监听器：EventListener，实现了ApplicationListener
+
+我们通过ApplicationEventPublisher发布了一个事件（MyEvent），然后事件监听器监听到了事件，并进行了对应的处理。
+
+#### 接口简介
+
+##### ApplicationEventPublisher
+
+```java
+public interface ApplicationEventPublisher {
+
+ default void publishEvent(ApplicationEvent event) {
+ publishEvent((Object) event);
+ }
+
+ // 从版本4.2后新增的方法
+ // 调用这个方法发布的事件不需要实现ApplicationEvent接口，会被封装成一个PayloadApplicationEvent
+ // 如果event实现了ApplicationEvent接口，则会正常发布
+ void publishEvent(Object event);
+
+}
+```
+
+对于这个接口，我只需要关注有哪些子类是实现了`publishEvent(Object event)`这个方法即可。搜索发现，我们只需要关注`org.springframework.context.support.AbstractApplicationContext#publishEvent(java.lang.Object)`这个方法即可，关于这个方法在后文的源码分析中我们再详细介绍。
+
+##### ApplicationEvent
+
+继承关系如下：
+
+
+
+我们主要关注上面4个类（*PayloadApplicationEvent*在后文源码分析时再介绍），下面几个都是Spring直接在内部使用到了的事件，比如ContextClosedEvent，在容器关闭时会被创建然后发布。
+
+```java
+// 这个类在设计时是作为整个应用内所有事件的基类，之所以被设计成抽象类，是因为直接发布这个对象没有任何意义
+public abstract class ApplicationEvent extends EventObject {
+
+ // 事件创建的事件
+ private final long timestamp;
+
+ public ApplicationEvent(Object source) {
+ super(source);
+ this.timestamp = System.currentTimeMillis();
+ }
+
+ public final long getTimestamp() {
+ return this.timestamp;
+ }
+
+}
+
+// 这个类是java的util包下的一个类，java本身也具有一套事件机制
+public class EventObject implements java.io.Serializable {
+
+ // 事件所发生的那个源，比如在java中，我们发起了一个鼠标点击事件，那么这个source就是鼠标
+ protected transient Object source;
+
+ public EventObject(Object source) {
+ if (source == null)
+ throw new IllegalArgumentException("null source");
+ this.source = source;
+ }
+
+ public Object getSource() {
+ return source;
+ }
+
+ public String toString() {
+ return getClass().getName() + "[source=" + source + "]";
+ }
+}
+
+// 这个类是2.5版本时增加的一个类，相对于它直接的父类ApplicationEvent而言，最大的区别就是
+// 将source规定为了当前的容器。就目前而言的话这个类作用不大了，一般情况下我们定义事件也不一定需要继承这个ApplicationContextEvent
+// 后面我会介绍注解的方式进行事件的发布监听
+public abstract class ApplicationContextEvent extends ApplicationEvent {
+
+ public ApplicationContextEvent(ApplicationContext source) {
+ super(source);
+ }
+
+ public final ApplicationContext getApplicationContext() {
+ return (ApplicationContext) getSource();
+ }
+
+}
+
+```
+
+##### ApplicationListener
+
+```java
+// 事件监听器，实现了java.util包下的EventListener接口
+public interface ApplicationListener extends EventListener {
+
+ // 根据接口申明的泛型类型处理对应的事件
+ // 比如在我们之前的例子中，通过《EventListener implements ApplicationListener》
+ // 在接口中申明了泛型类型为MyEvent，所以能监听到MyEvent这一类事件
+ void onApplicationEvent(E event);
+
+}
+```
+
+#### 注解方式实现事件发布机制
+
+在上面的例子中，我们通过传统的方式实现了事件的发布监听，但是上面的过程实在是有点繁琐，我们发布的事件需要实现指定的接口，在进行监听时又需要实现指定的接口。每增加一个发布的事件，代表我们需要多两个类。这样在项目的迭代过程中，会导致我们关于事件的类越来越多。所以，在Spring4.2版本后，新增一个注解，让我们可以快速的实现对发布的事件的监听。示例代码如下：
+
+```java
+@ComponentScan("com.dmz.official.event")
+public class Main02 {
+ public static void main(String[] args) {
+ ApplicationEventPublisher publisher = new AnnotationConfigApplicationContext(Main02.class);
+ publisher.publishEvent(new Event("注解事件"));
+ // 程序打印：
+ // 接收到事件:注解事件
+ // 处理事件
+ }
+
+ static class Event {
+ String name;
+
+ Event(String name) {
+ this.name = name;
+ }
+
+ @Override
+ public String toString() {
+ return name;
+ }
+ }
+
+ @Component
+ static class Listener {
+ @EventListener
+ public void listen(Event event) {
+ System.out.println("接收到事件:" + event);
+ System.out.println("处理事件");
+ }
+ }
+}
+```
+
+可以看到在上面的例子中，我们使用一个`@EventListener`注解，直接标注了Listener类中的一个方法是一个事件监听器，并且通过方法的参数类型Event指定了这个监听器监听的事件类型为Event类型。在这个例子中，第一，我们事件不需要去继承特定的类，第二，我们的监听器也不需要去实现特定的接口，极大的方便了我们的开发。
+
+#### 异步的方式实现事件监听
+
+对于上面的例子，我们只需要按下面这种方式添加两个注解即可实现异步：
+
+```java
+@ComponentScan("com.dmz.official.event")
+@Configuration
+@EnableAsync // 1.开启异步支持
+public class Main02 {
+ public static void main(String[] args) {
+ AnnotationConfigApplicationContext publisher = new AnnotationConfigApplicationContext(Main02.class);
+ publisher.publishEvent(new Event("注解事件"));
+ }
+
+ static class Event {
+ String name;
+
+ Event(String name) {
+ this.name = name;
+ }
+
+ @Override
+ public String toString() {
+ return name;
+ }
+ }
+
+ @Component
+ static class Listener {
+ @EventListener
+ @Async
+ // 2.标志这个方法需要异步执行
+ public void listen(Event event) {
+ System.out.println("接收到事件:" + event);
+ System.out.println("处理事件");
+ }
+ }
+}
+```
+
+对于上面的两个注解`@EnableAsync `以及`@Async`，我会在AOP系列的文章中再做介绍，目前而言，大家知道能通过这种方式开启异步支持即可。
+
+#### 对监听器进行排序
+
+当我们发布一个事件时，可能会同时被两个监听器监听到，比如在我们上面的例子中如果同时存在两个监听器，如下：
+
+```java
+@Component
+static class Listener {
+ @EventListener
+ public void listen1(Event event) {
+ System.out.println("接收到事件1:" + event);
+ System.out.println("处理事件");
+ }
+
+ @EventListener
+ public void listen2(Event event) {
+ System.out.println("接收到事件2:" + event);
+ System.out.println("处理事件");
+ }
+}
+```
+
+在这种情况下，我们可能希望两个监听器可以按顺序执行，这个时候需要用到另外一个注解了:`@Order`
+
+还是上面的代码，我们添加注解如下：
+
+```java
+@Component
+static class Listener {
+ @EventListener
+ @Order(2)
+ public void listen1(Event event) {
+ System.out.println("接收到事件1:" + event);
+ System.out.println("处理事件");
+ }
+
+ @EventListener
+ @Order(1)
+ public void listen2(Event event) {
+ System.out.println("接收到事件2:" + event);
+ System.out.println("处理事件");
+ }
+}
+```
+
+注解中的参数越小，代表优先级越高，在上面的例子中，会执行listen2方法再执行listen1方法
+
+------
+
+那么Spring到底是如何实现的这一套事件发布机制呢？接下来我们进行源码分析
+
+#### 源码分析（publishEvent方法）
+
+我们需要分析的代码主要是`org.springframework.context.support.AbstractApplicationContext#publishEvent(java.lang.Object, org.springframework.core.ResolvableType)方法`，源码如下：
+
+```java
+protected void publishEvent(Object event, @Nullable ResolvableType eventType) {
+ Assert.notNull(event, "Event must not be null");
+
+ // 如果发布的事件是一个ApplicationEvent，直接发布
+ ApplicationEvent applicationEvent;
+ if (event instanceof ApplicationEvent) {
+ applicationEvent = (ApplicationEvent) event;
+ }
+ else {
+ // 如果发布的事件不是一个ApplicationEvent，包装成一个PayloadApplicationEvent
+ applicationEvent = new PayloadApplicationEvent<>(this, event);
+ // 我们在应用程序中发布事件时，这个eventType必定为null
+ if (eventType == null) {
+ // 获取对应的事件类型
+ eventType = ((PayloadApplicationEvent) applicationEvent).getResolvableType();
+ }
+ }
+ // 我们在自己的项目中调用时，这个earlyApplicationEvents必定为null
+ if (this.earlyApplicationEvents != null) {
+ this.earlyApplicationEvents.add(applicationEvent);
+ }
+ else {
+ // 获取事件发布器，发布对应的事件
+ getApplicationEventMulticaster().multicastEvent(applicationEvent, eventType);
+ }
+
+ // 父容器中也需要发布事件
+ if (this.parent != null) {
+ if (this.parent instanceof AbstractApplicationContext) {
+ ((AbstractApplicationContext) this.parent).publishEvent(event, eventType);
+ }
+ else {
+ this.parent.publishEvent(event);
+ }
+ }
+}
+```
+
+上面这段代码核心部分就是`getApplicationEventMulticaster().multicastEvent(applicationEvent, eventType);`，我们分成以下几个部分分析
+
+- getApplicationEventMulticaster()方法
+- multicastEvent()方法
+
+##### getApplicationEventMulticaster()方法
+
+代码如下：
+
+```java
+ApplicationEventMulticaster getApplicationEventMulticaster() throws IllegalStateException {
+ if (this.applicationEventMulticaster == null) {
+ throw new IllegalStateException("ApplicationEventMulticaster not initialized - " +
+ "call 'refresh' before multicasting events via the context: " + this);
+ }
+ return this.applicationEventMulticaster;
+}
+```
+
+可以看到，只是简单的获取容器中已经初始化好的一个`ApplicationEventMulticaster`，那么现在有以下几问题。
+
+###### 1、ApplicationEventMulticaster是什么？
+
+- 接口定义
+
+```java
+public interface ApplicationEventMulticaster {
+ // 添加事件监听器
+ void addApplicationListener(ApplicationListener listener);
+
+ // 通过名称添加事件监听器
+ void addApplicationListenerBean(String listenerBeanName);
+
+ // 移除事件监听器
+ void removeApplicationListener(ApplicationListener listener);
+
+ // 根据名称移除事件监听器
+ void removeApplicationListenerBean(String listenerBeanName);
+
+ // 移除注册在这个事件分发器上的所有监听器
+ void removeAllListeners();
+
+ // 分发事件
+ void multicastEvent(ApplicationEvent event);
+
+ // 分发事件，eventType代表事件类型，如果eventType为空，会从事件对象中推断出事件类型
+ void multicastEvent(ApplicationEvent event, @Nullable ResolvableType eventType);
+
+}
+```
+
+- UML类图
+
+
+
+
+
+主要涉及到两个类：
+
+1. `AbstractApplicationEventMulticaster`,这个类对`ApplicationEventMulticaster`这个接口基础方法做了实现，除了其核心方法`multicastEvent`。这个类最大的作用是获取监听器，稍后我们会介绍。
+2. `SimpleApplicationEventMulticaster`,这是Spring默认提供的一个事件分发器，如果我们没有进行特别的配置的话，就会采用这个类生成的对象作为容器的事件分发器。
+
+###### 2、容器在什么时候对其进行的初始化
+
+回到我们之前的一张图
+
+
+
+可以看到，在第`3-8`步调用了一个`initApplicationEventMulticaster`方法，从名字上我们就知道，这是对`ApplicationEventMulticaster`进行初始化的，我们看看这个方法做了什么。
+
+- initApplicationEventMulticaster方法
+
+```java
+protected void initApplicationEventMulticaster() {
+ ConfigurableListableBeanFactory beanFactory = getBeanFactory();
+ // 判断容器中是否包含了一个名为applicationEventMulticaster的ApplicationEventMulticaster类的对象，如果包含，直接获取即可。
+ if (beanFactory.containsLocalBean(APPLICATION_EVENT_MULTICASTER_BEAN_NAME)) {
+ this.applicationEventMulticaster =
+ beanFactory.getBean(APPLICATION_EVENT_MULTICASTER_BEAN_NAME, ApplicationEventMulticaster.class);
+ // 删除不必要的日志
+ }
+ // 如果没有包含，new一个SimpleApplicationEventMulticaster并将其注册到容器中
+ else {
+ this.applicationEventMulticaster = new SimpleApplicationEventMulticaster(beanFactory);
+ beanFactory.registerSingleton(APPLICATION_EVENT_MULTICASTER_BEAN_NAME, this.applicationEventMulticaster);
+ // 删除不必要的日志
+ }
+ }
+}
+```
+
+这段代码的含义就是告诉我们，可以自己配置一个applicationEventMulticaster，如果没有进行配置，那么将默认使用一个SimpleApplicationEventMulticaster。
+
+接下来，我们尝试自己配置一个简单的applicationEventMulticaster，示例代码如下：
+
+```java
+@Component("applicationEventMulticaster")
+static class MyEventMulticaster extends AbstractApplicationEventMulticaster {
+
+ @Override
+ @SuppressWarnings({"unchecked", "rawtypes"})
+ public void multicastEvent(@NonNull ApplicationEvent event) {
+ ResolvableType resolvableType = ResolvableType.forInstance(event);
+ Collection> applicationListeners = getApplicationListeners(event, resolvableType);
+ for (ApplicationListener applicationListener : applicationListeners) {
+ applicationListener.onApplicationEvent(event);
+ }
+ }
+
+ @Override
+ public void multicastEvent(ApplicationEvent event, ResolvableType eventType) {
+ System.out.println("进入MyEventMulticaster");
+ }
+}
+```
+
+运行程序后会发现“进入MyEventMulticaster”这句话打印了两次，这是一次是容器启动时会发布一个ContextStartedEvent事件，也会调用我们配置的事件分发器进行事件发布。
+
+##### multicastEvent方法
+
+在Spring容器中，只内置了一个这个方法的实现类，就是SimpleApplicationEventMulticaster。实现的逻辑如下：
+
+```java
+public void multicastEvent(ApplicationEvent event) {
+ multicastEvent(event, resolveDefaultEventType(event));
+}
+
+@Override
+public void multicastEvent(final ApplicationEvent event, @Nullable ResolvableType eventType) {
+ ResolvableType type = (eventType != null ? eventType : resolveDefaultEventType(event));
+ for (final ApplicationListener listener : getApplicationListeners(event, type)) {
+ Executor executor = getTaskExecutor();
+ if (executor != null) {
+ executor.execute(() -> invokeListener(listener, event));
+ }
+ else {
+ invokeListener(listener, event);
+ }
+ }
+}
+```
+
+上面的代码主要的实现逻辑可以分为这么几步：
+
+1. 推断事件类型
+2. 根据事件类型获取对应的监听器
+3. 执行监听逻辑
+
+我们一步步分析
+
+- resolveDefaultEventType(event)，推断事件类型
+
+```java
+
+private ResolvableType resolveDefaultEventType(ApplicationEvent event) {
+ return ResolvableType.forInstance(event);
+}
+
+public static ResolvableType forInstance(Object instance) {
+ Assert.notNull(instance, "Instance must not be null");
+ if (instance instanceof ResolvableTypeProvider) {
+ ResolvableType type = ((ResolvableTypeProvider) instance).getResolvableType();
+ if (type != null) {
+ return type;
+ }
+ }
+ // 返回通过事件的class类型封装的一个ResolvableType
+ return ResolvableType.forClass(instance.getClass());
+}
+```
+
+上面的代码涉及到一个概念就是ResolvableType，对于ResolvableType我们需要了解的是，ResolvableType为所有的java类型提供了统一的数据结构以及API，换句话说，一个ResolvableType对象就对应着一种java类型。我们可以通过ResolvableType对象获取类型携带的信息（举例如下）：
+
+1. getSuperType()：获取直接父类型
+2. getInterfaces()：获取接口类型
+3. getGeneric(int...)：获取类型携带的泛型类型
+4. resolve()：Type对象到Class对象的转换
+
+另外，ResolvableType的构造方法全部为私有的，我们不能直接new，只能使用其提供的静态方法进行类型获取：
+
+1. forField(Field)：获取指定字段的类型
+2. forMethodParameter(Method, int)：获取指定方法的指定形参的类型
+3. forMethodReturnType(Method)：获取指定方法的返回值的类型
+4. forClass(Class)：直接封装指定的类型
+5. ResolvableType.forInstance 获取指定的实例的泛型信息
+
+关于ResolvableType跟java中的类型中的关系请关注我的后续文章，限于篇幅原因在本文就不做过多介绍了。
+
+- getApplicationListeners(event, type)，获取对应的事件监听器
+
+事件监听器主要分为两种，一种是我们通过实现接口直接注册到容器中的Bean，例如下面这种
+
+```java
+@Component
+static class EventListener implements ApplicationListener {
+ @Override
+ public void onApplicationEvent(MyEvent event) {
+ System.out.println("接收到事件：" + event.getSource());
+ System.out.println("处理事件....");
+ }
+}
+```
+
+另外一个是通过注解的方式，就是下面这种
+
+```java
+@Component
+static class Listener {
+ @EventListener
+ public void listen1(Event event) {
+ System.out.println("接收到事件1:" + event);
+ System.out.println("处理事件");
+ }
+}
+```
+
+对于实现接口的方式不用多说，因为实现了这个类本身就会被扫描然后加入到容器中。对于注解这种方式，Spring是通过一个回调方法实现的。大家关注下这个接口`org.springframework.beans.factory.SmartInitializingSingleton`,同时找到其实现类，`org.springframework.context.event.EventListenerMethodProcessor`。在这个类中，会先调用`afterSingletonsInstantiated`方法，然后调用一个`processBean`方法，在这个方法中会遍历所有容器中的所有Bean，然后遍历Bean中的每一个方法判断方法上是否加了一个`@EventListener`注解。如果添加了这个注解，会将这个Method方法包装成一个`ApplicationListenerMethodAdapter`，这个类本身也实现了`ApplicationListener`接口。之后在添加到监听器的集合中。
+
+- invokeListener，执行监听逻辑
+
+本身这个方法没有什么好说的了，就是调用了`ApplicationListener`中的`onApplicationEvent`方法，执行我们的业务逻辑。但是值得注意的是，在调用invokeListener方法前，会先进行一个判断
+
+```java
+Executor executor = getTaskExecutor();
+if (executor != null) {
+ executor.execute(() -> invokeListener(listener, event));
+}
+else {
+ invokeListener(listener, event);
+}
+```
+
+会先判断是否能获取到一个Executor，如果能获取到那么会通过这个Executor异步执行监听的逻辑。所以基于这段代码，我们可以不通过@Async注解实现对事件的异步监听，而是复写`SimpleApplicationEventMulticaster`这个类中的方法，如下：
+
+```java
+@Component("applicationEventMulticaster")
+public class MyEventMulticaster extends SimpleApplicationEventMulticaster {
+ @Override
+ public Executor getTaskExecutor() {
+ // 在这里创建自己的执行器
+ return executor();
+ }
+}
+
+```
+
+相比于通过`@Async注解实现对事件的异步监听`我更加倾向于这种通过复写方法的方式进行实现，主要原因就是如果通过注解实现，那么所有加了这个注解的方法在异步执行都都是用的同一个线程池，这些加了注解的方法有些可能并不是进行事件监听的，这样显然是不合理的。而后面这种方式，我们可以确保创建的线程池是针对于事件监听的，甚至可以根据不同的事件类型路由到不同的线程池。这样更加合理。
+
+# 3、总结
+
+在这篇文章中，我们完成了对ApplicationContext中以下两点内容的学习
+
+1. 借助于Resource系列接口，完成对底层资源的访问及加载
+2. 实现事件的发布
+
+对于整个ApplicationContext体系，目前来说还剩一个很大的功能没有涉及到。因为我们也知道ApplicationContext也继承了一系列的BeanFactory接口。所以它还会负责创建、配置及管理Bean。
+
+BeanFactory本身也有一套自己的体系，在下篇文章中，我们就会学习BeanFactory相关的内容。虽然这一系列文章是以ApplicationContext命名的，但是其中的内容覆盖面很广，这些东西对于我们看懂Spring很重要。
+
+希望大家跟我一起慢慢啃掉Spring，加油！共勉！
+
diff --git "a/docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020010601.png" "b/docs/Spring/Spring\345\256\230\347\275\221\345\255\246\344\271\240\347\254\224\350\256\260/Spring\345\256\230\347\275\221\351\230\205\350\257\273\357\274\210\345\215\201\344\272\214\357\274\211ApplicationContext\350\257\246\350\247\243\357\274\210\344\270\255\357\274\211/image/2020010601.png"
new file mode 100644
index 0000000000000000000000000000000000000000..5ba9697a7839b16ef2357d4d2611a217d450aeb2
GIT binary patch
literal 857311
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