带你十分钟快速构建好 SpringBoot + SSM 框架

Posted 2020-12-25 架构师小跟班

目前最主流的 java web 框架应该是 SSM，而 SSM 框架由于更轻便与灵活目前受到了许多人的青睐。而 SpringBoot 的轻量化，简化项目配置， 没有 XML 配置要求等优点现在也得到了大众的青睐

而本文，我将教大家如何在 intellij idea 中快速构建好一个 Maven + Spring + SpringMVC + MyBatis + SpringBoot 的框架，做到了足够精简，让你可以立刻开始你的 web 项目

一. 创建项目

选择 Spring Initiallizr

添加最基本的几个依赖 Web，MySQL，MyBatis，其他需求可以后续再添加 ; 数据库选择了 MySQL

二. 配置数据源

数据源中存储了所有建立数据库连接的信息

1. 配置 IDEA 数据源

输入地址，端口，用户名，密码等等完成设置

2. 配置 spring 数据源

application.properties 文件添加：

spring.datasource.url = jdbc:mysql://xx.xx.xx.x:xxx/xxx?characterEncoding=utf8&allowMultiQueries=true&useSSL=false

spring.datasource.username = root

spring.datasource.password = 123456

spring.datasource.driver-class-name = com.mysql.jdbc.Driver

• url : 数据源 url ,格式为 jdbc:mysql://Host(主机名或 IP 地址)：Post(端口)/Database(数据库名称)，其中 allowMultiQueries = true ： 允许多条 sql 同时执行（分号分隔）；useSSL ： 是否进行 SSL 连接，根据实际情况选择
• username : 用户名
• password : 密码
• driver-class-name : 驱动名，不同的数据库有不同的 Drivername，如 oracle 数据库的 oracle.jdbc.driver.OracleDriver，MySQL 数据库为 com.mysql.jdbc.Driver

三. Spring 注解

• 使用 @Controller / @RestController 注解标注一个控制器，表明这个类是作为控制器的角色而存在的
• 使用 @Service 注解标注一个业务层类
• 使用 @Repository 注解标注一个持久层 mapper 接口
• 使用 @Component 注解标注其他组件
• 使用 @Configuration 注解标注配置类

四. MyBatis

整个项目的构建最主要的部分就是 springboot 和 mybatis 的整合，而 springboot 也提供了十分方便的方式。

1. xml 文件

• 声明为映射文件
• namespace ： 指该映射文件对应的映射接口 ； 一般来说，一个 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.swit.dao.MyMapper">

</mapper>

2. application.properties

• Mybatis 配置,指定了 mybatis 基础配置文件和实体类映射文件的地址

mybatis.mapperLocations = classpath:mapper/**/*.xml

mybatis.typeAliasesPackage = com.swit.model

• 配置 typeAliasesPackage 可以使得 com.swit.model 包内的实体类可以在映射文件中使用别名，如：

<select id="getUser" parameterType="int" resultType="User">

</select>

如没有配置 typeAliasesPackage ，则需要 resultType="com.swit.model.User"

• 如果要对 MyBatis 通过 xml 文件进行另外的配置,则添加文件路径：

mybatis.config-locations=classpath:mybatis/mybatis-config.xml

3. 添加对 mapper 类的扫描

以下两种方法二选其一

（1）可以选择在启动类添加 @MapperScan

value 为 mapper 类所在的包（注意这里是包的路径，而不是类的路径！）

@MapperScan(value = "com.swit.dao")

另外， @MapperScan 注解面向的是接口类，只要是加了注解的接口类都需要进行通过该注解来扫描

（2）可以在每个 mapper 类上添加 @mapper 注解

@Mapper

@Repository

public interface MyMapper {

}

到目前为止，你已经完成了你的项目的构建，下面我还会介绍些别的东西。

五. 其他要注意的点

1. @SpringBootApplication

• 这个注解位于启动类
• @SpringBootApplication 等价于以默认属性使用 @Configuration ， @EnableAutoConfiguration 和 @ComponentScan， 所以启动类无需再添加这三个注解
• @Configuration ：标注一个类为配置类。
• @EnableAutoConfiguration ：开启自动配置。
• @ComponentScan ：自动收集所有的 Spring 组件

