From d386a7971f93439c3ababa8d95bd80e7fb23d371 Mon Sep 17 00:00:00 2001
From: LIU
Date: Thu, 15 Oct 2020 11:02:11 +0800
Subject: [PATCH 1/7] fix markdown error
---
.../Java\345\237\272\347\241\200\347\237\245\350\257\206.md" | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git "a/docs/java/basis/Java\345\237\272\347\241\200\347\237\245\350\257\206.md" "b/docs/java/basis/Java\345\237\272\347\241\200\347\237\245\350\257\206.md"
index 7ff7d775f36..8004563d949 100644
--- "a/docs/java/basis/Java\345\237\272\347\241\200\347\237\245\350\257\206.md"
+++ "b/docs/java/basis/Java\345\237\272\347\241\200\347\237\245\350\257\206.md"
@@ -1350,7 +1350,7 @@ Java 线程在运行的生命周期中的指定时刻只可能处于下面 6 种

-当线程执行 `wait()`方法之后,线程进入 **WAITING(等待)**状态。进入等待状态的线程需要依靠其他线程的通知才能够返回到运行状态,而 **TIME_WAITING(超时等待)** 状态相当于在等待状态的基础上增加了超时限制,比如通过 `sleep(long millis)`方法或 `wait(long millis)`方法可以将 Java 线程置于 TIMED WAITING 状态。当超时时间到达后 Java 线程将会返回到 RUNNABLE 状态。当线程调用同步方法时,在没有获取到锁的情况下,线程将会进入到 **BLOCKED(阻塞)** 状态。线程在执行 Runnable 的`run()`方法之后将会进入到 **TERMINATED(终止)** 状态。
+当线程执行 `wait()`方法之后,线程进入 **WAITING(等待)** 状态。进入等待状态的线程需要依靠其他线程的通知才能够返回到运行状态,而 **TIME_WAITING(超时等待)** 状态相当于在等待状态的基础上增加了超时限制,比如通过 `sleep(long millis)`方法或 `wait(long millis)`方法可以将 Java 线程置于 TIMED WAITING 状态。当超时时间到达后 Java 线程将会返回到 RUNNABLE 状态。当线程调用同步方法时,在没有获取到锁的情况下,线程将会进入到 **BLOCKED(阻塞)** 状态。线程在执行 Runnable 的`run()`方法之后将会进入到 **TERMINATED(终止)** 状态。
### 3.4. 文件与 I\O 流
From e8c9c66ec56063b7e1f1f22140369163a2d958f9 Mon Sep 17 00:00:00 2001
From: LIU
Date: Thu, 15 Oct 2020 11:24:00 +0800
Subject: [PATCH 2/7] Fix URL and Content errors
FIx 3.1 and 3.4
---
...a\345\237\272\347\241\200\347\237\245\350\257\206.md" | 9 ++++++---
1 file changed, 6 insertions(+), 3 deletions(-)
diff --git "a/docs/java/basis/Java\345\237\272\347\241\200\347\237\245\350\257\206.md" "b/docs/java/basis/Java\345\237\272\347\241\200\347\237\245\350\257\206.md"
index 7ff7d775f36..706b8580918 100644
--- "a/docs/java/basis/Java\345\237\272\347\241\200\347\237\245\350\257\206.md"
+++ "b/docs/java/basis/Java\345\237\272\347\241\200\347\237\245\350\257\206.md"
@@ -69,8 +69,11 @@
- [2.5.5. Java 序列化中如果有些字段不想进行序列化,怎么办?](#255-java-序列化中如果有些字段不想进行序列化怎么办)
- [2.5.6. 获取用键盘输入常用的两种方法](#256-获取用键盘输入常用的两种方法)
- [3. Java 核心技术](#3-java-核心技术)
- - [3.1. 集合](#31-集合)
- - [3.1.1. Collections 工具类和 Arrays 工具类常见方法总结](#311-collections-工具类和-arrays-工具类常见方法总结)
+ - [3.1. 反射机制](#31-反射机制)
+ - [3.1.1. 静态编译和动态编译](#311静态编译和动态编译)
+ - [3.1.2. 反射机制优缺点](#312反射机制优缺点)
+ - [3.1.3. 反射的应用场景](#313反射的应用场景)
+
- [3.2. 异常](#32-异常)
- [3.2.1. Java 异常类层次结构图](#321-java-异常类层次结构图)
- [3.2.2. Throwable 类常用方法](#322-throwable-类常用方法)
@@ -79,7 +82,7 @@
- [3.3. 多线程](#33-多线程)
- [3.3.1. 简述线程、程序、进程的基本概念。以及他们之间关系是什么?](#331-简述线程程序进程的基本概念以及他们之间关系是什么)
- [3.3.2. 线程有哪些基本状态?](#332-线程有哪些基本状态)
- - [3.4. 文件与 I\O 流](#34-文件与-i\o-流)
+ - [3.4. 文件与 I\O 流](#34-文件与-io-流)
- [3.4.1. Java 中 IO 流分为几种?](#341-java-中-io-流分为几种)
- [3.4.1.1. 既然有了字节流,为什么还要有字符流?](#3411-既然有了字节流为什么还要有字符流)
- [3.4.1.2. BIO,NIO,AIO 有什么区别?](#3412-bionioaio-有什么区别)
From 4a86d3d80027b916753366e057c66c0fbe0f6aab Mon Sep 17 00:00:00 2001
From: guide
Date: Fri, 16 Oct 2020 09:33:09 +0800
Subject: [PATCH 3/7] [fix]url error
---
README.md | 2 +-
...\215\256\347\273\223\346\236\204\345\210\206\346\236\220.md" | 0
2 files changed, 1 insertion(+), 1 deletion(-)
rename "docs/java/collection/ConcurrentHashMap \346\272\220\347\240\201+\345\272\225\345\261\202\346\225\260\346\215\256\347\273\223\346\236\204\345\210\206\346\236\220.md" => "docs/java/collection/ConcurrentHashMap\346\272\220\347\240\201+\345\272\225\345\261\202\346\225\260\346\215\256\347\273\223\346\236\204\345\210\206\346\236\220.md" (100%)
diff --git a/README.md b/README.md
index 2dc98d0116a..1a5cda19e5f 100644
--- a/README.md
+++ b/README.md
@@ -65,7 +65,7 @@
### 容器
1. **[Java 容器常见面试题/知识点总结](docs/java/collection/Java集合框架常见面试题.md)(推荐!)**
-2. **源码分析** :[ArrayList源码+扩容机制分析](docs/java/collection/ArrayList源码+扩容机制分析.md) 、[LinkedList 源码](docs/java/collection/LinkedList源码分析.md) 、[HashMap(JDK1.8)源码+底层数据结构分析](docs/java/collection/HashMap(JDK1.8)源码+底层数据结构分析.md) 、[ConcurrentHashMap 源码+底层数据结构分析](docs/java/collection/ConcurrentHashMap 源码+底层数据结构分析.md)
+2. **源码分析** :[ArrayList源码+扩容机制分析](docs/java/collection/ArrayList源码+扩容机制分析.md) 、[LinkedList 源码](docs/java/collection/LinkedList源码分析.md) 、[HashMap(JDK1.8)源码+底层数据结构分析](docs/java/collection/HashMap(JDK1.8)源码+底层数据结构分析.md) 、[ConcurrentHashMap 源码+底层数据结构分析](docs/java/collection/ConcurrentHashMap源码+底层数据结构分析.md)
### 并发
diff --git "a/docs/java/collection/ConcurrentHashMap \346\272\220\347\240\201+\345\272\225\345\261\202\346\225\260\346\215\256\347\273\223\346\236\204\345\210\206\346\236\220.md" "b/docs/java/collection/ConcurrentHashMap\346\272\220\347\240\201+\345\272\225\345\261\202\346\225\260\346\215\256\347\273\223\346\236\204\345\210\206\346\236\220.md"
similarity index 100%
rename from "docs/java/collection/ConcurrentHashMap \346\272\220\347\240\201+\345\272\225\345\261\202\346\225\260\346\215\256\347\273\223\346\236\204\345\210\206\346\236\220.md"
rename to "docs/java/collection/ConcurrentHashMap\346\272\220\347\240\201+\345\272\225\345\261\202\346\225\260\346\215\256\347\273\223\346\236\204\345\210\206\346\236\220.md"
From d7510a9a73c024f90403e7f05afe4679515ee1c8 Mon Sep 17 00:00:00 2001
From: guide
Date: Fri, 16 Oct 2020 09:39:42 +0800
Subject: [PATCH 4/7] =?UTF-8?q?[fix]=E8=AE=A1=E7=AE=97=E6=9C=BA=E7=BD=91?=
=?UTF-8?q?=E7=BB=9C=E5=9B=BE=E7=89=87=E5=B1=85=E4=B8=AD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 2 +-
...47\237\245\350\257\206\346\200\273\347\273\223.md" | 11 ++++++-----
2 files changed, 7 insertions(+), 6 deletions(-)
rename "docs/network/\345\271\262\350\264\247\357\274\232\350\256\241\347\256\227\346\234\272\347\275\221\347\273\234\347\237\245\350\257\206\346\200\273\347\273\223.md" => "docs/network/\350\256\241\347\256\227\346\234\272\347\275\221\347\273\234\347\237\245\350\257\206\346\200\273\347\273\223.md" (99%)
diff --git a/README.md b/README.md
index 1a5cda19e5f..bd7b285f2d3 100644
--- a/README.md
+++ b/README.md
@@ -105,7 +105,7 @@
## 网络
1. [计算机网络常见面试题](docs/network/计算机网络.md)
-2. [计算机网络基础知识总结](docs/network/干货:计算机网络知识总结.md)
+2. [计算机网络基础知识总结](docs/network/计算机网络知识总结.md)
## 操作系统
diff --git "a/docs/network/\345\271\262\350\264\247\357\274\232\350\256\241\347\256\227\346\234\272\347\275\221\347\273\234\347\237\245\350\257\206\346\200\273\347\273\223.md" "b/docs/network/\350\256\241\347\256\227\346\234\272\347\275\221\347\273\234\347\237\245\350\257\206\346\200\273\347\273\223.md"
similarity index 99%
rename from "docs/network/\345\271\262\350\264\247\357\274\232\350\256\241\347\256\227\346\234\272\347\275\221\347\273\234\347\237\245\350\257\206\346\200\273\347\273\223.md"
rename to "docs/network/\350\256\241\347\256\227\346\234\272\347\275\221\347\273\234\347\237\245\350\257\206\346\200\273\347\273\223.md"
index c44b768aad5..9a4a15c4bb7 100644
--- "a/docs/network/\345\271\262\350\264\247\357\274\232\350\256\241\347\256\227\346\234\272\347\275\221\347\273\234\347\237\245\350\257\206\346\200\273\347\273\223.md"
+++ "b/docs/network/\350\256\241\347\256\227\346\234\272\347\275\221\347\273\234\347\237\245\350\257\206\346\200\273\347\273\223.md"
@@ -1,8 +1,8 @@
本文是我在大二学习计算机网络期间整理的, 大部分内容都来自于谢希仁老师的《计算机网络》这本书。
-
-
-
+
+

+
@@ -35,10 +35,11 @@
-
## 1. 计算机网络概述
-
+
+

+
### 1.1. 基本术语
From 89c3bccef2f23d852fc6e52ea0b73bc7c373f4bd Mon Sep 17 00:00:00 2001
From: guide
Date: Fri, 16 Oct 2020 11:02:00 +0800
Subject: [PATCH 5/7] [fix]url error
---
README.md | 2 +-
...\207\215\350\246\201\346\226\260\347\211\271\346\200\247.md" | 0
2 files changed, 1 insertion(+), 1 deletion(-)
rename "docs/java/new-features/\344\270\200\346\226\207\345\270\246\344\275\240\347\234\213\351\201\215JDK9~14 \347\232\204\351\207\215\350\246\201\346\226\260\347\211\271\346\200\247\357\274\201.md" => "docs/java/new-features/\344\270\200\346\226\207\345\270\246\344\275\240\347\234\213\351\201\215JDK9\345\210\26014\347\232\204\351\207\215\350\246\201\346\226\260\347\211\271\346\200\247.md" (100%)
diff --git a/README.md b/README.md
index bd7b285f2d3..8a42f115e64 100644
--- a/README.md
+++ b/README.md
@@ -100,7 +100,7 @@
### 新特性
1. **Java 8** :[Java 8 新特性总结](docs/java/new-features/Java8新特性总结.md)、[Java 8 学习资源推荐](docs/java/new-features/Java8教程推荐.md)、[Java8 forEach 指南](docs/java/new-features/Java8foreach指南.md)
-2. **Java9~Java14** : [一文带你看遍 JDK9~14 的重要新特性!](./docs/java/new-features/一文带你看遍JDK9~14 的重要新特性!.md)
+2. **Java9~Java14** : [一文带你看遍 JDK9~14 的重要新特性!](./docs/java/new-features/一文带你看遍JDK9到14的重要新特性.md)
## 网络
diff --git "a/docs/java/new-features/\344\270\200\346\226\207\345\270\246\344\275\240\347\234\213\351\201\215JDK9~14 \347\232\204\351\207\215\350\246\201\346\226\260\347\211\271\346\200\247\357\274\201.md" "b/docs/java/new-features/\344\270\200\346\226\207\345\270\246\344\275\240\347\234\213\351\201\215JDK9\345\210\26014\347\232\204\351\207\215\350\246\201\346\226\260\347\211\271\346\200\247.md"
similarity index 100%
rename from "docs/java/new-features/\344\270\200\346\226\207\345\270\246\344\275\240\347\234\213\351\201\215JDK9~14 \347\232\204\351\207\215\350\246\201\346\226\260\347\211\271\346\200\247\357\274\201.md"
rename to "docs/java/new-features/\344\270\200\346\226\207\345\270\246\344\275\240\347\234\213\351\201\215JDK9\345\210\26014\347\232\204\351\207\215\350\246\201\346\226\260\347\211\271\346\200\247.md"
From f80a2dd60a38d38d61128ba72ca7ffa18b1f78ea Mon Sep 17 00:00:00 2001
From: guide
Date: Fri, 16 Oct 2020 12:16:42 +0800
Subject: [PATCH 6/7] =?UTF-8?q?[refractor]=E5=88=A0=E9=99=A4Sring=E9=83=A8?=
=?UTF-8?q?=E5=88=86=E6=96=87=E7=AB=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 13 +-
...00\346\230\216\346\225\231\347\250\213.md" | 0
.../framework/spring/SpringBean.md | 451 ------------------
...50\350\247\243\346\200\273\347\273\223.md" | 2 +-
.../framework/spring/SpringMVC-Principle.md | 269 -----------
.../spring-annotations/@RequestBody.png | Bin 0 -> 35987 bytes
...76\350\256\241\346\250\241\345\274\217.md" | 84 ----
7 files changed, 6 insertions(+), 813 deletions(-)
rename docs/system-design/restful-api.md => "docs/system-design/coding-way/RESTfulAPI\347\256\200\346\230\216\346\225\231\347\250\213.md" (100%)
delete mode 100644 docs/system-design/framework/spring/SpringBean.md
rename docs/system-design/framework/spring/spring-annotations.md => "docs/system-design/framework/spring/SpringBoot+Spring\345\270\270\347\224\250\346\263\250\350\247\243\346\200\273\347\273\223.md" (99%)
delete mode 100644 docs/system-design/framework/spring/SpringMVC-Principle.md
create mode 100644 docs/system-design/framework/spring/images/spring-annotations/@RequestBody.png
delete mode 100644 "docs/system-design/\350\256\276\350\256\241\346\250\241\345\274\217.md"
diff --git a/README.md b/README.md
index 8a42f115e64..ae9d585f421 100644
--- a/README.md
+++ b/README.md
@@ -45,7 +45,7 @@
-## Java
+## Java(必看:+1: )
### 基础
@@ -156,12 +156,11 @@
## 系统设计
-### 编码规范
+### 编码之道(必看 :+1:)
-1. [RestFul API 简明教程](docs/system-design/restful-api.md)
+1. [RestFul API 简明教程](docs/system-design/coding-way/RESTfulAPI简明教程.md)
2. [Java 编程规范以及优雅 Java 代码实践总结](docs/java/Java编程规范.md)
3. [Java 命名之道](docs/system-design/naming.md)
-4. [设计模式系列文章](docs/system-design/设计模式.md)
### 常用框架
@@ -176,11 +175,9 @@
**重要知识点详解:**
-1. **[Spring/Spring 常用注解总结!安排!](./docs/system-design/framework/spring/spring-annotations.md)**
-2. **[Spring 事务总结](docs/system-design/framework/spring/spring-transaction.md)**
+1. **[Spring/Spring 常用注解总结!安排!](./docs/system-design/framework/spring/SpringBoot+Spring常用注解总结.md)** (必看 :+1:)
+2. **[Spring 事务总结](docs/system-design/framework/spring/spring-transaction.md)** (必看 :+1:)
3. [Spring 中都用到了那些设计模式?](docs/system-design/framework/spring/Spring-Design-Patterns.md)
-4. [Spring 中 Bean 的作用域与生命周期](docs/system-design/framework/spring/SpringBean.md)
-5. [SpringMVC 工作原理详解](docs/system-design/framework/spring/SpringMVC-Principle.md)
#### MyBatis
diff --git a/docs/system-design/restful-api.md "b/docs/system-design/coding-way/RESTfulAPI\347\256\200\346\230\216\346\225\231\347\250\213.md"
similarity index 100%
rename from docs/system-design/restful-api.md
rename to "docs/system-design/coding-way/RESTfulAPI\347\256\200\346\230\216\346\225\231\347\250\213.md"
diff --git a/docs/system-design/framework/spring/SpringBean.md b/docs/system-design/framework/spring/SpringBean.md
deleted file mode 100644
index 3291e7fa34b..00000000000
--- a/docs/system-design/framework/spring/SpringBean.md
+++ /dev/null
@@ -1,451 +0,0 @@
-
-
-- [前言](#前言)
-- [一 bean的作用域](#一-bean的作用域)
- - [1. singleton——唯一 bean 实例](#1-singleton——唯一-bean-实例)
- - [2. prototype——每次请求都会创建一个新的 bean 实例](#2-prototype——每次请求都会创建一个新的-bean-实例)
- - [3. request——每一次HTTP请求都会产生一个新的bean,该bean仅在当前HTTP request内有效](#3-request——每一次http请求都会产生一个新的bean,该bean仅在当前http-request内有效)
- - [4. session——每一次HTTP请求都会产生一个新的 bean,该bean仅在当前 HTTP session 内有效](#4-session——每一次http请求都会产生一个新的-bean,该bean仅在当前-http-session-内有效)
- - [5. globalSession](#5-globalsession)
-- [二 bean的生命周期](#二-bean的生命周期)
- - [initialization 和 destroy](#initialization-和-destroy)
- - [实现*Aware接口 在Bean中使用Spring框架的一些对象](#实现aware接口-在bean中使用spring框架的一些对象)
- - [BeanPostProcessor](#beanpostprocessor)
- - [总结](#总结)
- - [单例管理的对象](#单例管理的对象)
- - [非单例管理的对象](#非单例管理的对象)
-- [三 说明](#三-说明)
-
-
-
-# 前言
-在 Spring 中,那些组成应用程序的主体及由 Spring IOC 容器所管理的对象,被称之为 bean。简单地讲,bean 就是由 IOC 容器初始化、装配及管理的对象,除此之外,bean 就与应用程序中的其他对象没有什么区别了。而 bean 的定义以及 bean 相互间的依赖关系将通过配置元数据来描述。
-
-**Spring中的bean默认都是单例的,这些单例Bean在多线程程序下如何保证线程安全呢?** 例如对于Web应用来说,Web容器对于每个用户请求都创建一个单独的Sevlet线程来处理请求,引入Spring框架之后,每个Action都是单例的,那么对于Spring托管的单例Service Bean,如何保证其安全呢? **Spring的单例是基于BeanFactory也就是Spring容器的,单例Bean在此容器内只有一个,Java的单例是基于 JVM,每个 JVM 内只有一个实例。**
-
-在大多数情况下。单例 bean 是很理想的方案。不过,有时候你可能会发现你所使用的类是易变的,它们会保持一些状态,因此重用是不安全的。在这种情况下,将 class 声明为单例的就不是那么明智了。因为对象会被污染,稍后重用的时候会出现意想不到的问题。所以 Spring 定义了多种作用域的bean。
-
-# 一 bean的作用域
-
-创建一个bean定义,其实质是用该bean定义对应的类来创建真正实例的“配方”。把bean定义看成一个配方很有意义,它与class很类似,只根据一张“处方”就可以创建多个实例。不仅可以控制注入到对象中的各种依赖和配置值,还可以控制该对象的作用域。这样可以灵活选择所建对象的作用域,而不必在Java Class级定义作用域。Spring Framework支持五种作用域,分别阐述如下表。
-
-
-
-
-五种作用域中,**request、session** 和 **global session** 三种作用域仅在基于web的应用中使用(不必关心你所采用的是什么web应用框架),只能用在基于 web 的 Spring ApplicationContext 环境。
-
-
-
-### 1. singleton——唯一 bean 实例
-
-**当一个 bean 的作用域为 singleton,那么Spring IoC容器中只会存在一个共享的 bean 实例,并且所有对 bean 的请求,只要 id 与该 bean 定义相匹配,则只会返回bean的同一实例。** singleton 是单例类型(对应于单例模式),就是在创建起容器时就同时自动创建了一个bean的对象,不管你是否使用,但我们可以指定Bean节点的 `lazy-init=”true”` 来延迟初始化bean,这时候,只有在第一次获取bean时才会初始化bean,即第一次请求该bean时才初始化。 每次获取到的对象都是同一个对象。注意,singleton 作用域是Spring中的缺省作用域。要在XML中将 bean 定义成 singleton ,可以这样配置:
-
-```xml
-
-```
-
-也可以通过 `@Scope` 注解(它可以显示指定bean的作用范围。)的方式
-
-```java
-@Service
-@Scope("singleton")
-public class ServiceImpl{
-
-}
-```
-
-### 2. prototype——每次请求都会创建一个新的 bean 实例
-
-**当一个bean的作用域为 prototype,表示一个 bean 定义对应多个对象实例。** **prototype 作用域的 bean 会导致在每次对该 bean 请求**(将其注入到另一个 bean 中,或者以程序的方式调用容器的 getBean() 方法**)时都会创建一个新的 bean 实例。prototype 是原型类型,它在我们创建容器的时候并没有实例化,而是当我们获取bean的时候才会去创建一个对象,而且我们每次获取到的对象都不是同一个对象。根据经验,对有状态的 bean 应该使用 prototype 作用域,而对无状态的 bean 则应该使用 singleton 作用域。** 在 XML 中将 bean 定义成 prototype ,可以这样配置:
-
-```java
-
- 或者
-
-```
-通过 `@Scope` 注解的方式实现就不做演示了。
-
-### 3. request——每一次HTTP请求都会产生一个新的bean,该bean仅在当前HTTP request内有效
-
-**request只适用于Web程序,每一次 HTTP 请求都会产生一个新的bean,同时该bean仅在当前HTTP request内有效,当请求结束后,该对象的生命周期即告结束。** 在 XML 中将 bean 定义成 request ,可以这样配置:
-
-```java
-
-```
-
-### 4. session——每一次HTTP请求都会产生一个新的 bean,该bean仅在当前 HTTP session 内有效
-
-**session只适用于Web程序,session 作用域表示该针对每一次 HTTP 请求都会产生一个新的 bean,同时该 bean 仅在当前 HTTP session 内有效.与request作用域一样,可以根据需要放心的更改所创建实例的内部状态,而别的 HTTP session 中根据 userPreferences 创建的实例,将不会看到这些特定于某个 HTTP session 的状态变化。当HTTP session最终被废弃的时候,在该HTTP session作用域内的bean也会被废弃掉。**
-
-```xml
-
-```
-
-### 5. globalSession
-
-global session 作用域类似于标准的 HTTP session 作用域,不过仅仅在基于 portlet 的 web 应用中才有意义。Portlet 规范定义了全局 Session 的概念,它被所有构成某个 portlet web 应用的各种不同的 portle t所共享。在global session 作用域中定义的 bean 被限定于全局portlet Session的生命周期范围内。
-
-```xml
-
-```
-
-# 二 bean的生命周期
-
-Spring Bean是Spring应用中最最重要的部分了。所以来看看Spring容器在初始化一个bean的时候会做那些事情,顺序是怎样的,在容器关闭的时候,又会做哪些事情。
-
-> spring版本:4.2.3.RELEASE
-鉴于Spring源码是用gradle构建的,我也决定舍弃我大maven,尝试下洪菊推荐过的gradle。运行beanLifeCycle模块下的junit test即可在控制台看到如下输出,可以清楚了解Spring容器在创建,初始化和销毁Bean的时候依次做了那些事情。
-
-```
-Spring容器初始化
-=====================================
-调用GiraffeService无参构造函数
-GiraffeService中利用set方法设置属性值
-调用setBeanName:: Bean Name defined in context=giraffeService
-调用setBeanClassLoader,ClassLoader Name = sun.misc.Launcher$AppClassLoader
-调用setBeanFactory,setBeanFactory:: giraffe bean singleton=true
-调用setEnvironment
-调用setResourceLoader:: Resource File Name=spring-beans.xml
-调用setApplicationEventPublisher
-调用setApplicationContext:: Bean Definition Names=[giraffeService, org.springframework.context.annotation.CommonAnnotationBeanPostProcessor#0, com.giraffe.spring.service.GiraffeServicePostProcessor#0]
-执行BeanPostProcessor的postProcessBeforeInitialization方法,beanName=giraffeService
-调用PostConstruct注解标注的方法
-执行InitializingBean接口的afterPropertiesSet方法
-执行配置的init-method
-执行BeanPostProcessor的postProcessAfterInitialization方法,beanName=giraffeService
-Spring容器初始化完毕
-=====================================
-从容器中获取Bean
-giraffe Name=李光洙
-=====================================
-调用preDestroy注解标注的方法
-执行DisposableBean接口的destroy方法
-执行配置的destroy-method
-Spring容器关闭
-```
-
-先来看看,Spring在Bean从创建到销毁的生命周期中可能做得事情。
-
-
-### initialization 和 destroy
-
-有时我们需要在Bean属性值set好之后和Bean销毁之前做一些事情,比如检查Bean中某个属性是否被正常的设置好值了。Spring框架提供了多种方法让我们可以在Spring Bean的生命周期中执行initialization和pre-destroy方法。
-
-**1.实现InitializingBean和DisposableBean接口**
-
-这两个接口都只包含一个方法。通过实现InitializingBean接口的afterPropertiesSet()方法可以在Bean属性值设置好之后做一些操作,实现DisposableBean接口的destroy()方法可以在销毁Bean之前做一些操作。
-
-例子如下:
-
-```java
-public class GiraffeService implements InitializingBean,DisposableBean {
- @Override
- public void afterPropertiesSet() throws Exception {
- System.out.println("执行InitializingBean接口的afterPropertiesSet方法");
- }
- @Override
- public void destroy() throws Exception {
- System.out.println("执行DisposableBean接口的destroy方法");
- }
-}
-```
-这种方法比较简单,但是不建议使用。因为这样会将Bean的实现和Spring框架耦合在一起。
-
-**2.在bean的配置文件中指定init-method和destroy-method方法**
-
-Spring允许我们创建自己的 init 方法和 destroy 方法,只要在 Bean 的配置文件中指定 init-method 和 destroy-method 的值就可以在 Bean 初始化时和销毁之前执行一些操作。
-
-例子如下:
-
-```java
-public class GiraffeService {
- //通过的destroy-method属性指定的销毁方法
- public void destroyMethod() throws Exception {
- System.out.println("执行配置的destroy-method");
- }
- //通过的init-method属性指定的初始化方法
- public void initMethod() throws Exception {
- System.out.println("执行配置的init-method");
- }
-}
-```
-
-配置文件中的配置:
-
-```
-
-
-```
-
-需要注意的是自定义的init-method和destroy-method方法可以抛异常但是不能有参数。
-
-这种方式比较推荐,因为可以自己创建方法,无需将Bean的实现直接依赖于spring的框架。
-
-**3.使用@PostConstruct和@PreDestroy注解**
-
-除了xml配置的方式,Spring 也支持用 `@PostConstruct`和 `@PreDestroy`注解来指定 `init` 和 `destroy` 方法。这两个注解均在`javax.annotation` 包中。为了注解可以生效,需要在配置文件中定义org.springframework.context.annotation.CommonAnnotationBeanPostProcessor或context:annotation-config
-
-例子如下:
-
-```java
-public class GiraffeService {
- @PostConstruct
- public void initPostConstruct(){
- System.out.println("执行PostConstruct注解标注的方法");
- }
- @PreDestroy
- public void preDestroy(){
- System.out.println("执行preDestroy注解标注的方法");
- }
-}
-```
-
-配置文件:
-
-```xml
-
-
-
-```
-
-### 实现*Aware接口 在Bean中使用Spring框架的一些对象
-
-有些时候我们需要在 Bean 的初始化中使用 Spring 框架自身的一些对象来执行一些操作,比如获取 ServletContext 的一些参数,获取 ApplicaitionContext 中的 BeanDefinition 的名字,获取 Bean 在容器中的名字等等。为了让 Bean 可以获取到框架自身的一些对象,Spring 提供了一组名为*Aware的接口。
-
-这些接口均继承于`org.springframework.beans.factory.Aware`标记接口,并提供一个将由 Bean 实现的set*方法,Spring通过基于setter的依赖注入方式使相应的对象可以被Bean使用。
-网上说,这些接口是利用观察者模式实现的,类似于servlet listeners,目前还不明白,不过这也不在本文的讨论范围内。
-介绍一些重要的Aware接口:
-
-- **ApplicationContextAware**: 获得ApplicationContext对象,可以用来获取所有Bean definition的名字。
-- **BeanFactoryAware**:获得BeanFactory对象,可以用来检测Bean的作用域。
-- **BeanNameAware**:获得Bean在配置文件中定义的名字。
-- **ResourceLoaderAware**:获得ResourceLoader对象,可以获得classpath中某个文件。
-- **ServletContextAware**:在一个MVC应用中可以获取ServletContext对象,可以读取context中的参数。
-- **ServletConfigAware**: 在一个MVC应用中可以获取ServletConfig对象,可以读取config中的参数。
-
-```java
-public class GiraffeService implements ApplicationContextAware,
- ApplicationEventPublisherAware, BeanClassLoaderAware, BeanFactoryAware,
- BeanNameAware, EnvironmentAware, ImportAware, ResourceLoaderAware{
- @Override
- public void setBeanClassLoader(ClassLoader classLoader) {
- System.out.println("执行setBeanClassLoader,ClassLoader Name = " + classLoader.getClass().getName());
- }
- @Override
- public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
- System.out.println("执行setBeanFactory,setBeanFactory:: giraffe bean singleton=" + beanFactory.isSingleton("giraffeService"));
- }
- @Override
- public void setBeanName(String s) {
- System.out.println("执行setBeanName:: Bean Name defined in context="
- + s);
- }
- @Override
- public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
- System.out.println("执行setApplicationContext:: Bean Definition Names="
- + Arrays.toString(applicationContext.getBeanDefinitionNames()));
- }
- @Override
- public void setApplicationEventPublisher(ApplicationEventPublisher applicationEventPublisher) {
- System.out.println("执行setApplicationEventPublisher");
- }
- @Override
- public void setEnvironment(Environment environment) {
- System.out.println("执行setEnvironment");
- }
- @Override
- public void setResourceLoader(ResourceLoader resourceLoader) {
- Resource resource = resourceLoader.getResource("classpath:spring-beans.xml");
- System.out.println("执行setResourceLoader:: Resource File Name="
- + resource.getFilename());
- }
- @Override
- public void setImportMetadata(AnnotationMetadata annotationMetadata) {
- System.out.println("执行setImportMetadata");
- }
-}
-```
-
-### BeanPostProcessor
-
-上面的*Aware接口是针对某个实现这些接口的Bean定制初始化的过程,
-Spring同样可以针对容器中的所有Bean,或者某些Bean定制初始化过程,只需提供一个实现BeanPostProcessor接口的类即可。 该接口中包含两个方法,postProcessBeforeInitialization和postProcessAfterInitialization。 postProcessBeforeInitialization方法会在容器中的Bean初始化之前执行, postProcessAfterInitialization方法在容器中的Bean初始化之后执行。
-
-例子如下:
-
-```java
-public class CustomerBeanPostProcessor implements BeanPostProcessor {
- @Override
- public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
- System.out.println("执行BeanPostProcessor的postProcessBeforeInitialization方法,beanName=" + beanName);
- return bean;
- }
- @Override
- public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
- System.out.println("执行BeanPostProcessor的postProcessAfterInitialization方法,beanName=" + beanName);
- return bean;
- }
-}
-```
-
-要将BeanPostProcessor的Bean像其他Bean一样定义在配置文件中
-
-```xml
-
-```
-
-### 总结
-
-所以。。。结合第一节控制台输出的内容,Spring Bean的生命周期是这样纸的:
-
-- Bean容器找到配置文件中 Spring Bean 的定义。
-- Bean容器利用Java Reflection API创建一个Bean的实例。
-- 如果涉及到一些属性值 利用set方法设置一些属性值。
-- 如果Bean实现了BeanNameAware接口,调用setBeanName()方法,传入Bean的名字。
-- 如果Bean实现了BeanClassLoaderAware接口,调用setBeanClassLoader()方法,传入ClassLoader对象的实例。
-- 如果Bean实现了BeanFactoryAware接口,调用setBeanFactory()方法,传入BeanFactory对象的实例。
-- 与上面的类似,如果实现了其他*Aware接口,就调用相应的方法。
-- 如果有和加载这个Bean的Spring容器相关的BeanPostProcessor对象,执行postProcessBeforeInitialization()方法
-- 如果Bean实现了InitializingBean接口,执行afterPropertiesSet()方法。
-- 如果Bean在配置文件中的定义包含init-method属性,执行指定的方法。
-- 如果有和加载这个Bean的Spring容器相关的BeanPostProcessor对象,执行postProcessAfterInitialization()方法
-- 当要销毁Bean的时候,如果Bean实现了DisposableBean接口,执行destroy()方法。
-- 当要销毁Bean的时候,如果Bean在配置文件中的定义包含destroy-method属性,执行指定的方法。
-
-用图表示一下(图来源:http://www.jianshu.com/p/d00539babca5):
-
-
-
-与之比较类似的中文版本:
-
-
-
-
-**其实很多时候我们并不会真的去实现上面说描述的那些接口,那么下面我们就除去那些接口,针对bean的单例和非单例来描述下bean的生命周期:**
-
-### 单例管理的对象
-
-当scope=”singleton”,即默认情况下,会在启动容器时(即实例化容器时)时实例化。但我们可以指定Bean节点的lazy-init=”true”来延迟初始化bean,这时候,只有在第一次获取bean时才会初始化bean,即第一次请求该bean时才初始化。如下配置:
-
-```xml
-
-```
-
-如果想对所有的默认单例bean都应用延迟初始化,可以在根节点beans设置default-lazy-init属性为true,如下所示:
-
-```xml
-
-```
-
-默认情况下,Spring 在读取 xml 文件的时候,就会创建对象。在创建对象的时候先调用构造器,然后调用 init-method 属性值中所指定的方法。对象在被销毁的时候,会调用 destroy-method 属性值中所指定的方法(例如调用Container.destroy()方法的时候)。写一个测试类,代码如下:
-
-```java
-public class LifeBean {
- private String name;
-
- public LifeBean(){
- System.out.println("LifeBean()构造函数");
- }
- public String getName() {
- return name;
- }
-
- public void setName(String name) {
- System.out.println("setName()");
- this.name = name;
- }
-
- public void init(){
- System.out.println("this is init of lifeBean");
- }
-
- public void destory(){
- System.out.println("this is destory of lifeBean " + this);
- }
-}
-```
- life.xml配置如下:
-
-```xml
-
-```
-
-测试代码:
-
-```java
-public class LifeTest {
- @Test
- public void test() {
- AbstractApplicationContext container =
- new ClassPathXmlApplicationContext("life.xml");
- LifeBean life1 = (LifeBean)container.getBean("life");
- System.out.println(life1);
- container.close();
- }
-}
-```
-
-运行结果:
-
-```
-LifeBean()构造函数
-this is init of lifeBean
-com.bean.LifeBean@573f2bb1
-……
-this is destory of lifeBean com.bean.LifeBean@573f2bb1
-```
-
-### 非单例管理的对象
-
-当`scope=”prototype”`时,容器也会延迟初始化 bean,Spring 读取xml 文件的时候,并不会立刻创建对象,而是在第一次请求该 bean 时才初始化(如调用getBean方法时)。在第一次请求每一个 prototype 的bean 时,Spring容器都会调用其构造器创建这个对象,然后调用`init-method`属性值中所指定的方法。对象销毁的时候,Spring 容器不会帮我们调用任何方法,因为是非单例,这个类型的对象有很多个,Spring容器一旦把这个对象交给你之后,就不再管理这个对象了。
-
-为了测试prototype bean的生命周期life.xml配置如下:
-
-```xml
-
-```
-
-测试程序:
-
-```java
-public class LifeTest {
- @Test
- public void test() {
- AbstractApplicationContext container = new ClassPathXmlApplicationContext("life.xml");
- LifeBean life1 = (LifeBean)container.getBean("life_singleton");
- System.out.println(life1);
-
- LifeBean life3 = (LifeBean)container.getBean("life_prototype");
- System.out.println(life3);
- container.close();
- }
-}
-```
-
-运行结果:
-
-```
-LifeBean()构造函数
-this is init of lifeBean
-com.bean.LifeBean@573f2bb1
-LifeBean()构造函数
-this is init of lifeBean
-com.bean.LifeBean@5ae9a829
-……
-this is destory of lifeBean com.bean.LifeBean@573f2bb1
-```
-
-可以发现,对于作用域为 prototype 的 bean ,其`destroy`方法并没有被调用。**如果 bean 的 scope 设为prototype时,当容器关闭时,`destroy` 方法不会被调用。对于 prototype 作用域的 bean,有一点非常重要,那就是 Spring不能对一个 prototype bean 的整个生命周期负责:容器在初始化、配置、装饰或者是装配完一个prototype实例后,将它交给客户端,随后就对该prototype实例不闻不问了。** 不管何种作用域,容器都会调用所有对象的初始化生命周期回调方法。但对prototype而言,任何配置好的析构生命周期回调方法都将不会被调用。**清除prototype作用域的对象并释放任何prototype bean所持有的昂贵资源,都是客户端代码的职责**(让Spring容器释放被prototype作用域bean占用资源的一种可行方式是,通过使用bean的后置处理器,该处理器持有要被清除的bean的引用)。谈及prototype作用域的bean时,在某些方面你可以将Spring容器的角色看作是Java new操作的替代者,任何迟于该时间点的生命周期事宜都得交由客户端来处理。
-
-**Spring 容器可以管理 singleton 作用域下 bean 的生命周期,在此作用域下,Spring 能够精确地知道bean何时被创建,何时初始化完成,以及何时被销毁。而对于 prototype 作用域的bean,Spring只负责创建,当容器创建了 bean 的实例后,bean 的实例就交给了客户端的代码管理,Spring容器将不再跟踪其生命周期,并且不会管理那些被配置成prototype作用域的bean的生命周期。**
-
-
-# 三 说明
-
-本文的完成结合了下面两篇文章,并做了相应修改:
-
-- https://blog.csdn.net/fuzhongmin05/article/details/73389779
-- https://yemengying.com/2016/07/14/spring-bean-life-cycle/
-
-由于本文非本人独立原创,所以未声明为原创!在此说明!
diff --git a/docs/system-design/framework/spring/spring-annotations.md "b/docs/system-design/framework/spring/SpringBoot+Spring\345\270\270\347\224\250\346\263\250\350\247\243\346\200\273\347\273\223.md"
similarity index 99%
rename from docs/system-design/framework/spring/spring-annotations.md
rename to "docs/system-design/framework/spring/SpringBoot+Spring\345\270\270\347\224\250\346\263\250\350\247\243\346\200\273\347\273\223.md"
index 610c0908d69..0cdfb26073f 100644
--- a/docs/system-design/framework/spring/spring-annotations.md
+++ "b/docs/system-design/framework/spring/SpringBoot+Spring\345\270\270\347\224\250\346\263\250\350\247\243\346\200\273\347\273\223.md"
@@ -315,7 +315,7 @@ public class UserRegisterRequest {
这样我们的后端就可以直接把 json 格式的数据映射到我们的 `UserRegisterRequest` 类上。
-
+
👉 需要注意的是:**一个请求方法只可以有一个`@RequestBody`,但是可以有多个`@RequestParam`和`@PathVariable`**。 如果你的方法必须要用两个 `@RequestBody`来接受数据的话,大概率是你的数据库设计或者系统设计出问题了!
diff --git a/docs/system-design/framework/spring/SpringMVC-Principle.md b/docs/system-design/framework/spring/SpringMVC-Principle.md
deleted file mode 100644
index 0a2cc5f4232..00000000000
--- a/docs/system-design/framework/spring/SpringMVC-Principle.md
+++ /dev/null
@@ -1,269 +0,0 @@
-> 本文整理自网络,原文出处暂不知,对原文做了较大的改动,在此说明!
-
-### 先来看一下什么是 MVC 模式
-
-MVC 是一种设计模式.
-
-**MVC 的原理图如下:**
-
-
-
-
-
-### SpringMVC 简单介绍
-
-SpringMVC 框架是以请求为驱动,围绕 Servlet 设计,将请求发给控制器,然后通过模型对象,分派器来展示请求结果视图。其中核心类是 DispatcherServlet,它是一个 Servlet,顶层是实现的Servlet接口。
-
-### SpringMVC 使用
-
-需要在 web.xml 中配置 DispatcherServlet 。并且需要配置 Spring 监听器ContextLoaderListener
-
-```xml
-
-
- org.springframework.web.context.ContextLoaderListener
-
-
-
- springmvc
- org.springframework.web.servlet.DispatcherServlet
-
-
-
- contextConfigLocation
- classpath:spring/springmvc-servlet.xml
-
- 1
-
-
- springmvc
- /
-
-
-```
-
-### SpringMVC 工作原理(重要)
-
-**简单来说:**
-
-客户端发送请求-> 前端控制器 DispatcherServlet 接受客户端请求 -> 找到处理器映射 HandlerMapping 解析请求对应的 Handler-> HandlerAdapter 会根据 Handler 来调用真正的处理器来处理请求,并处理相应的业务逻辑 -> 处理器返回一个模型视图 ModelAndView -> 视图解析器进行解析 -> 返回一个视图对象->前端控制器 DispatcherServlet 渲染数据(Model)->将得到视图对象返回给用户
-
-
-
-**如下图所示:**
-
-
-上图的一个笔误的小问题:Spring MVC 的入口函数也就是前端控制器 DispatcherServlet 的作用是接收请求,响应结果。
-
-**流程说明(重要):**
-
-(1)客户端(浏览器)发送请求,直接请求到 DispatcherServlet。
-
-(2)DispatcherServlet 根据请求信息调用 HandlerMapping,解析请求对应的 Handler。
-
-(3)解析到对应的 Handler(也就是我们平常说的 Controller 控制器)后,开始由 HandlerAdapter 适配器处理。
-
-(4)HandlerAdapter 会根据 Handler 来调用真正的处理器开处理请求,并处理相应的业务逻辑。
-
-(5)处理器处理完业务后,会返回一个 ModelAndView 对象,Model 是返回的数据对象,View 是个逻辑上的 View。
-
-(6)ViewResolver 会根据逻辑 View 查找实际的 View。
-
-(7)DispaterServlet 把返回的 Model 传给 View(视图渲染)。
-
-(8)把 View 返回给请求者(浏览器)
-
-
-
-### SpringMVC 重要组件说明
-
-
-**1、前端控制器DispatcherServlet(不需要工程师开发),由框架提供(重要)**
-
-作用:**Spring MVC 的入口函数。接收请求,响应结果,相当于转发器,中央处理器。有了 DispatcherServlet 减少了其它组件之间的耦合度。用户请求到达前端控制器,它就相当于mvc模式中的c,DispatcherServlet是整个流程控制的中心,由它调用其它组件处理用户的请求,DispatcherServlet的存在降低了组件之间的耦合性。**
-
-**2、处理器映射器HandlerMapping(不需要工程师开发),由框架提供**
-
-作用:根据请求的url查找Handler。HandlerMapping负责根据用户请求找到Handler即处理器(Controller),SpringMVC提供了不同的映射器实现不同的映射方式,例如:配置文件方式,实现接口方式,注解方式等。
-
-**3、处理器适配器HandlerAdapter**
-
-作用:按照特定规则(HandlerAdapter要求的规则)去执行Handler
-通过HandlerAdapter对处理器进行执行,这是适配器模式的应用,通过扩展适配器可以对更多类型的处理器进行执行。
-
-**4、处理器Handler(需要工程师开发)**
-
-注意:编写Handler时按照HandlerAdapter的要求去做,这样适配器才可以去正确执行Handler
-Handler 是继DispatcherServlet前端控制器的后端控制器,在DispatcherServlet的控制下Handler对具体的用户请求进行处理。
-由于Handler涉及到具体的用户业务请求,所以一般情况需要工程师根据业务需求开发Handler。
-
-**5、视图解析器View resolver(不需要工程师开发),由框架提供**
-
-作用:进行视图解析,根据逻辑视图名解析成真正的视图(view)
-View Resolver负责将处理结果生成View视图,View Resolver首先根据逻辑视图名解析成物理视图名即具体的页面地址,再生成View视图对象,最后对View进行渲染将处理结果通过页面展示给用户。 springmvc框架提供了很多的View视图类型,包括:jstlView、freemarkerView、pdfView等。
-一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户,需要由工程师根据业务需求开发具体的页面。
-
-**6、视图View(需要工程师开发)**
-
-View是一个接口,实现类支持不同的View类型(jsp、freemarker、pdf...)
-
-**注意:处理器Handler(也就是我们平常说的Controller控制器)以及视图层view都是需要我们自己手动开发的。其他的一些组件比如:前端控制器DispatcherServlet、处理器映射器HandlerMapping、处理器适配器HandlerAdapter等等都是框架提供给我们的,不需要自己手动开发。**
-
-### DispatcherServlet详细解析
-
-首先看下源码:
-
-```java
-package org.springframework.web.servlet;
-
-@SuppressWarnings("serial")
-public class DispatcherServlet extends FrameworkServlet {
-
- public static final String MULTIPART_RESOLVER_BEAN_NAME = "multipartResolver";
- public static final String LOCALE_RESOLVER_BEAN_NAME = "localeResolver";
- public static final String THEME_RESOLVER_BEAN_NAME = "themeResolver";
- public static final String HANDLER_MAPPING_BEAN_NAME = "handlerMapping";
- public static final String HANDLER_ADAPTER_BEAN_NAME = "handlerAdapter";
- public static final String HANDLER_EXCEPTION_RESOLVER_BEAN_NAME = "handlerExceptionResolver";
- public static final String REQUEST_TO_VIEW_NAME_TRANSLATOR_BEAN_NAME = "viewNameTranslator";
- public static final String VIEW_RESOLVER_BEAN_NAME = "viewResolver";
- public static final String FLASH_MAP_MANAGER_BEAN_NAME = "flashMapManager";
- public static final String WEB_APPLICATION_CONTEXT_ATTRIBUTE = DispatcherServlet.class.getName() + ".CONTEXT";
- public static final String LOCALE_RESOLVER_ATTRIBUTE = DispatcherServlet.class.getName() + ".LOCALE_RESOLVER";
- public static final String THEME_RESOLVER_ATTRIBUTE = DispatcherServlet.class.getName() + ".THEME_RESOLVER";
- public static final String THEME_SOURCE_ATTRIBUTE = DispatcherServlet.class.getName() + ".THEME_SOURCE";
- public static final String INPUT_FLASH_MAP_ATTRIBUTE = DispatcherServlet.class.getName() + ".INPUT_FLASH_MAP";
- public static final String OUTPUT_FLASH_MAP_ATTRIBUTE = DispatcherServlet.class.getName() + ".OUTPUT_FLASH_MAP";
- public static final String FLASH_MAP_MANAGER_ATTRIBUTE = DispatcherServlet.class.getName() + ".FLASH_MAP_MANAGER";
- public static final String EXCEPTION_ATTRIBUTE = DispatcherServlet.class.getName() + ".EXCEPTION";
- public static final String PAGE_NOT_FOUND_LOG_CATEGORY = "org.springframework.web.servlet.PageNotFound";
- private static final String DEFAULT_STRATEGIES_PATH = "DispatcherServlet.properties";
- protected static final Log pageNotFoundLogger = LogFactory.getLog(PAGE_NOT_FOUND_LOG_CATEGORY);
- private static final Properties defaultStrategies;
- static {
- try {
- ClassPathResource resource = new ClassPathResource(DEFAULT_STRATEGIES_PATH, DispatcherServlet.class);
- defaultStrategies = PropertiesLoaderUtils.loadProperties(resource);
- }
- catch (IOException ex) {
- throw new IllegalStateException("Could not load 'DispatcherServlet.properties': " + ex.getMessage());
- }
- }
-
- /** Detect all HandlerMappings or just expect "handlerMapping" bean? */
- private boolean detectAllHandlerMappings = true;
-
- /** Detect all HandlerAdapters or just expect "handlerAdapter" bean? */
- private boolean detectAllHandlerAdapters = true;
-
- /** Detect all HandlerExceptionResolvers or just expect "handlerExceptionResolver" bean? */
- private boolean detectAllHandlerExceptionResolvers = true;
-
- /** Detect all ViewResolvers or just expect "viewResolver" bean? */
- private boolean detectAllViewResolvers = true;
-
- /** Throw a NoHandlerFoundException if no Handler was found to process this request? **/
- private boolean throwExceptionIfNoHandlerFound = false;
-
- /** Perform cleanup of request attributes after include request? */
- private boolean cleanupAfterInclude = true;
-
- /** MultipartResolver used by this servlet */
- private MultipartResolver multipartResolver;
-
- /** LocaleResolver used by this servlet */
- private LocaleResolver localeResolver;
-
- /** ThemeResolver used by this servlet */
- private ThemeResolver themeResolver;
-
- /** List of HandlerMappings used by this servlet */
- private List handlerMappings;
-
- /** List of HandlerAdapters used by this servlet */
- private List handlerAdapters;
-
- /** List of HandlerExceptionResolvers used by this servlet */
- private List handlerExceptionResolvers;
-
- /** RequestToViewNameTranslator used by this servlet */
- private RequestToViewNameTranslator viewNameTranslator;
-
- private FlashMapManager flashMapManager;
-
- /** List of ViewResolvers used by this servlet */
- private List viewResolvers;
-
- public DispatcherServlet() {
- super();
- }
-
- public DispatcherServlet(WebApplicationContext webApplicationContext) {
- super(webApplicationContext);
- }
- @Override
- protected void onRefresh(ApplicationContext context) {
- initStrategies(context);
- }
-
- protected void initStrategies(ApplicationContext context) {
- initMultipartResolver(context);
- initLocaleResolver(context);
- initThemeResolver(context);
- initHandlerMappings(context);
- initHandlerAdapters(context);
- initHandlerExceptionResolvers(context);
- initRequestToViewNameTranslator(context);
- initViewResolvers(context);
- initFlashMapManager(context);
- }
-}
-
-```
-
-DispatcherServlet类中的属性beans:
-
-- HandlerMapping:用于handlers映射请求和一系列的对于拦截器的前处理和后处理,大部分用@Controller注解。
-- HandlerAdapter:帮助DispatcherServlet处理映射请求处理程序的适配器,而不用考虑实际调用的是 哪个处理程序。- - -
-- ViewResolver:根据实际配置解析实际的View类型。
-- ThemeResolver:解决Web应用程序可以使用的主题,例如提供个性化布局。
-- MultipartResolver:解析多部分请求,以支持从HTML表单上传文件。-
-- FlashMapManager:存储并检索可用于将一个请求属性传递到另一个请求的input和output的FlashMap,通常用于重定向。
-
-在Web MVC框架中,每个DispatcherServlet都拥自己的WebApplicationContext,它继承了ApplicationContext。WebApplicationContext包含了其上下文和Servlet实例之间共享的所有的基础框架beans。
-
-**HandlerMapping**
-
-
-
-HandlerMapping接口处理请求的映射HandlerMapping接口的实现类:
-
-- SimpleUrlHandlerMapping类通过配置文件把URL映射到Controller类。
-- DefaultAnnotationHandlerMapping类通过注解把URL映射到Controller类。
-
-**HandlerAdapter**
-
-
-
-
-HandlerAdapter接口-处理请求映射
-
-AnnotationMethodHandlerAdapter:通过注解,把请求URL映射到Controller类的方法上。
-
-**HandlerExceptionResolver**
-
-
-
-
-HandlerExceptionResolver接口-异常处理接口
-
-- SimpleMappingExceptionResolver通过配置文件进行异常处理。
-- AnnotationMethodHandlerExceptionResolver:通过注解进行异常处理。
-
-**ViewResolver**
-
-
-
-ViewResolver接口解析View视图。
-
-UrlBasedViewResolver类 通过配置文件,把一个视图名交给到一个View来处理。
diff --git a/docs/system-design/framework/spring/images/spring-annotations/@RequestBody.png b/docs/system-design/framework/spring/images/spring-annotations/@RequestBody.png
new file mode 100644
index 0000000000000000000000000000000000000000..75d43a72be24c0810483881d268cedec27cfe926
GIT binary patch
literal 35987
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 |