Spring IN ACTION

源码地址：Spring-in-Action

Spring 核心
Web 中的 Spring
- Chapter 5
- Chapter 6
- Chapter 7
- Chapter 8
- Chapter 9

Chapter 1 - 简化 Java 开发

这章节主要介绍了 Spring 为 Java 开发带来了哪些便利之处。

依赖注入所带来的最大收益就是 —— 松耦合。
AOP 能够确保 POJO 的简单性。
Spring 通过模板来消除 样板式 代码。

总结

Spring 框架关注于通过 DI、AOP 和消除样板式代码来简化企业级 Java 开发。

Chapter 2 - 装配 Bean

本章会涉及如何声明 Bean，如何扫描 Bean，如何装配 Bean。默认情况下，Spring 中的 bean 都是单例。

1. 声明 Bean

作者推荐优先使用 隐式声明，再者 JavaConfig，最后才是 XML 的方式。

隐式的声明，通过 @Component 注解让 Spring 自动发现。这个简单的注解表明该类会作为组件类，并告知 Spring 要为这个类创建 bean。

由于组件扫描默认是不启动的，需要手动启动。
1. 可以通过 @ComponentScan 注解来开启扫描。
2. 可以通过 XML 配置文件来开启扫描。
这两种方式也是 Spring 中最常用的方式。
在 JavaConfig 配置中，通过 @Bean 注解来声明 bean。

@Bean 注解会告诉 Spring 注释的方法将会返回一个对象，该对象要注册为 Spring 应用上下文中的 bean。
在 xml 文件中，通过 <bean> 标签来声明 bean。

2. Bean 装配方式

通过 @Autowired 注释来实现。@Autowired 可以将声明的 bean 注入，无论是上述那种方式声明出来 bean 都可以注入。

隐式装配 bean是最为推荐的方式。但是有时候，比不可免的要使用 xml 或 JavaConfig 的方式来进行配置 bean。因为比如，你想要将 第三方库 中的组件装配到你的应用中，这个时候隐式的装配就不行了。

总结

bean 的三种配置：

隐式配置：@Component 配合 @ComponentSan 进行扫描。
JavaConfig 显示配置，@Bean 在 @Configuration 修饰的配置类中进行声明 bean 的声明。
XML 显示配置，bean 的声明就是在 XML 文件中通过 <bean> 标签来声明。

Chapter 3 - 高级装配

本章的内容

3.1 Spring profile

本章所有的代码都在 Chapter 3下。

Spring profile 就是为了简化项目迁移流程和降低迁移项目带来的人工成本。

Spring 提供的 profile 将本地开发环境、测试环境以及生产环境都有效的划分开来。我们可以通过简单的配置就可以让项目在相应的环境中运行。

有两种配置 profile 的方法：

使用 @Profile 注解，表明这个类是配置类，需要在指定的环境下才会激活。
在 XML 配置文件中通过设置 <beans> 中的 profile 属性来指定其运行的环境。

激活某个profile

文中提供了下面几种方式：

作为 DispatcherServlet 的初始化参数
作为 Web 应用的上下文参数
作为 JNDI 条目
作为环境变量
作为 JVM 的系统属性
在集成测试类上，使用 @ActiveProfiles 注解设置

这里图个方便，就选用最后一个方式来验证 Spring profile 的功能。

3.2 条件化的 bean 声明

条件化的 bean 声明：顾名思义，只有在满足了一定的条件时，bean 对象才会被创建出来。

如何来设置条件？

可以通过 @Conditional 注解来实现。

com.sprintinaction.conditionbean.ConditionBeanConfig.Class

@Configuration
@PropertySource("/conditionbean.properties")
public class ConditionBeanConfig {

    @Bean
    @Conditional(MagicExistCondition.class)
    // Conditional 会去执行 MagicExistCondition 中的 match 方法
    // 根据其返回的 boolean 值来确定是否创建 bean 对象
    public MagicBean magicBean() {
        return new MagicBean();
    }
}

这里还需要注意一点，凡是在 @Conditional 中添加的类都需要继承 org.springframework.context.annotation.Condition 这个接口。

public interface Condition {

	boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata);
}

注意：书中只给了如何判断当前运行环境中是否存在 ‘magic’ 属性，却没有告诉我们如何来模拟设置。

我的做法是在 JavaConfig 中使用 @PropertySource("/conditionbean.properties") 来引入一个配置文件，其内容是简单的 magic=magic。这样测试用例就能成功通过了。

3.3 自动装配与歧义性

作者提供给我们一个例子：

@Autowired
public void setDessert(Dessert dessert) {
    this.dessert = dessert;
}

@Component
public class Cake implements Dessert { ... }
@Component
public class Cookies implements Dessert { ... }
@Component
public class IceCream implements Dessert { ... }

