如何搭建SSM框架配置

1. 引言

SSM框架是Spring、Spring MVC和MyBatis三个开源框架的整合，广泛应用于Java Web开发中。Spring负责业务层（Service层）的管理，Spring MVC负责控制层（Controller层）的请求分发，MyBatis负责数据持久层（DAO层）的数据库操作。本文将详细介绍如何从零开始搭建一个SSM框架的配置。

2. 环境准备

在开始搭建SSM框架之前，需要确保开发环境已经准备好。以下是所需的环境和工具：

• JDK 1.8或更高版本
• Maven 3.x
• IntelliJ IDEA或Eclipse IDE
• Tomcat 8.x或更高版本
• MySQL 5.x或更高版本

3. 创建Maven项目

首先，使用Maven创建一个Web项目。在IntelliJ IDEA中，可以通过以下步骤创建：

1. 打开IntelliJ IDEA，选择File -> New -> Project。
2. 选择Maven，然后点击Next。
3. 输入GroupId和ArtifactId，然后点击Next。
4. 选择项目存储路径，点击Finish。

项目创建完成后，pom.xml文件会自动生成。接下来，我们需要在pom.xml中添加SSM框架所需的依赖。

4. 添加依赖

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

<dependencies>
    <!-- Spring MVC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.18</version>
    </dependency>

    <!-- Spring JDBC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>5.3.18</version>
    </dependency>

    <!-- MyBatis -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>

    <!-- MyBatis-Spring -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>2.0.6</version>
    </dependency>

    <!-- MySQL Connector -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>

    <!-- Servlet API -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>

    <!-- JSTL -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>jstl</artifactId>
        <version>1.2</version>
    </dependency>

    <!-- Log4j -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>

    <!-- Jackson for JSON -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.12.3</version>
    </dependency>
</dependencies>

5. 配置Spring MVC

5.1 配置web.xml

在src/main/webapp/WEB-INF目录下创建web.xml文件，并配置Spring MVC的DispatcherServlet：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>

    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

5.2 配置spring-mvc.xml

在src/main/resources目录下创建spring-mvc.xml文件，配置Spring MVC的相关组件：

<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:mvc="http://www.springframework.org/schema/mvc"
       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/mvc
       http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 扫描Controller -->
    <context:component-scan base-package="com.example.controller"/>

    <!-- 启用注解驱动 -->
    <mvc:annotation-driven/>

    <!-- 配置视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- 静态资源处理 -->
    <mvc:resources mapping="/static/**" location="/static/"/>

</beans>

6. 配置Spring和MyBatis

6.1 配置applicationContext.xml

在src/main/resources目录下创建applicationContext.xml文件，配置Spring和MyBatis的整合：

<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">

    <!-- 扫描Service -->
    <context:component-scan base-package="com.example.service"/>

    <!-- 配置数据源 -->
    <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
        <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/ssm_demo?useSSL=false&amp;serverTimezone=UTC"/>
        <property name="username" value="root"/>
        <property name="password" value="password"/>
    </bean>

    <!-- 配置SqlSessionFactory -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="mapperLocations" value="classpath:mapper/*.xml"/>
    </bean>

    <!-- 配置Mapper扫描 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.example.dao"/>
    </bean>

    <!-- 配置事务管理器 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>

    <!-- 启用注解事务 -->
    <tx:annotation-driven transaction-manager="transactionManager"/>

</beans>

6.2 配置MyBatis Mapper

在src/main/resources/mapper目录下创建UserMapper.xml文件，配置MyBatis的SQL映射：

<?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.dao.UserMapper">

    <select id="selectUserById" resultType="com.example.model.User">
        SELECT * FROM user WHERE id = #{id}
    </select>

    <insert id="insertUser" parameterType="com.example.model.User">
        INSERT INTO user (username, password) VALUES (#{username}, #{password})
    </insert>

</mapper>

7. 创建实体类和DAO接口

7.1 创建实体类

在src/main/java/com/example/model目录下创建User.java实体类：

package com.example.model;

public class User {
    private int id;
    private String username;
    private String password;

    // Getters and Setters
}

7.2 创建DAO接口

在src/main/java/com/example/dao目录下创建UserMapper.java接口：

package com.example.dao;

import com.example.model.User;

public interface UserMapper {
    User selectUserById(int id);
    void insertUser(User user);
}

8. 创建Service层

在src/main/java/com/example/service目录下创建UserService.java接口及其实现类UserServiceImpl.java：

package com.example.service;

import com.example.model.User;

public interface UserService {
    User getUserById(int id);
    void addUser(User user);
}

package com.example.service;

import com.example.dao.UserMapper;
import com.example.model.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public User getUserById(int id) {
        return userMapper.selectUserById(id);
    }

    @Override
    public void addUser(User user) {
        userMapper.insertUser(user);
    }
}

9. 创建Controller层

在src/main/java/com/example/controller目录下创建UserController.java：

package com.example.controller;

import com.example.model.User;
import com.example.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/user")
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/{id}")
    @ResponseBody
    public User getUser(@PathVariable int id) {
        return userService.getUserById(id);
    }

    @PostMapping("/add")
    @ResponseBody
    public String addUser(@RequestBody User user) {
        userService.addUser(user);
        return "User added successfully";
    }
}

10. 创建视图

在src/main/webapp/WEB-INF/views目录下创建index.jsp文件：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>SSM Demo</title>
</head>
<body>
    <h1>Welcome to SSM Demo</h1>
</body>
</html>

11. 运行项目

1. 在IntelliJ IDEA中，右键点击项目，选择Run -> Edit Configurations。
2. 点击+，选择Tomcat Server -> Local。
3. 配置Tomcat的路径和端口。
4. 点击Apply，然后点击OK。
5. 点击Run按钮，启动项目。

12. 总结

通过以上步骤，我们成功搭建了一个基于SSM框架的Java Web项目。Spring负责业务层的管理，Spring MVC负责控制层的请求分发，MyBatis负责数据持久层的数据库操作。这种分层架构使得项目结构清晰，便于维护和扩展。希望本文能帮助你快速上手SSM框架的配置与开发。