2. 部署服务器

如果你想把自己的 SpringBoot 项目部署到阿里云，腾讯云等服务器，那么你还需要加点东西。

1.如果需要通过打包的方式在web容器中进行部署，则需要继承 SpringBootServletInitializer 覆盖configure(SpringApplicationBuilder)方法

public class SpringbootApplication extends SpringBootServletInitializer {

public static void main(String[] args) {

SpringApplication.run(SpringbootApplication.class, args);

}

@Override

protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {

// 注意这里要指向原先用main方法执行的Application启动类

return builder.sources(SpringbootApplication.class);

}

}

2.pom 文件添加打包插件

<build>

<!--打包后的项目名，url 前缀-->

<finalName>projectName</finalName>

<plugins>

<plugin>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-maven-plugin</artifactId>

</plugin>

<plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-compiler-plugin</artifactId>

<version>3.1</version>

<configuration>

<!--设置编译时使用的 JDK 版本-->

<source>1.8</source>

<!--设置运行时使用的 JDK 版本-->

<target>1.8</target>

<!--设置为 true 则跳过测试-->

<skip>true</skip>

</configuration>

</plugin>

</plugins>

</build>

1. 你很有可能还需要做个跨域处理

@Component

public class CorsFilter implements Filter {

/**

* json web token 在请求头的名字

*/

private String tokenHeader = "X_Auth_Token";

@Override

public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {

HttpServletResponse response = (HttpServletResponse) res;

HttpServletRequest request = (HttpServletRequest) req;

String token = request.getHeader("X_Auth_Token");

System.out.println(token + "token");

String Origin = request.getHeader("Origin");

System.out.println("Origin:" + Origin);

System.out.println("tokenHeader:" + this.tokenHeader);

Logger logger = Logger.getLogger(this.getClass());

logger.info("Origin: " + Origin);

response.setHeader("Access-Control-Allow-Origin", Origin);

response.setHeader("Access-Control-Allow-Methods", "POST, GET, PUT, OPTIONS, DELETE");

response.setHeader("Access-Control-Max-Age", "3600");

response.setHeader("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept, " + this.tokenHeader);

response.setHeader("Access-Control-Allow-Credentials", "true");

chain.doFilter(req, res);

}

@Override

public void init(FilterConfig filterConfig) {

}

@Override

public void destroy() {

}

}

六. 整合其他组件

1. redis

redis 也是我们项目中经常用到的 NoSQL，经常用来做做缓存什么的。

依赖

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-data-redis</artifactId>

</dependency>

application.properties

# Redis数据库索引（默认为0）

spring.redis.database=0

# Redis服务器地址

spring.redis.host=127.0.0.1

# Redis服务器连接端口

spring.redis.port=6379

# Redis服务器连接密码（默认为空）

spring.redis.password=123456

# 连接池最大连接数（使用负值表示没有限制）

spring.redis.pool.max-active=15

# 连接池最大阻塞等待时间（使用负值表示没有限制）

spring.redis.pool.max-wait=-1

# 连接池中的最大空闲连接

spring.redis.pool.max-idle=15

# 连接池中的最小空闲连接

spring.redis.pool.min-idle=0

# 连接超时时间（毫秒）

spring.redis.timeout=0

2. Druid 数据源

针对监控而生的 DB 连接池

依赖

<dependency>

<groupId>com.alibaba</groupId>

<artifactId>druid</artifactId>

<version>1.0.20</version>

</dependency>

application.properties

spring.datasource.type=com.alibaba.druid.pool.DruidDataSource

spring.datasource.filters=stat

spring.datasource.maxActive=20

spring.datasource.initialSize=5

spring.datasource.maxWait=60000

spring.datasource.minIdle=1

spring.datasource.timeBetweenEvictionRunsMillis=60000

spring.datasource.minEvictableIdleTimeMillis=300000

spring.datasource.validationQuery=select ‘x‘

spring.datasource.testWhileIdle=true

spring.datasource.testOnBorrow=false

spring.datasource.testOnReturn=false

spring.datasource.poolPreparedStatements=true

spring.datasource.maxOpenPreparedStatements=20