SpringBoot+Mybatis+PageHelper+logback+Swagger+Maven的整合配置

微服务已成为现在比较热门的话题，而Pivotal团队提供该框架是为了节省时间并实现简单开发，因它默认了整合了很多的框架（当然，各位可以自行去摸索或者查看官方文档：https://spring.io/projects/spring-boot）；而Mybatis作为数据层采用阿里提供的Druid数据源，分页采用PageHelper，lomback作为日志输出，Swagger作为生成Restful的API接口文档（缺点：有侵入代码，不是很友好），个人感觉还是蛮好用的。

logback、mybatis、pagehelper配置

---

logging:
    level:
    com.test: ERROR
    config: classpath:logback.xml
    path: /项目名
spring:
    application:
        name: 项目名
    boot:
        admin:
             url: http://localhost:3306
    datasource:
#        name: test
        url: jdbc:mysql://数据库地址:3306/项目名?useUnicode=true&characterEncoding=UTF8&zeroDateTimeBehavior=round&allowMultiQueries=true
        username: root
        password: 数据库密码
        # 使用druid数据源
        type: com.alibaba.druid.pool.DruidDataSource
        driver-class-name: com.mysql.jdbc.Driver
        #属性类型是字符串，通过别名的方式配置扩展插件，常用的插件有：
        #监控统计用的filter:stat
        #日志用的filter:log4j
        #防御sql注入的filter:wall
        filters: stat,wall
        #最大连接池数量
        maxActive: 20
        #初始连接数
        initialSize: 5
        #获取链接超时时间为1分钟，单位为毫秒。
        maxWait: 60000
        #配置5,当线程池数量不足，自动补充。
        minIdle: 5
        #1.Destroy线程会检测连接的间隔时间
        #2.testWhileIdle的判断依据
        timeBetweenEvictionRunsMillis: 60000
        #一个链接生存的时间（默认的值：25200000，换算后的结果公式是：300000/1000/60 = 5分钟）
        minEvictableIdleTimeMillis: 300000
        #检测数据库链接是否有效，必须配置
        validationQuery: select 'x'
        #此项配置为true即可，不影响性能，并且保证安全性。意义为：申请连接的时候检测，
        #如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效
        testWhileIdle: true
        #获取链接的时候，不校验是否可用，开启会有损性能
        testOnBorrow: false
        #归还链接到连接池的时候校验链接是否可用
        testOnReturn: false
        poolPreparedStatements: true
        #要启用PSCache，必须配置大于0，当大于0时，poolPreparedStatements自动触发修改为true。
        #在Druid中，不会存在Oracle下PSCache占用内存过多的问题，可以把这个数值配置大一些，比如说100
        maxOpenPreparedStatements: 20
        #链接回收的时候控制台打印信息，测试环境可以加上true，线上环境false。会影响性能。
        log-abandoned: true
        maxPoolPreparedStatementPerConnectionSize: 20
    http:
      encoding:
        charset: utf-8
#        charset: unicode
        enabled: true
        force: true
server:
    port: 8090
#错误日志输出
debug: true

---

1、logback配置

resource文件夹下新建logback.xml文件，然后具体配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="60 seconds">
    <include resource="org/springframework/boot/logging/logback/base.xml"/>
    <logger name="org.springboot.sample" level="TRACE" />
    <!-- 测试环境+开发环境. 多个使用逗号隔开. -->
    <springProfile name="test,dev">
        <!--<logger name="org.springframework.web" level="INFO"/>-->
        <logger name="org.springboot.sample" level="DEBUGGER" />
        <logger name="全包名，一直到公共包名停止，如项目基于com.test下面进行功能或者模块分包裹，那么这里就到com.test" level="DEBUGGER" />
    </springProfile>
    <!-- 生产环境. -->
    <springProfile name="prod">
        <logger name="org.springboot.sample" level="ERROR" />
        <logger name="全包名，一直到公共包名停止，如项目基于com.test下面进行功能或者模块分包裹，那么这里就到com.test" level="ERROR" />
    </springProfile>
    <!--<jmxConfigurator/>-->
</configuration>

---

2、mybatis、pagehelper配置

com.test下新建conf文件，在文件中新建MybatisConfiguration类，具体配置如下：

