SpringBoot整合Mybatis之项目结构、数据源

时间:2024-01-14 09:02:56

已经有好些日子没有总结了,不是变懒了,而是我一直在奋力学习springboot的路上,现在也算是完成了第一阶段的学习,今天给各位总结总结。

之前在网上找过不少关于springboot的教程,都是一些比较粗糙的文章,就连百度百科也是少的可怜,所以进度一直跟不上计划。下面根据我这几天的学习和摸索,谈谈我对spring和springboot的区别,以及很多业界人士说它的快速开发,到底是快在哪儿,方便在哪儿?首先我认为在项目的架构搭建方面变得极其利索,不再需要像之前一样整合ssh或ssm那样进行一大堆的配置文件,他只是通过一个application入口类来配置所有的配置项,包括spring的一些默认配置项;其次springboot它没有太多自己的特性,没有完全颠覆之前的开发模式,反而提供了更加便捷的方式来集成了原来的开发模式,只能说换了一种快速的方式来提高开发速度。

废话我也不多说了,也说不了,后面我会把我这几天的整合过程详细给大家总结下来,初次接触如有地方有误的,望及时指正。

项目结构详解:

SpringBoot整合Mybatis之项目结构、数据源

1、pom文件详解

pom文件中各项依赖的作用见代码注释。

<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>com.zxz.boot</groupId>
<artifactId>springboot_mybatis</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging> <parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.3.4.RELEASE</version>
</parent> <dependencies>
<!--Spring Boot-->
<!--支持 Web 应用开发,包含 Tomcat 和 spring-mvc -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--模板引擎-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<!--支持使用 JDBC 访问数据库-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<!--添加适用于生产环境的功能,如性能指标和监测等功能。 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- springboot的热部署 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<optional>true</optional>
</dependency>
<!--Mybatis-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>1.2.2</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.2.8</version>
</dependency>
<!--Mysql / DataSource-->
<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat-jdbc</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.0.26</version>
</dependency>
<!--Json Support-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.1.43</version>
</dependency>
<!--Swagger support-->
<dependency>
<groupId>com.mangofactory</groupId>
<artifactId>swagger-springmvc</artifactId>
<version>0.9.5</version>
</dependency>
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>4.1.6</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>
</dependencies> <!-- 使用插件来运行springboot(运行springboot的方式有2种:main方法运行或使用下面的插件运行) -->
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build> <repositories>
<repository>
<id>spring-milestone</id>
<url>https://repo.spring.io/libs-release</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>spring-milestone</id>
<url>https://repo.spring.io/libs-release</url>
</pluginRepository>
</pluginRepositories>
</project>

2、项目的入口类application.java详解

先介绍一下在入口类中需要用到的常用注解:

@SpringBootApplication:这是一个组合注解,聚合了多个注解的功能,包含:排除自启动项、排除自启动项的beanname、扫描包和扫描类。【建议瞜一眼源码更好】

@EnableAutoConfiguration:这个注解是用来启动springboot中的自动配置项目,必须的加上,否则无法正常使用springboot默认配置的配置项目。

@ComponentScan :扫描controller层和service层中所有类上的注解(这个注解可以不加,因为组合注解@SpringBootApplication已经可以扫描)。

@MapperScan("com.zxz.mapper") :管理mybatis中所有mapper接口的代理对象。

@EnableTransactionManagement(proxyTargetClass = true):开启事务管理的注解。

 /**
* 整个项目的入口
*/
@SpringBootApplication
@EnableAutoConfiguration
@ComponentScan
@MapperScan("com.zxz.mapper")
@EnableTransactionManagement(proxyTargetClass = true)
public class Application { private static Logger logger = Logger.getLogger(Application.class);
//启动类
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
logger.info("======spring boot start success ===========");
}
}

因为我的项目最后是需要和mybatis整合的,所以在该入口类中必定有一些数据源、每层包扫描和注解扫描、管理mybatis中mapper接口的代理对象和事务管理器等一些必要的配置项。还有通过我上面的项目结构发现,mybatis的sql文件是放置在了resources文件下,所以还得通过配置映射到相应的xml文件中去等等,这些事情都需要借助该入口类来完成。

