文章目录
在企业级 Java Web 开发中,SSM(Spring+SpringMVC+MyBatis)框架组合因其强大的功能和灵活性而被广泛应用。本文将详细介绍 SSM 框架整合的实战过程,包括导入依赖、创建数据表、配置文件等各个环节。
一、项目准备
1. 开发环境
- IDE:IntelliJ IDEA 或 Eclipse。
- 数据库:MySQL。
2. 技术选型
- Spring:提供了依赖注入(DI)和面向切面编程(AOP)等功能,用于管理项目中的对象及其依赖关系。
- SpringMVC:实现了模型-视图-控制器(MVC)设计模式,负责处理 Web 请求和响应。
- MyBatis:一种优秀的持久层框架,通过 SQL 映射文件将 Java 对象与数据库表进行映射,简化数据库操作。
二、导入依赖
在项目的构建文件(如 Maven 的 pom.xml 或 Gradle 的 build.gradle)中导入 SSM 框架所需的依赖。以下是一个 Maven 项目的 pom.xml 文件示例:
<dependencyManagement>
<dependencies>
<!-- Spring 依赖 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.3.23</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.23</version>
</dependency>
<!-- MyBatis 依赖 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.11</version>
</dependency>
<!-- MyBatis-Spring 依赖 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>2.0.7</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.32</version>
</dependency>
<!-- Servlet API -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
</dependencies>
</dependencyManagement>
三、创建数据表
使用 MySQL 数据库创建所需的数据表。例如,创建一个名为user
的表,包含id
、username
、password
等字段:
CREATE TABLE `user` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`username` VARCHAR(50) NOT NULL,
`password` VARCHAR(50) NOT NULL,
PRIMARY KEY (`id`)
);
四、配置 web.xml
web.xml
是 Web 应用的部署描述文件,用于配置 Servlet、过滤器、监听器等。在 SSM 框架整合中,需要配置以下内容:
- 配置 DispatcherServlet(SpringMVC 的前端控制器):
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
- 配置字符编码过滤器:
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
五、配置 springmvc
创建springmvc.xml
文件,进行 SpringMVC 的配置。主要包括以下内容:
- 开启注解驱动:
<mvc:annotation-driven />
- 配置视图解析器:
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"/>
<property name="suffix" value=".jsp"/>
</bean>
六、搭建 MyBatis
- 创建 MyBatis 的配置文件
mybatis-config.xml
:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<settings>
<setting name="logImpl" value="LOG4J2"/>
</settings>
</configuration>
- 在
pom.xml
中添加 MyBatis 的日志依赖:
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-logging-slf4j</artifactId>
<version>2.2.0</version>
</dependency>
七、创建属性文件
创建application.properties
或application.yml
文件,用于存储数据库连接等配置信息。例如:
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
八、创建核心配置文件
创建 Spring 的核心配置文件applicationContext.xml
,用于配置 Spring 的 bean 和事务管理等。以下是一个示例:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd">
<!-- 扫描包 -->
<context:component-scan base-package="com.example.demo"/>
<!-- 配置数据源 -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
<property name="driverClassName" value="${spring.datasource.driver-class-name}"/>
<property name="url" value="${spring.datasource.url}"/>
<property name="username" value="${spring.datasource.username}"/>
<property name="password" value="${spring.datasource.password}"/>
</bean>
<!-- 配置事务管理器 -->
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- 开启事务注解 -->
<tx:annotation-driven transaction-manager="transactionManager"/>
</beans>
九、创建日志
可以选择使用 Log4j2、Slf4j 等日志框架。在项目中添加相应的依赖,并配置日志文件。例如,使用 Log4j2 的配置文件log4j2.xml
:
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Root level="info">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>
十、创建 spring 配置文件
在前面已经创建了applicationContext.xml
和springmvc.xml
两个 Spring 相关的配置文件。applicationContext.xml
主要用于配置 Spring 的核心 bean 和事务管理等,springmvc.xml
主要用于配置 SpringMVC 的相关组件。
十一、创建 pojo
创建与数据库表对应的实体类(POJO)。例如,对于前面创建的user
表,可以创建一个User
类:
public class User {
private int id;
private String username;
private String password;
// 省略构造方法、getter 和 setter 方法
}
十二、创建 mapper 接口和映射文件
- 创建 MyBatis 的 mapper 接口,用于定义数据库操作方法。例如:
public interface UserMapper {
User selectUserById(int id);
}
- 创建对应的 SQL 映射文件
UserMapper.xml
:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.demo.mapper.UserMapper">
<select id="selectUserById" resultType="com.example.demo.pojo.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
十三、创建 service 和实现类
- 创建服务接口,定义业务逻辑方法。例如:
public interface UserService {
User getUserById(int id);
}
- 创建服务实现类,实现业务逻辑方法,并调用 mapper 层进行数据库操作。例如:
@Service
public class UserServiceImpl implements UserService {
@Autowired
private UserMapper userMapper;
@Override
public User getUserById(int id) {
return userMapper.selectUserById(id);
}
}
十四、创建 controller
创建控制器类,处理 Web 请求,并调用服务层方法。例如:
@Controller
@RequestMapping("/user")
public class UserController {
@Autowired
private UserService userService;
@GetMapping("/{id}")
@ResponseBody
public User getUserById(@PathVariable int id) {
return userService.getUserById(id);
}
}
通过以上步骤,完成了 SSM 框架的整合。可以启动项目,通过浏览器访问控制器中的接口,测试数据库操作是否正常。
总结:SSM 框架整合是一个复杂的过程,但通过合理的配置和组织代码,可以实现高效的 Java Web 开发。在实际项目中,可以根据具体需求进行扩展和优化,提高开发效率和系统性能。