像上面的情况下，Spring 是无法自动装载 bean 对象的。因为每个 bean 都是继承了 Dessert 这个接口，每个都符合，Spring 反而没有主意了。这就是自动装配可能存在的歧义性。

如何避免出现自动装载的歧义性？

书中提供了 2 种解决方案：

@Primary 或者 <bean primary="true">，出现相同的 bean 时，优先注入 @Primary 修饰的 bean。
@Qualifier，直接限定要注入的 bean。

简单一点理解就是，@Primary 是让 Spring 自己选；@Qualifier 是你替 Spring 做了决定。

3.4 bean 的作用域

Spring 创建的 bean 对象默认情况下都是单例的。

什么是单例？就是每次注入或者说创建出来的对象都是同一个。严格意义上面来讲，只有第一次算是创建，后面再用到这个对象的时候只是引用同一个对象而已(有兴趣的可以了解一下单例模式)。

Spring 定义了多种 bean 的作用域：

Singleton，在整个应用中，只创建 bean 的一个实例。
Prototype，每次注入或者通过 Spring 应用上下文获取的时候，都会创建一个新的 bean 实例。
Session，在 Web 应用中，为每个会话创建一个 bean 实例。
Request，在 Web 应用中，为每个请求创建一个 bean 实例。

如何定义 bean 的 scope？

通过 @Scope 注解定义。

@Component
@Scope(ConfigurableBeanFactory.SCOPE_SINGLETON)
// @Scope("singleton") 作用一样
public class SingletonBean {
    @Override
    public boolean equals(Object obj) {
        System.out.println(this);
        System.out.println(obj);
        return this == obj;
    }
}

通过在 XML 文件中定义 bean 的 scope 属性值来指定。

<bean id="prototypeBean" scope="prototype" class="com.springinaction.scope.PrototypeBean"/>

书中介绍了 Singleton, Prototype, Session 这三种使用方式。为了便于测试，这里我就使用了 Singleton 与 Prototype 这两种范围。

3.5 Spring 表达式语言

这节会介绍 org.springframework.core.env.Environment 这个类的使用场景。

了解 EL 表达式或许会更好理解。它其实就是一个占位符，在程序运行的时候将根据占位符中的 key 来查找相应的 value 当做程序需要的参数注入进去。

无论是 EL 表达式还是 SpringEL 都是需要读取外部文件。

外部注入值

由于，直接赋值的方法不太好，这样做代码灵活性不够高。避免这样的做法，最简单就是通过外部注入的属性值方式。

@PropertySource可以将指定的参数设置到 Spring 的 Environment 里面。我们可以通过 org.springframework.core.env.Environment 这个对象来获取其中的属性值。

@Configuration
@PropertySource("/runtimeInject.properties")
public class RuntimeInjectConfig {

    @Autowired
    Environment environment;

    @Bean
    public Student student() {
        return new Student(environment.getProperty("name"), environment.getProperty("phone"), environment.getProperty("number"));
    }
}

@Value 注入

public Teacher(@Value("${name}") String name, @Value("${sex}") String sex) {
    this.name = name;
    this.sex = sex;
}

在 XML 文件中设置

<context:property-placeholder location="runtimeInject.properties"/>

<bean id="student" class="com.springinaction.runtimeInject.Student">
    <constructor-arg index="0" value="${name}"/>
    <constructor-arg index="1" value="${phone}"/>
    <constructor-arg index="2" value="${number}"/>
</bean>

使用 Spring EL 进行装配

#{ <expression string> } 其实就是通过这个表达式来获取参数。

其特性如下：

使用 bean 的 ID 来引用 bean。
调用方法和访问对象的属性(其实就是第一条特性的衍生)。
对值进行算数、关系和逻辑运算。
正则表达式匹配。
集合操作。

Chapter4 - 面向切面的 Spring

本章内容

4.1 Spring AOP 术语

通知(Advice)

切面的工作被称为通知。通知定义了切面是什么以及何时使用。
连接点(Join point)

连接点是在应用执行过程中能够插入切面的一个点。这个点可以是调用方法时、抛出异常时、甚至是修改一个字段时。
切点(Poincut)

如果说通知定义了切面的“什么”和“何时”的话，那么切点就定义了“何处”。切点的定义会匹配通知所要织入的一个或者多个连接点。
切面(Aspect)

切面是通知和切点的结合。
引入(Introduction)

引入允许我们向现有的类（在不修改该类的前提下）添加新的方法或者属性。
织入(Weaving)

织入是把切面应用到目标对象并创建新的代理对象的过程。切面在指定的连接点被织入到目标对象中。
Advisor

Advisor 决定了如何在哪些地方使用切面以及用那些个切面，相对于 Advice 就更加具体化了。

4.2 使用注解创建切面

@AspectJ 是用来声明一个切面的，但是仅仅有了切面还是不够。因为切面是由 通知和切点 这两个要素组成的。

4.2.1 声明通知的注解

