搭建 Spring 开发环境

介绍

在本项目中，你将学习如何使用 Maven 和 Spring 框架 5.3.7 版设置 Spring 开发环境。本项目将指导你完成创建 Maven 项目、配置 Spring 上下文以及编写测试类以验证 Spring 环境成功设置的过程。

👀 预览

目录结构

Spring 环境已正确设置：

[INFO] 正在扫描项目...
[INFO]
[INFO] ------------------< org.labex:springenv >-------------------
[INFO] 正在构建springenv 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (默认资源) @ springenv ---
[INFO] 使用 'UTF-8' 编码复制过滤后的资源。
[INFO] 正在复制1个资源
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (默认编译) @ springenv ---
[INFO] 无需编译 - 所有类都是最新的
[INFO]
[INFO] --- maven-surefire-plugin:2.12.4:test (默认测试) @ springenv ---
[INFO] Surefire报告目录: /home/labex/project/springenv/target/surefire-reports

-------------------------------------------------------
T E S T S
-------------------------------------------------------
正在运行org.labex.TestSpring
Spring环境已成功构建！
运行的测试: 1, 失败: 0, 错误: 0, 跳过: 0, 耗时: 0.662秒

结果 :

运行的测试: 1, 失败: 0, 错误: 0, 跳过: 0

[INFO] ------------------------------------------------------------------------
[INFO] 构建成功
[INFO] ------------------------------------------------------------------------
[INFO] 总耗时:  2.270 秒
[INFO] 完成时间: 2023-04-10T10:00:00Z
[INFO] ------------------------------------------------------------------------

🎯 任务

在本项目中，你将学习：

如何为 Spring 环境设置 Maven 项目
如何创建 Spring 配置文件 applicationContext.xml
如何编写测试类以验证 Spring 环境设置

🏆 成果

完成本项目后，你将能够：

使用 pom.xml 文件创建 Maven 项目并管理依赖项
使用 applicationContext.xml 文件配置 Spring 上下文
编写测试类以确保 Spring 环境的正确设置

设置 Maven 项目

在这一步中，你将学习如何为 Spring 环境设置一个 Maven 项目。

打开你喜欢的集成开发环境（IDE）或文本编辑器，导航到 ~/project/ 目录。

你会看到一个名为 springenv 的 Maven 项目。目录结构应如下所示：

~/project/springenv/
├── pom.xml
└── src/
    ├── main/
    │   └── java/
    └── test/
        └── java/

打开 pom.xml 文件并添加以下依赖项：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.labex</groupId>
    <artifactId>springenv</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

    <dependencies>
        <!-- Spring框架 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.3.7</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

此 pom.xml 文件为 Spring 框架 5.3.7 版和 JUnit 测试框架设置了必要的依赖项。

创建 Spring 配置文件

在这一步中，你将创建 Spring 配置文件 applicationContext.xml。

在 src/main/resources/ 目录中，你会看到一个名为 applicationContext.xml 的文件。

向 applicationContext.xml 文件中添加以下内容：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
    <!-- 你的bean配置写在这里 -->
</beans>

此文件设置了根 <beans> 元素，并包含 Spring 配置所需的模式规则文件。

创建测试类

在这一步中，你将创建一个测试类来验证 Spring 环境是否成功设置。

在 src/test/java/ 目录中，你会看到一个名为 TestSpring 的 Java 类。

向 TestSpring 类中添加以下代码：

import org.junit.Test;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import static org.junit.Assert.assertTrue;

public class TestSpring {

    @Test
    public void testSpringEnvironment() {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
        System.out.println("Spring环境已成功构建！");
        context.close();

        // 使用assertTrue方法确保测试通过。
        assertTrue(true);
    }
}

此测试类使用 applicationContext.xml 文件创建了一个 ClassPathXmlApplicationContext，并在控制台打印一条消息，以确认 Spring 环境已成功设置。

运行测试

在这最后一步中，你将编译并运行测试以验证 Spring 环境的设置。

打开一个终端，使用以下命令导航到 ~/project/springenv/ 目录：
```
cd ~/project/springenv/
```
运行以下命令来编译并执行测试：
```
mvn test
```

你应该会看到以下输出：

[INFO] 正在扫描项目...
[INFO]
[INFO] ------------------< org.labex:springenv >-------------------
[INFO] 正在构建springenv 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (默认资源) @ springenv ---
[INFO] 使用 'UTF-8' 编码复制过滤后的资源。
[INFO] 正在复制1个资源
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (默认编译) @ springenv ---
[INFO] 无需编译 - 所有类都是最新的
[INFO]
[INFO] --- maven-surefire-plugin:2.12.4:test (默认测试) @ springenv ---
[INFO] Surefire报告目录: /home/labex/project/springenv/target/surefire-reports

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
正在运行org.labex.TestSpring
Spring环境已成功构建！
运行的测试: 1, 失败: 0, 错误: 0, 跳过: 0, 耗时: 0.662秒

结果 :

运行的测试: 1, 失败: 0, 错误: 0, 跳过: 0

[INFO] ------------------------------------------------------------------------
[INFO] 构建成功
[INFO] ------------------------------------------------------------------------
[INFO] 总耗时:  2.270 秒
[INFO] 完成时间: 2023-04-10T10:00:00Z
[INFO] ------------------------------------------------------------------------

该输出表明测试已成功执行，并且 Spring 环境已正确设置。

恭喜你！你已完成使用 5.3.7 版本设置 Spring 开发环境的项目。

总结

恭喜你！你已完成这个项目。你可以在 LabEx 中练习更多实验来提升你的技能。