import com.alibaba.druid.pool.DruidDataSource;
import com.alibaba.druid.filter.Filter;
import com.alibaba.druid.wall.WallConfig;
import com.alibaba.druid.wall.WallFilter;
import org.apache.ibatis.plugin.Interceptor;
import org.apache.ibatis.session.SqlSessionFactory;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.DependsOn;
import org.springframework.context.annotation.Primary;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import org.springframework.transaction.annotation.EnableTransactionManagement;

import javax.sql.DataSource;
import java.util.ArrayList;
import java.util.List;
import java.util.Properties;

@Configuration
@MapperScan(basePackages = {"com.test.*.mapper"})
@EnableTransactionManagement(proxyTargetClass = true)
public class MybatisConfiguration {

    @Autowired
    WallFilter wallFilter;

    @Bean
    @ConfigurationProperties("spring.datasource")
    @Primary
    public DataSource dataSource() {
        DruidDataSource datasource = new DruidDataSource();
        // filter
        List<Filter> filters = new ArrayList<>();
        filters.add(wallFilter);
        datasource.setProxyFilters(filters);
        return datasource;
    }

    /**
     * 修改阿里sql执行过滤器的初始配置
     * @param wallConfig
     * @return
     */
    @Bean(name = "wallFilter")
    @DependsOn("wallConfig")
    public WallFilter wallFilter(WallConfig wallConfig){
        WallFilter wallFilter = new WallFilter();
        wallFilter.setConfig(wallConfig);
        return wallFilter;
    }

    @Bean(name = "wallConfig")
    public WallConfig wallConfig(){
        WallConfig wallConfig = new WallConfig();
        //允许一次执行多条语句
        wallConfig.setMultiStatementAllow(true);
        //允许一次执行多条语句
        wallConfig.setNoneBaseStatementAllow(true);
        return wallConfig;
    }

    @Bean
    @Primary
    public DataSourceTransactionManager dataSourceTransactionManager() {
        DataSourceTransactionManager dataSourceTransactionManager = new DataSourceTransactionManager();
        dataSourceTransactionManager.setDataSource(dataSource());
        return dataSourceTransactionManager;
    }

    @Bean
    @Primary
    public SqlSessionFactory sqlSessionFactory() throws Exception {
        SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
        sessionFactory.setDataSource(dataSource());
        PagingPlugin pageHelper = new PagingPlugin();
        Properties properties = new Properties();
        properties.setProperty("reasonable", "true");
        properties.setProperty("supportMethodsArguments", "true");
        properties.setProperty("returnPageInfo", "check");
        properties.setProperty("params", "count=countSql");
        pageHelper.setProperties(properties);
        Interceptor[] plugins = new Interceptor[]{pageHelper};
        sessionFactory.setPlugins(plugins);
        sessionFactory.setMapperLocations(new PathMatchingResourcePatternResolver()
                .getResources("classpath:mapper/**/*.xml"));
        return sessionFactory.getObject();
    }
}

---

---

Sagger配置

在Application同级中新建Swagger2类，具体如下：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class Swagger2 {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                //为当前包路径
                .apis(RequestHandlerSelectors.basePackage("com.test"))
                .paths(PathSelectors.any())
                .build();
    }

    /**
     *  构建 api文档的详细信息函数,注意这里的注解引用的是哪个
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                //页面标题
                .title("小时功后台管理")
                .description("RestFul 接口文档")
                //服务条款网址
//                .termsOfServiceUrl("")
                .contact(new Contact("zy", "", ""))
                //版本号
                .version("1.0")
                //描述
                .build();
    }
}
 

---

---

springboot集成fastjson

 

控制层返回json处理

首先在项目Application类中继承WebMvcConfigurerAdapter

然后重写configureMessageConverters方法

这样就将springboot和fastJson集成了，可以在控制层通过注解（方法中添加@ResponseBody或类中将@Controller更改为@RestController）返回对象，让springboot自动处理为json。

---

---

springboot打包

在Application同级中新建TestApp,具体如下：

import org.springframework.boot.builder.SpringApplicationBuilder;

public class TestApp extends org.springframework.boot.web.support.SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(FunctionAppuserApplication.class);
    }

}

然后就可以使用maven的package进行打包

---

---

好了，根据上述可以进行springboot的项目的畅游！谢谢大家！