注解	通知
`@After`	通知方法会在目标方法返回或抛出异常后调用
`@AfterReturning`	通知方法会在目标方法返回后调用
`@AfterThrowing`	通知方法会在目标方法抛出异常后调用
`@Around`	通知方法会将目标方法封装起来
`@Before`	通知方法将在目标方法调用前执行

这些注解都是 AspectJ 的注解，所以要使用这些注解需要引入 aspectjweaver 才行。

4.2.2 定义切点

在声明通知的时，需要同时定义切点。这个从通知注解的源码中就可以获晓。

AspectJ 指示器	描述
arg()	限制连接点匹配参数为指定类型的执行方法
@args()	限制连接点匹配参数由指定注解标注的执行方法
execution()	用于匹配是连接点的执行方法（里面的表达式就是连接点的执行方法的正则表达式）
this()	限制连接点匹配AOP代理的bean引用为指定类型的类
target	限制连接点匹配目标对象为指定类型的类
@target()	限制连接点匹配特定的执行对象，这些对象对应的类要具有指定类型的注解
within()	限制连接点匹配指定的类型
@within()	限制连接点匹配指定注解所标注的类型（当使用Spring AOP时，方法定义在由指定的注解所标
注的类里）
@annotation	限定匹配带有指定注解的连接点

注意：只有execution指示器是实际执行匹配的，而其他的指示器都是用来限制匹配的。

下面是代码介绍：

此时的 Audience 还算不上是真正的切面，只能说他具有切面一切应该有的功能，但是最终还是需要 Spring 的容器来生产管理才行，这个时候才是真正的切面。

测试用例在 annotation.concert 包下面。

4.2.3 处理通知中的参数

这些圈出来的部分，类型必须一致，参数名称也必须一致。

4.2.4 通过注解引入新功能

前面我们提到的都是针对于对象的方法增强，一定看清楚，是对象的方法增强。

引入的概念就是在不改变对象原来结构的前提下，增加对象的方法。

下图展示了其如何工作：

关键点是使用注解 @DeclareParents。

4.3 使用 xml 创建切面

没有什么坑的地方，跟着书上的内容敲就行了。切面的声明都在 concert-xml-beans.xml 中。

4.4 注入 AspectJ 切面

唯一要注意的地方就是将项目默认编译选择为 Ajc，这样 AspectJ 才能够在编译期织入目标类。

5. Sprig MVC 起步

这章主要就是通过 annotation 来快速的搭建 Spring MVC。这里server 我选用 tomcat。

同时，书中选用了测试 Spring MVC 的框架 - mockito

6. 渲染 Web 视图

这章主要是介绍了两种 Spring 支持的视图模板：

Tiles
Thymeleaf

7. Spring MVC 的高级技术

介绍了通过 web.xml 配置 Spring MVC。这里貌似缺了一下源码，我打算重新建一个项目来简单的演示一下，如何配置 web.xml 文件。
介绍了利用 Spring 上传文件的两种方式：
1. StandardServletMultipartResolver（推荐）
2. CommonsMultipartResolver
文件上传的路径需要提前创建好文件夹，不然会抛出异常。

如何利用 Spring 处理异常

@ExceptionHandler，处理一种异常，而且只作用于同一个 Controller 中。

如果想要 @ExceptionHandler 应用于所有 Controller 中，那么需要配合 @ControllerAdvice

@ControllerAdvice
public class AppWideExceptionHandler {

    @ExceptionHandler(DuplicateSpittleException.class)
    public String handleDuplicateSpittle() {
        return "redirect:/error/duplicate";
    }
}

利用 Spring 来实现重定向功能。

重定向带来的问题：重定向之后原来模型数据都会消亡。

解决方法：
1. 使用 URL 模板以路径变量或查询参数的形式传递数据
2. 通过 flash 属性发送数据（将数据存储在 session 中）
重定向其实是2个请求。

8. Spring Web Flow

在 Spring Web Flow 中，流程主要由 3 个元素定义：

状态

状态类型	作用
行为（Action）	行为状态是流程逻辑发生的地方
决策（Decision）	决策状态将流程分成两个方向，它会基于流程数据的评估结果确定流程方向
结束（End）	结束状态是流程的最后一站。一旦进入End状态，流程就会终止
子流程（Subflow）	子流程状态会在当前正在运行的流程上下文中启动一个新的流程
视图（View）	视图状态会暂停流程并邀请用户参与流程

转移
流程数据

9. Spring Security 简介

Spring Security 是一种基于 Spring AOP 和 Servlet 规范中的 Filter 实现的安全框架。
Spring Security从两个角度来解决安全性问题。
1. 使用 Servlet 规范中的 Filter 保护 Web 请求并限制 URL 级别的访问。
2. 使用 Spring AOP 保护方法调用——借助于对象代理和使用通知，能够确保只有具备适当权限的用户才能访问安全保护的方法。

awsome-book-note

Notes | Conclusion | Collections