当前位置：首页 > news >正文

Spring Framework 入门：传统 XML 配置启动方式详解

news 2025/9/22 13:53:31

Spring Framework 入门：传统 XML 配置启动方式详解

作为 Java 开发中最受欢迎的开源框架之一，Spring 以其依赖注入（Dependency Injection, DI）和控制反转（Inversion of Control, IoC）等核心概念，帮助我们构建松耦合、可维护的企业级应用。如果你是个 Spring 新手，或者想复习一下经典的 XML 配置方式，这篇文章将带你一步步从零搭建一个简单的 Spring 项目。

为什么选择 XML 配置启动？虽然现代 Spring Boot 更流行注解和自动配置，但理解 XML 方式能让你深入把握 Spring 的核心原理，比如 Bean 的生命周期、依赖管理等。这对学习 Spring 的底层机制非常有帮助。本文基于 Spring 5.x 版本（兼容 Spring 6），我们将创建一个简单的用户服务示例，涉及 DAO 和 Service 层。项目使用 Maven 构建，数据库部分仅作示例（不涉及实际连接）。

前置准备

在开始前，确保你的开发环境就绪：

JDK：推荐 JDK 8 或更高版本（本文使用 JDK 17 测试通过）。
Maven：用于依赖管理，确保已安装并配置好环境变量。
IDE：IntelliJ IDEA 或 Eclipse，方便代码编写和调试。

项目结构

：创建一个标准的 Maven 项目，目录结构如下：

text

src
├── main
│   ├── java
│   │   └── com.example
│   │       ├── dao
│   │       └── service
│   └── resources
│       └── applicationContext.xml  // Spring 配置文件
└── test└── java└── com.example.TestSpring  // 测试类

如果你是初学者，建议先在 IDE 中创建一个 Maven 项目 archetype（例如 maven-archetype-quickstart），然后逐步添加代码。

步骤 1: 引入 Maven 依赖

Spring 的核心是 spring-context 模块，它负责 IoC 容器和 Bean 管理。如果你的项目涉及数据库操作（如 JDBC），还需要添加 spring-jdbc 和数据库驱动。这里我们以 MySQL 为例（即使不实际连接数据库，也可作为扩展准备）。

在 pom.xml 文件中添加以下依赖：

<dependencies><!-- Spring 核心依赖：提供 IoC 容器、Bean 定义等 --><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>5.3.39</version>  <!-- 可升级到最新版本，如 6.1.x --></dependency><!-- Spring JDBC 依赖：用于数据库操作（可选，本示例不实际使用） --><dependency><groupId>org.springframework</groupId><artifactId>spring-jdbc</artifactId><version>5.3.39</version></dependency><!-- MySQL 驱动：用于连接 MySQL 数据库（可选） --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.33</version></dependency>
</dependencies>

小贴士：

版本选择：Spring 5.x 支持 JDK 8+，Spring 6.x 要求 JDK 17+。如果项目老旧，保持 5.x 版本。
常见问题：Maven 下载依赖失败？检查网络或镜像源（如阿里云镜像）。运行 mvn clean install 测试依赖是否正常。
扩展：如果需要 AOP 或 Web 支持，可添加 spring-aop 或 spring-web 依赖。

步骤 2: 创建 Spring 核心配置文件

Spring 的 XML 配置文件（通常命名为 applicationContext.xml）是 IoC 容器的入口。它定义了 Bean 的创建、依赖注入等。放置在 src/main/resources 目录下。

文件内容示例：

<?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/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd"><!-- 定义 UserDao Bean：数据访问层 --><bean id="userDao" class="com.example.dao.UserDao"/><!-- 定义 UserService Bean：业务服务层，通过 setter 注入 UserDao --><bean id="userService" class="com.example.service.UserService"><property name="userDao" ref="userDao"/>  <!-- ref 引用其他 Bean --></bean></beans>

详细解释：

：根元素，声明 XML Schema。
：定义一个 Bean。id 是唯一标识，class 是全限定类名。
：用于依赖注入。这里使用 setter 注入（ref 引用另一个 Bean 的 id）。
为什么用 XML？它显式、可读性强，便于大型项目配置。缺点是繁琐，现代项目多用注解（如 @Autowired）。
扩展：想添加数据源？可以引入并配置 URL、用户名等。

常见错误：Bean id 重复或类路径错误会导致启动失败。调试时检查日志。

步骤 3: 定义 Bean 类

现在，实现具体的 Java 类。Spring 通过反射创建这些类的实例，并管理它们的依赖。

DAO 层：数据访问对象

UserDao.java（位于 com.example.dao 包）：

package com.example.dao;public class UserDao {public void save() {System.out.println("UserDao: 保存用户数据");// 实际项目中，这里可添加 JDBC 操作或调用 ORM（如 Hibernate）}
}

DAO 负责与数据库交互。本例简单输出日志，实际可扩展为数据库 CRUD。

Service 层：业务逻辑

UserService.java（位于 com.example.service 包）：

package com.example.service;import com.example.dao.UserDao;public class UserService {private UserDao userDao;  // 依赖 UserDao// Setter 方法：用于 Spring 注入依赖public void setUserDao(UserDao userDao) {this.userDao = userDao;}public void addUser() {System.out.println("UserService: 调用业务逻辑");if (userDao != null) {userDao.save();  // 调用 DAO 方法} else {System.out.println("Error: UserDao 未注入！");}}
}

注入原理：Spring 通过 setter 方法注入 userDao，实现控制反转（IoC）。这样，Service 不需手动 new Dao，降低耦合。

丰富扩展：

构造函数注入：替代 setter，可在 XML 中用。
接口编程：实际项目中，定义 UserDao 接口并实现类，提升可扩展性。
异常处理：添加 try-catch 或 Spring 的 @Transactional（需额外配置）。

步骤 4: 启动 Spring 容器并测试

最后，编写测试类加载配置文件，获取 Bean 并执行。

TestSpring.java（位于测试包或 main 下）：

import com.example.service.UserService;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;public class TestSpring {public static void main(String[] args) {// 加载 XML 配置文件，启动 IoC 容器ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");// 获取 Bean 实例UserService userService = (UserService) context.getBean("userService");// 执行方法userService.addUser();}
}

运行输出：

UserService: 调用业务逻辑
UserDao: 保存用户数据

工作原理：

ClassPathXmlApplicationContext：从 classpath 加载 XML，创建容器。
getBean()：根据 id 获取 Bean，支持类型转换。
容器生命周期：启动时解析 XML、实例化 Bean、注入依赖；关闭时销毁 Bean。

调试技巧：如果 BeanNotFoundException，检查 id 或类路径。启用 Spring 日志（添加 log4j 依赖）查看详细过程。

进阶与最佳实践

注解配置替代：从 Spring 2.5 开始，可用 @Component、@Autowired 注解替换 XML。示例：扫描包 <context:component-scan base-package=“com.example”/>。
Spring Boot 迁移：想简化？用 Spring Boot 的 @SpringBootApplication 自动配置，无需 XML。
性能优化：大型项目用懒加载（lazy-init=“true”）避免启动慢。
安全考虑：XML 配置易暴露敏感信息（如密码），用外部 properties 文件注入。
学习资源：官方文档（spring.io）、书籍《Spring in Action》。实践是关键，试着添加更多 Bean 或整合数据库。