From ca6a9aa890ae57b5242c52ea35ea194b3eb330e7 Mon Sep 17 00:00:00 2001
From: many2many <6168830@qq.com>
Date: Wed, 7 Aug 2024 01:40:55 +0800
Subject: [PATCH] add c5

---
 docs/chapter05.md                      | 494 +++++++++++++++++++++++++
 docs/index.md                          |  66 ++--
 docs/resources/exception-hierarchy.png | Bin 0 -> 28712 bytes
 3 files changed, 525 insertions(+), 35 deletions(-)
 create mode 100644 docs/chapter05.md
 create mode 100644 docs/resources/exception-hierarchy.png

diff --git a/docs/chapter05.md b/docs/chapter05.md
new file mode 100644
index 0000000..e43cf69
--- /dev/null
+++ b/docs/chapter05.md
@@ -0,0 +1,494 @@
+
+## 5. 基于Spring框架的后端应用开发
+
+### 5.1 Java基础增强(掌握)
+
+#### 5.1.1 Java异常处理
+- **定义**: 异常是在程序执行过程中发生的问题或意外情况。
+- **java异常处理结构**:
+
+![](./resources/exception-hierarchy.png)
+
+> Throwable类是Java所有错误和异常的父类。
+
+> 非检查异常类
+>> Error 和 RuntimeException 以及他们的子类
+>
+>> 通俗得理解就是：这些异常，和自己写的代码逻辑有很大关系，这类异常在编译得时候一般能通过，在程序运行过程中会抛出这些异常 如IndexOutOfBoundsException NullPointerException
+
+> 检查异常类
+>> 除了Error 和 RuntimeException以及他们的子类外的其它异常类
+>
+>> 可查异常虽然是异常状况，但在一定程度上它的发生是可以预计的，而且一旦发生这种异常状况，就必须采取某种方式进行处理。
+这种异常的特点是Java编译器会检查它，也就是说，当程序中可能出现这类异常，要么用try-catch语句捕获它，要么用throws子句声明抛出它，否则编译不会通过。
+
+- **java异常使用**:
+
+关键词： try、catch、finally、throw、throws
+
+try-catch-finally: 将可能要出现异常的代码放入try中，catch 捕获 try 中的异常，并处理,不管有没有异常，finally中的代码都会执行。(finally不是必须)
+
+throw: 一般是语句抛出一个异常
+
+throws:一般是方法抛出一个异常
+
+- **自定义异常类**
+
+一般自定义异常会继承Exception或RuntimeException类。
+但具体继承哪一个类呢 还是要视情况而定，若继承受检查的异常,会与方法耦合，若不抛异常就要try-catch，操作不够灵活;
+若继承RuntimeException 就相对上面的就简洁多了。
+
+#### 5.1.2 注解(了解)
+
+参考[java注解是怎么实现的?](https://www.zhihu.com/question/24401191)
+
+- **定义**:
+> java注解又叫做java标注，是java的一种注释机制，在jdk5.0引入。其可以作用在类、方法、变量、参数和包上。注解是用于向编译器或框架提供元数据的一种机制。
+- **注解定义的语法**
+```java
+public @interface 注解名称{
+   属性列表;
+}
+```
+- **类型**:
+    - **元注解**: 用于修饰其他注解。
+    - **内置注解**: 如`@Override`, `@Deprecated`, `@SuppressWarnings`等。
+    - **自定义注解**: 自定义注解就是我们自己写的注解，来满足特定需求。
+    - **第三方框架定义的注解**: 比如SpringMVC的@Controller等,也可归于自定义注解。
+- **使用场景**:
+    - **元数据**: 为框架提供元数据。
+    - **代码生成**: 用于生成代码。
+    - **编译时处理**: 用于编译时的代码处理。
+
+- **使用位置**
+
+实际开发中，注解常常出现在类、方法、成员变量、形参位置。当然还有其他位置。
+
+- **作用**
+
+如果说注释是写给人看的，那么注解就是写给程序看的。它更像一个标签，贴在一个类、一个方法或者字段上。它的目的是为当前读取该注解的程序提供判断依据及少量附加信息。比如程序只要读到加了@Test的方法，就知道该方法是待测试方法，又比如@Before注解，程序看到这个注解，就知道该方法要放在@Test方法之前执行。有时我们还可以通过注解属性，为将来读取这个注解的程序提供必要的附加信息，比如@RequestMapping("/user/info")提供了Controller某个接口的URL路径。
+
+- **级别**
+
+注解和类、接口、枚举是同一级别的。注解的本质@interface和interface从名字上看非常相似。
+
+- **注解三角**
+
+要牢记，只要用到注解，必然有三角关系：
+- 定义注解
+- 使用注解
+- 读取注解
+
+
+**小结**
+
+- 注解就像标签，是程序判断执行的依据。比如，程序读到@Test就知道这个方法是待测试方法，而@Before的方法要在测试方法之前执行
+- 注解需要三要素：定义、使用、读取并执行
+- 注解分为自定义注解、JDK内置注解和第三方注解（框架）。自定义注解一般要我们自己定义、使用、并写程序读取，而JDK内置注解和第三方注解我们只要使用，定义和读取都交给它们
+- 大多数情况下，三角关系中我们只负责使用注解，无需定义和执行，框架会将注解类和读取注解的程序隐藏起来，除非阅读源码，否则根本看不到。平时见不到定义和读取的过程，光顾着使用注解，久而久之很多人就忘了注解如何起作用了！
+
+#### 5.1.3 Optional的介绍和使用(了解)
+- **定义**: `Optional`是Java 8引入的一个容器类，用于避免null值。
+- **用途**:
+    - **封装可能为null的对象**: 避免空指针异常。
+    - **提供链式操作**: 支持方法链式调用。
+- **示例**:
+  ```java
+  Optional<String> optional = Optional.ofNullable("Hello, World!");
+  optional.ifPresent(System.out::println);
+  ```
+
+#### 5.1.4 Stream API的介绍和使用(了解)
+- **定义**: Stream API是Java 8引入的新特性，用于处理集合数据。
+- **用途**:
+    - **数据流处理**: 提供了一种声明式的处理集合数据的方式。
+    - **并行处理**: 支持并行流处理。
+- **示例**:
+
+```java
+  List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);
+  int sum = numbers.stream().filter(n -> n % 2 == 0).mapToInt(Integer::intValue).sum();
+  System.out.println(sum); // 输出 6
+```
+
+
+#### 5.1.5 泛型(了解)
+
+##### 什么是泛型？
+Java 中的泛型是一种通用的编程技术，它可以让我们在写代码时更加灵活、安全和高效。
+
+泛型是为了解决Java中类型安全的问题而被引入的。在早期版本的Java中，所有的集合类都是基于Object类型实现的，这意味着我们可以将任意类型的对象添加到集合中，但是取出时需要进行类型转换，如果转换错误就会抛出ClassCastException异常。当我们使用泛型时，可以在编译期间检查类型，从而避免这类异常的发生。
+##### 泛型的优点
+- 类型安全性：通过泛型可以在编译时检查类型，避免了运行时出现类型转换异常等问题。
+- 代码重用性：通过泛型可以编写通用的代码，提高代码的可重用性和可维护性。
+- 性能优化：通过泛型可以避免了不必要的类型转换，提高程序的运行效率。
+
+##### 泛型的语法
+
+泛型主要包括三个部分：泛型类、泛型接口和泛型方法。
+
+###### 泛型类和泛型接口
+泛型类和泛型接口是最常见的泛型形式。我们可以通过在类或接口名后面添加一对尖括号来声明一个或多个类型参数。
+
+```java
+public class MyClass<T> {
+    // ...
+}
+
+public interface MyInterface<K, V> {
+    // ...
+}
+```
+
+当我们使用泛型类或泛型接口时，我们可以使用具体的类型来替换类型参数。
+```java
+MyClass<String> myClass = new MyClass<>();
+MyInterface<Integer, String> myInterface = new MyInterface<>();
+```
+###### 泛型方法
+除了类和接口之外，我们还可以定义泛型方法，它们在方法返回类型前面加上一对尖括号，表示该方法有一个或多个类型参数。
+```java
+public class MyUtils {
+    public static <T> T getLast(List<T> list) {
+        return list.get(list.size() - 1);
+    }
+}
+
+```
+
+当我们使用泛型方法时，我们可以在方法调用时，为类型参数传入具体的类型。
+```java
+List<String> names = List.of("Alice", "Bob", "Charlie");
+String last = MyUtils.<String>getLast(names);
+
+```
+
+##### 泛型的应用
+
+泛型是一种非常通用的编程技术，我们可以用它来编写各种各样的通用数据结构和工具类。
+
+###### List 和 Map
+
+Java 内置的 List 和 Map 类型都支持泛型，它们可以用来存储任意类型的对象。
+```java
+List<Integer> numbers = new ArrayList<>();
+numbers.add(1);
+numbers.add(2);
+numbers.add(3);
+
+Map<String, Integer> scoreMap = new HashMap<>();
+scoreMap.put("Alice", 90);
+scoreMap.put("Bob", 80);
+scoreMap.put("Charlie", 70);
+```
+
+### 5.2 Spring框架简介(了解)
+
+#### 5.2.1 Spring框架的历史和发展
+- **起源**: Spring framework最初由Rod Johnson在2003年开始编写，并于2004年发布了第一个版本1.0。
+- **目标**: 创立Spring framework的主要目的是解决企业级Java应用中的复杂问题，特别是解决依赖管理和面向切面编程（AOP）的问题。
+- **版本演进**:
+    - **1.x**: 初期版本主要关注于依赖注入和面向切面编程。
+    - **2.x**: 添加了对Web应用程序的支持，包括Spring MVC框架。
+    - **3.x**: 引入了对Java 5特性的支持，如注解和泛型，并且增强了对RESTful Web服务的支持。
+    - **4.x**: 增强了对Java 8的支持，包括Lambda表达式和Stream API。
+    - **5.x**: 重点改进了对反应式编程模型的支持，引入了Spring WebFlux框架。
+- **最新版本**: 截至2024年，Spring框架的最新版本为5.x系列，持续增加了对现代Web开发趋势的支持，如微服务架构、云原生应用等。
+
+#### 5.2.2 Spring框架的核心特性
+- **依赖注入 (DI)**:
+    - **定义**: 是一种设计模式，用于实现对象之间的解耦，让对象不需要直接创建依赖对象，而是由容器负责创建并注入。
+    - **好处**: 降低了组件之间的耦合度，提高了代码的可测试性和可维护性。
+- **面向切面编程 (AOP)**:
+    - **定义**: 一种编程范式，用于将横切关注点（如日志记录、事务管理）从业务逻辑中分离出来。
+    - **好处**: 通过切面编程，可以在不修改业务逻辑代码的情况下添加或修改功能。
+- **模块化**: Spring框架被设计成高度模块化的，用户可以根据需要选择使用不同的模块。
+- **可扩展性**: Spring框架提供了许多扩展点，允许开发者根据需要自定义行为。
+- **广泛的应用场景**: 从简单的Web应用到复杂的企业级应用，Spring都能提供解决方案。
+
+#### 5.2.3 Spring的家族框架
+- **Spring Boot**: 提供了一个快速搭建Spring应用的方式，通过自动化配置、依赖管理和启动器简化了开发过程。
+- **Spring Cloud**: 用于构建分布式系统和服务网格，提供了一系列工具和服务，如服务注册与发现、配置中心、熔断器等。
+- **Spring Data**: 提供了一套数据访问抽象层，简化了数据访问层的开发工作，支持各种数据库技术。
+- **Spring Security**: 为Spring应用提供了全面的安全保护，包括认证、授权等功能。
+- **Spring Integration**: 提供了基于消息驱动的企业集成模式的支持，适用于构建复杂的集成系统。
+- **Spring Batch**: 用于批量处理任务，支持大规模数据处理作业。
+- **Spring WebFlux**: 用于构建非阻塞的、事件驱动的Web应用和服务器端应用，支持反应式编程模型。
+- **Spring Web**: 提供了构建Web应用程序所需的支持，包括HTTP消息处理、多部分文件上传等功能，以及与Spring MVC的紧密集成。
+
+#### 5.2.4 Spring的应用场景和优势
+- **应用场景**:
+    - **Web应用**: Spring MVC框架为构建高性能的Web应用提供了基础。
+    - **企业级应用**: Spring框架适合构建复杂的企业级应用，包括业务流程管理、数据处理等。
+    - **微服务**: Spring Boot和Spring Cloud为构建微服务架构提供了便利。
+    - **移动应用后端**: Spring框架可以作为移动应用后端的服务端框架。
+- **优势**:
+    - **松耦合**: 通过依赖注入实现了组件之间的松耦合。
+    - **易于测试**: Spring框架的设计使得单元测试变得简单。
+    - **广泛的社区支持**: 拥有庞大的开发者社区和丰富的文档资源。
+    - **丰富的生态**: Spring框架有一整套家族产品，几乎覆盖了企业级应用的所有方面。
+    - **灵活性**: Spring框架非常灵活，可以很容易地与其他技术栈集成。
+    - **性能**: Spring框架经过优化，能够高效地运行大规模应用。
+    - **社区活跃**: Spring框架有一个活跃的社区，不断更新以适应新的技术和标准。
+
+#### 5.2.5 Spring Web
+- **概述**: Spring Web 是 Spring Framework 的一部分，它为构建Web应用程序提供了必要的支持。Spring Web 包含了多个子模块，旨在提供一套完整的Web开发解决方案。
+- **子模块**:
+    - **Spring Web**: 为Web开发提供了一些基本的支持，比如HTTP消息转换、多部分文件上传、Web应用上下文等。
+    - **Spring Web MVC**: 一个基于Model-View-Controller (MVC) 模式的Web框架，用于构建动态Web应用程序。
+    - **Spring Web Flows**: 一个用于构建复杂的Web应用程序的工作流框架。
+    - **Spring WebSocket**: 提供了WebSocket的支持，用于实现全双工通信。
+    - **Spring Web Services**: 提供了构建和消费Web服务的支持。
+- **关键特性**:
+    - **HTTP Message Converters**: 提供了HTTP消息转换器，用于序列化和反序列化HTTP请求和响应。
+    - **MultiPart File Upload**: 支持多部分文件上传功能。
+    - **Web Application Context**: 提供了Web应用程序上下文的支持，包括初始化监听器等。
+    - **MVC Framework**: Spring MVC 提供了一个基于MVC模式的Web框架，用于构建动态Web应用程序。
+    - **File Upload Support**: 支持多部分文件上传，用于处理文件上传请求。
+    - **Web Services Support**: 支持构建和消费Web服务，包括SOAP和RESTful服务。
+    - **WebSocket Support**: 提供了WebSocket的支持，用于实现实时双向通信。
+
+### 5.3 Spring IoC(掌握)
+
+#### 5.3.1 Spring Bean的定义和生命周期
+- **定义**: Spring Bean是Spring容器管理的对象。
+- **生命周期**:
+    - **初始化**: 包括默认初始化、自定义初始化等。
+    - **销毁**: 包括默认销毁、自定义销毁等。
+- **示例**:
+  ```java
+  @Component
+  public class MyBean {
+      public MyBean() {
+          System.out.println("MyBean created.");
+      }
+      
+      @PostConstruct
+      public void init() {
+          System.out.println("MyBean initialized.");
+      }
+      
+      @PreDestroy
+      public void destroy() {
+          System.out.println("MyBean destroyed.");
+      }
+  }
+  ```
+
+#### 5.3.2 XML和注解方式的Bean配置
+- **XML配置**:
+    - **定义Bean**: `<bean>`元素定义一个Bean。
+    - **依赖注入**: 使用`<property>`元素注入依赖。
+- **注解配置**:
+    - **组件扫描**: 使用`@ComponentScan`注解来自动发现和配置组件。
+    - **依赖注入**: 使用`@Autowired`、`@Qualifier`等注解来注入依赖。
+- **示例**:
+  ```java
+  @Service
+  public class MyService {
+      private final MyRepository repository;
+      
+      @Autowired
+      public MyService(MyRepository repository) {
+          this.repository = repository;
+      }
+      
+      public void doSomething() {
+          // 使用repository
+      }
+  }
+  ```
+
+#### 5.3.3 Bean的作用域和装配方式
+- **作用域**:
+    - **Singleton**: 单例模式，每个Spring容器中只有一个实例。
+    - **Prototype**: 原型模式，每次请求都会创建一个新的实例。
+    - **Request**: 每次HTTP请求都会创建一个新的实例。
+    - **Session**: 每个HTTP Session都会创建一个新的实例。
+- **装配方式**:
+    - **构造器注入**: 通过构造器参数注入依赖。
+    - **setter注入**: 通过setter方法注入依赖。
+    - **属性注入**: 通过属性直接注入依赖。
+
+#### 5.3.4 使用Spring管理依赖关系
+- **定义**: Spring通过依赖注入来管理对象之间的依赖关系。
+- **目的**: 降低组件之间的耦合度，提高代码的可测试性和可维护性。
+- **示例**:
+  ```java
+  @Service
+  public class UserService {
+      private final UserRepository userRepository;
+      
+      @Autowired
+      public UserService(UserRepository userRepository) {
+          this.userRepository = userRepository;
+      }
+      
+      public User findUserById(Long id) {
+          return userRepository.findById(id).orElse(null);
+      }
+  }
+  ```
+
+### 5.4 Spring MVC(掌握)
+
+#### 5.4.1 Spring MVC概述
+- **定义**: Spring MVC是Spring web框架的一部分，基于Model-View-Controller (MVC) 模式,用于构建Web应用。
+- **特点**:
+    - **请求处理**: 通过@Controller注解来定义控制器。
+    - **视图解析**: 通过ViewResolver来解析视图。
+
+#### 5.4.2 使用@Controller定义控制器
+- **定义**: 使用`@Controller`注解定义控制器类。
+- **示例**:
+  ```java
+  @Controller
+  public class HelloController {
+      @RequestMapping("/hello")
+      public String hello(Model model) {
+          model.addAttribute("message", "Hello, Spring MVC!");
+          return "hello";
+      }
+  }
+  ```
+
+#### 5.4.3 使用@RequestMapping处理请求
+- **定义**: 使用`@RequestMapping`注解来映射请求路径。
+- **示例**:
+  ```java
+  @Controller
+  public class HelloController {
+      @RequestMapping(value = "/hello", method = RequestMethod.GET)
+      public String hello(@RequestParam String name, Model model) {
+          model.addAttribute("message", "Hello, " + name + "!");
+          return "hello";
+      }
+  }
+  ```
+
+#### 5.4.4 使用@ResponseBody返回JSON响应
+- **定义**: 使用`@ResponseBody`注解来直接返回JSON响应。
+- **示例**:
+  ```java
+  @Controller
+  public class HelloController {
+      @RequestMapping(value = "/hello-json", method = RequestMethod.GET)
+      @ResponseBody
+      public Map<String, String> helloJson(@RequestParam String name) {
+          Map<String, String> response = new HashMap<>();
+          response.put("message", "Hello, " + name + "!");
+          return response;
+      }
+  }
+  ```
+
+#### 5.4.5 使用Spring Data JPA进行数据访问
+- **定义**: Spring Data JPA是Spring Data项目的一部分，用于简化JPA的数据访问。
+- **示例**:
+  ```java
+  @Repository
+  public interface UserRepository extends JpaRepository<User, Long> {
+      User findByUsername(String username);
+  }
+  ```
+
+### 5.5 Spring AOP(了解)
+
+#### 5.5.1 AOP的基本概念
+- **定义**: AOP是一种编程范式，用于将横切关注点从业务逻辑中分离出来。
+- **用途**:
+    - **日志记录**: 在方法执行前后记录日志。
+    - **事务管理**: 管理方法的事务边界。
+    - **安全控制**: 控制方法的访问权限。
+- **术语**
+    - **切点 (Pointcut)**: 定义了哪些连接点将被执行通知。
+    - **连接点 (Joinpoint)**: 程序执行的某个特定点，如方法调用。
+    - **通知 (Advice)**: 在连接点处执行的动作，如前置通知、后置通知等。
+    - **切面 (Aspect)**: 包含切点和通知的组合。
+
+#### 5.5.2 使用AspectJ进行切面编程
+- **定义**: AspectJ是一种常用的AOP框架，提供了强大的切面编程能力。
+- **示例**:
+  ```java
+  @Aspect
+  @Component
+  public class LoggingAspect {
+      @Before("execution(* com.example.service.*.*(..))")
+      public void logBefore(JoinPoint joinPoint) {
+          System.out.println("Executing: " + joinPoint.getSignature());
+      }
+  }
+  ```
+
+### 5.6 Spring事务管理(了解)
+
+#### 5.6.1 事务管理的基本概念
+- **定义**: 事务是一组操作的集合，要么全部成功，要么全部失败。
+- **ACID属性**:
+    - **原子性 (Atomicity)**: 事务中的所有操作要么全部完成，要么一个也不完成。
+    - **一致性 (Consistency)**: 事务的执行不会破坏数据的一致性。
+    - **隔离性 (Isolation)**: 事务之间是隔离的，不会相互影响。
+    - **持久性 (Durability)**: 一旦事务提交，它的效果是持久的。
+
+#### 5.6.2 Spring事务管理器
+- **定义**: Spring提供了多种事务管理器，如`DataSourceTransactionManager`。
+- **示例**:
+  ```java
+  @Configuration
+  @EnableTransactionManagement
+  public class AppConfig {
+      @Bean
+      public PlatformTransactionManager transactionManager(DataSource dataSource) {
+          return new DataSourceTransactionManager(dataSource);
+      }
+  }
+  ```
+
+#### 5.6.3 使用@Transactional进行声明式事务管理
+- **定义**: 使用`@Transactional`注解来声明式地管理事务。
+- **示例**:
+  ```java
+  @Service
+  @Transactional
+  public class UserService {
+      private final UserRepository userRepository;
+      
+      @Autowired
+      public UserService(UserRepository userRepository) {
+          this.userRepository = userRepository;
+      }
+      
+      public void createUser(User user) {
+          userRepository.save(user);
+      }
+  }
+  ```
+
+#### 5.6.4 使用编程式事务管理
+- **定义**: 通过编程的方式显式地管理事务。
+- **示例**:
+  ```java
+  @Service
+  public class UserService {
+      private final UserRepository userRepository;
+      private final PlatformTransactionManager transactionManager;
+      
+      @Autowired
+      public UserService(UserRepository userRepository, PlatformTransactionManager transactionManager) {
+          this.userRepository = userRepository;
+          this.transactionManager = transactionManager;
+      }
+      
+      public void createUser(User user) {
+          TransactionDefinition def = new DefaultTransactionDefinition();
+          TransactionStatus status = transactionManager.getTransaction(def);
+          try {
+              userRepository.save(user);
+              transactionManager.commit(status);
+          } catch (Exception e) {
+              transactionManager.rollback(status);
+              throw e;
+          }
+      }
+  }
+  ```
diff --git a/docs/index.md b/docs/index.md
index 5390d07..a9cb9fe 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -117,41 +117,37 @@
 #### 4.5.2 Micronaut
 #### 4.5.3 Quarkus
 
-### 5. 基于Spring框架的后端应用开发
-#### 5.1 Java基础增强
-- 异常处理机制
-- 注解的定义和使用
-- Optional类的应用
-- Stream API进行集合处理
-
-#### 5.2 Spring框架简介
-- Spring框架的历史和发展
-- Spring的核心特性：依赖注入（DI）和面向切面编程（AOP）
-- Spring框架的主要模块：Core Container, Data Access/Integration, Web, AOP, Instrumentation, Messaging, Test
-- Spring框架的应用场景和优势
-
-#### 5.3 Spring IoC容器
-- Spring Bean的定义和生命周期
-- XML和注解方式的Bean配置
-- Bean的作用域和装配方式
-- 使用Spring管理依赖关系
-
-#### 5.4 Spring MVC
-- MVC设计模式回顾
-- 控制器（Controller）的设计原则
-- 模型（Model）和视图（View）的使用
-- 请求映射（@RequestMapping, @GetMapping, @PostMapping 等）
-- 数据绑定和表单标签库
-- 异常处理和错误页面配置
-
-#### 5.5 Spring AOP
-- AOP的基本概念
-- 切点（Pointcut）、连接点（Joinpoint）、通知（Advice）等术语
-- 使用AspectJ进行切面编程
-
-#### 5.5 Spring事务管理
-- 事务管理的基本概念
-- Spring事务管理器
+## 5. 基于Spring框架的后端应用开发
+### 5.1 Java基础增强(掌握)
+#### 5.1.2 注解(了解)
+#### 5.1.3 Optional的介绍和使用(了解)
+#### 5.1.4 Stream API的介绍和使用(了解)
+#### 5.1.5 泛型(了解)
+### 5.2 Spring框架简介(了解)
+#### 5.2.1 Spring框架的历史和发展
+#### 5.2.2 Spring框架的核心特性
+#### 5.2.3 Spring的家族框架
+#### 5.2.4 Spring的应用场景和优势
+#### 5.2.5 Spring Web
+### 5.3 Spring IoC(掌握)
+#### 5.3.1 Spring Bean的定义和生命周期
+#### 5.3.2 XML和注解方式的Bean配置
+#### 5.3.3 Bean的作用域和装配方式
+#### 5.3.4 使用Spring管理依赖关系
+### 5.4 Spring MVC(掌握)
+#### 5.4.1 Spring MVC概述
+#### 5.4.2 使用@Controller定义控制器
+#### 5.4.3 使用@RequestMapping处理请求
+#### 5.4.4 使用@ResponseBody返回JSON响应
+#### 5.4.5 使用Spring Data JPA进行数据访问
+### 5.5 Spring AOP(了解)
+#### 5.5.1 AOP的基本概念
+#### 5.5.2 使用AspectJ进行切面编程
+### 5.6 Spring事务管理(了解)
+#### 5.6.1 事务管理的基本概念
+#### 5.6.2 Spring事务管理器
+#### 5.6.3 使用@Transactional进行声明式事务管理
+#### 5.6.4 使用编程式事务管理
 
 ### 6. 数据库技术
 
diff --git a/docs/resources/exception-hierarchy.png b/docs/resources/exception-hierarchy.png
new file mode 100644
index 0000000000000000000000000000000000000000..34dbe182d398e97b5701c4689acdd0797f90fb1d
GIT binary patch
literal 28712
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

literal 0
HcmV?d00001