连接池配置:

首先得配置好连接数据库的一些参数,之前我们是通常配置在某资源文件中,然后通过spring的配置文件进行加载到的,这里我们也需要将连接参数配置到SpringBoot规定的文件application.properties中,最后在入口类中通过注解加载即可。

application.properties配置内容:

 server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/zxz
spring.datasource.username=root
spring.datasource.password=123
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
logging.level.com.zxz.mapper=debug

在入口类中通过注解加载:

 @Bean
@ConfigurationProperties(prefix = "spring.datasource") //作用:加载application.properties文件中的数据库连接参数
public DataSource dataSource(){
return new DataSource();
5 }

但是到这儿,可能很多哥们儿就有点说法了,现在大多数都是使用阿里的Druid数据源,因为性能好,但是在这里配置并没有指定数据源的具体类型,难道默认使用的是Druid,不是的,springboot还不至于这么完美,目前它仅仅支持dbcp、dbcp2、hikari三种数据库连接池。要是你就想要使用druid作为项目中的数据源,那么你就要费点儿力点开下面的代码,只需将它们复制到你的入口类中即可:

 /**
* 注册DruidServlet
* @return
*/
@Bean
public ServletRegistrationBean druidServletRegistrationBean() {
ServletRegistrationBean servletRegistrationBean = new ServletRegistrationBean();
servletRegistrationBean.setServlet(new StatViewServlet());
servletRegistrationBean.addUrlMappings("/druid/*");
return servletRegistrationBean;
}
/**
* 注册DruidFilter拦截
* @return
*/
@Bean
public FilterRegistrationBean duridFilterRegistrationBean() {
FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean();
filterRegistrationBean.setFilter(new WebStatFilter());
Map<String, String> initParams = new HashMap<String, String>();
//设置忽略请求
initParams.put("exclusions", "*.js,*.gif,*.jpg,*.bmp,*.png,*.css,*.ico,/druid/*");
filterRegistrationBean.setInitParameters(initParams);
filterRegistrationBean.addUrlPatterns("/*");
return filterRegistrationBean;
}
/**
* 配置DruidDataSource
* @return
* @throws SQLException
*/
@Bean
public DruidDataSource druidDataSource() throws SQLException {
DruidDataSource druidDataSource = new DruidDataSource();
druidDataSource.setUsername("root");
druidDataSource.setPassword("123");
druidDataSource.setUrl("jdbc:mysql://localhost:3306/zxz");
druidDataSource.setMaxActive(100);
druidDataSource.setFilters("stat,wall");
druidDataSource.setInitialSize(10);
return druidDataSource;
}

事务管理器配置:

       //配置transactionManager
@Bean
public PlatformTransactionManager transactionManager() throws SQLException{
return new DataSourceTransactionManager(druidDataSource());
}

mybatis中mapper.xml文件的映射配置:

因为是和mybatis的整合,免不了mapper.xml的加载和映射,springboot提供了专门的方式来加载它们。

    //提供sqlSession
@Bean
public SqlSessionFactory sqlSessionFactory(PageHelper pageHelper)throws Exception{
SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();
sqlSessionFactoryBean.setDataSource(druidDataSource());
sqlSessionFactoryBean.setPlugins(new Interceptor[] {pageHelper});
PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
sqlSessionFactoryBean.setMapperLocations(resolver.getResources("classpath:/mybatis/*.xml"));
return sqlSessionFactoryBean.getObject();
}

如果上面最基本的各项配置都差不多了,你就可以运行入口类中的伟大的main方法,看到如下界面没有报错信息则表示整合成功,各位尽量写个能访问数据库的业务逻辑来验证整合结果,这里因为时间问题我就不粘贴了:

SpringBoot整合Mybatis之项目结构、数据源

 好了,到这儿我也快收工了,今天就总结到这儿吧,下次继续给各位总结springboot整合mybatis的分页插件pageHelper、springboot的热部署和springboot的日志加载等,与君共勉。