基于Maven的Springboot+Mybatis+Druid+Swagger2+mybatis-generator框架环境搭建

基于Maven的Springboot+Mybatis+Druid+Swagger2+mybatis-generator框架环境搭建

前言

最近做回后台开发，重新抓起以前学过的SSM(Spring+Spring MVC+Mybatis)，但是发现配置实在过于复杂，好多东西配置起来麻烦，虽然最终是配置出来了，但是还是感觉开发速度跟不上，本来打算切换到jfianl，但是后来发现需要用的几个框架不支持jfianl，如Swagger2（根据代码中的注解生成接口文档和测试页面，非常的方便）；同时我也不愿意放弃SpringMVC强大的验证参数模块，jfianl中好像只能手动验证（当然我对jfianl只处于简单的开发，并不是特别熟），而SpringMVC中，直接就能通过注解来确定哪些参数是必须的，哪些不是必须的，这对于写接口的人来说，方便了很多，所以决定还是使用Spring家族的东西，下面先一一介绍下本文的主角们

Spring boot

spring-boot是由Pivotal团队提供的全新框架，其设计目的是用来简化新Spring应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置，从而使开发人员不再需要定义样板化的配置。通过这种方式，Boot致力于在蓬勃发展的快速应用开发领域（rapid application development）成为领导者

多年以来，Spring IO平台饱受非议的一点就是大量的XML配置以及复杂的依赖管理。在2013年的SpringOne 2GX会议上，Pivotal的CTO Adrian Colyer回应了这些批评，并且特别提到该平台将来的目标之一就是实现免XML配置的开发体验。Boot所实现的功能超出了这个任务的描述，开发人员不仅不再需要编写XML，而且在一些场景中甚至不需要编写繁琐的import语句。在对外公开的beta版本刚刚发布之时，Boot描述了如何使用该框架在140个字符内实现可运行的web应用，从而获得了极大的关注度，该样例发表在tweet上

当然上面又是我抄过来的，因为我觉得要我去介绍一个框架是什么的时候，我只会说我的理解，但是我的理解不能让大家知道它的背景，所以抄了上面那段，那么下面就是我理解的Spring boot是个什么东西

无需繁琐配置的Spring集合包 Spring boot本身并不是什么新的框架，它可以说只是Spring大家族的一个集合包，当然这个集合包吧基础的配置都给我配置好了，我们无需再进行繁琐的xml配置，甚至是都不用配置web.xml，因为spring boot内部自己集成了一个tomcat，直接通过run的方式就能启动，打包也一样，都可以不用部署tomcat了，当然是针对小项目，大项目肯定是要对中间件进行一些优化的

Mybatis

MyBatis是一个支持普通SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装。MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录。当然我个人更倾向用注解，因为实在是不怎么喜欢配置xml，尤其是eclipse经常因为xml的一些问题卡主，导致编译要等xml验证通过后才能编译，而我用Mybatis最主要的地方就是因为不用像JDBC那样自己一个属性一个属性来赋值

Druid

Druid是一个JDBC组件，它包括三部分：

DruidDriver 代理Driver，能够提供基于Filter－Chain模式的插件体系。

DruidDataSource 高效可管理的数据库连接池。

SQLParser

Druid可以做什么？

1) 可以监控数据库访问性能，Druid内置提供了一个功能强大的StatFilter插件，能够详细统计SQL的执行性能，这对于线上分析数据库访问性能有帮助。

2) 替换DBCP和C3P0。Druid提供了一个高效、功能强大、可扩展性好的数据库连接池。

3) 数据库密码加密。直接把数据库密码写在配置文件中，这是不好的行为，容易导致安全问题。DruidDruiver和DruidDataSource都支持PasswordCallback。

4) SQL执行日志，Druid提供了不同的LogFilter，能够支持Common-Logging、Log4j和JdkLog，你可以按需要选择相应的LogFilter，监控你应用的数据库访问情况。

扩展JDBC，如果你要对JDBC层有编程的需求，可以通过Druid提供的Filter-Chain机制，很方便编写JDBC层的扩展插件。 其实说简单点Druid就是一个功能强大，性能优秀的数据库连接池，是由阿里巴巴的大牛们开发的,除了性能好之外，我最喜欢的就是它的监控功能了，连github上的说明都是“为监控而生的数据库

Swagger2

关于Swagger的介绍和非代码搭建，在之前的文章已经说过了，不过这里的Swagger2只是版本号为2而已，很多核心的东西都没怎么变化，当然如果不用和代码封装在一起，也可以参考Swagger的介绍和非代码搭建，不过本文主要讲述在代码中集成，所以不再过多描述

mybatis-generator

mybatis-generator是用来根据数据自动生成实体bean和一些常规查询语句的插件，有了这个就不用再一个一个实体bean来写了，而且普通的查询也可以使用自动生成sql语句查询出来

开始搭建

一、创建项目

首先创建一个maven项目，当然最好创建maven-archetype-webapp，原因无他，主要是因为很多时候我还是需要把项目部署到优化过配置的tomcat获取其他容器中，当然也可以创建普通的maven项目

二、添加依赖

<!-- Springboot -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-aop</artifactId>
        </dependency>
        <!-- Springboot 热部署 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
        </dependency>
        <!-- Swagger API文档 -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.2.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.2.2</version>
        </dependency>
        <!-- Mybatis -->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.1.1</version>
        </dependency>
        <!-- druid阿里巴巴数据库连接池 -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.0.26</version>
        </dependency>
        <!-- MySql数据库驱动 -->
        <dependency>
            <groupId> mysql</groupId>
            <artifactId> mysql-connector-java</artifactId>
            <version> 5.0.5</version>
        </dependency>

其中spring-boot-devtools不是必须，只是如果你想在运行的时候，修改了代码能自动更新，而不用手动重启，就需要加上

三、添加Applcation类

这个就是程序的入口类了，代码如下

package wang.raye.springboot;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletComponentScan;
import org.springframework.boot.web.support.SpringBootServletInitializer;

/**
 *
 *
 * @author Raye
 * @since 2016年10月9日22:22:31
 */
@MapperScan("wang.raye.springboot.model.mapper")
@SpringBootApplication
@ServletComponentScan
public class Application extends SpringBootServletInitializer {
    public static void main(String[] args) {
        SpringApplication.run(Application.class);

    }

}

想要运行项目时可以直接运行此类就可以，如你所见，其中有main方法，所以可以直接运行

下面说说3个注解的含义

@MapperScan("wang.raye.springboot.model.mapper")，扫描wang.raye.springboot.model.mapper下面的mapper接口，其中mapper下面的接口是由mybatis-generator自动生成的，会在后面细说，现在就先知道是个什么东西就行了

@SpringBootApplication很多Spring Boot开发者总是使用 @Configuration ， @EnableAutoConfiguration 和 @ComponentScan 注解他们的main类。由于这些注解被如此频繁地一块使用（特别是你遵循以上最佳实践时），Spring Boot提供一个方便的 @SpringBootApplication 选择。该 @SpringBootApplication 注解等价于以默认属性使用 @Configuration ， @EnableAutoConfiguration 和 @ComponentScan

@ServletComponentScan有此注解后，项目中如果需要使用java原生的servlet和filter，可以在类中使用注解实现，主要是配置Druid监控时需要用到

四、创建配置文件

虽然spring boot可以不用配置xml，但是也并不是完全不需要配置文件，当然不用配置文件也能跑起来，只是有配置文件我们可以配置很多东西，只是不用像以前xml那么麻烦，首先需要在resource文件夹下面创建application.yml文件

http://www.jianshu.com/p/f61919229f92