Spring Boot

一、多环境配置方法

在项目开发、测试、生产中，一些参数不尽相同，比如log级别、数据库连接参数等，每次切换环境都要修改参数，参数多了容易出错，而且不利于通过命令行等设置参数方式切换环境。为了方便环境的切换，可以通过profile来实现，springboot中多环境配置文件名需要满足application-{profile}.properties的格式，其中{profile}对应你的环境标识，比如：

• application-dev.properties：开发环境
• application-test.properties：测试环境
• application-prod.properties：生产环境

多个配置文件，springboot究竟用哪个取决于application.properties配置文件中spring.profiles.action属性，该属性的值是对应的{profiles}的值。如spring.profiles.action=dev时，会加载配置文件application-dev.properties。

二、默认日志logback

1、简述

Spring Boot内部日志系统使用的是Commons Logging，但开发底层的日志实现。默认会为java Util Logging，Log4j，Log4j2和logback提供配置。

Spring Boot 集成logback需要添加spring-boot-starter-logging依赖，而此依赖已经在spring-boot-starter中添加过了，所以不用再添加此依赖了(如下图)

默认情况下，springboot会用Logback来记录日志，并用INFO级别输出控制台。

2、日志格式

2014-03-05 10:57:51.112  INFO 45469 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet Engine: Apache Tomcat/7.0.52
2014-03-05 10:57:51.253  INFO 45469 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2014-03-05 10:57:51.253  INFO 45469 --- [ost-startStop-1] o.s.web.context.ContextLoader            : Root WebApplicationContext: initialization completed in 1358 ms
2014-03-05 10:57:51.698  INFO 45469 --- [ost-startStop-1] o.s.b.c.e.ServletRegistrationBean        : Mapping servlet: 'dispatcherServlet' to [/]
2014-03-05 10:57:51.702  INFO 45469 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean  : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]

输出元素内容如下：

• 时间日期：精确到毫秒，可以轻松排序
• 日志级别：ERROR、WARN、INFO、DEBUG、TRACE
• 进程ID
• 分隔符：一标识实际日志开始
• 线程名：方括号，括起来
• Logger名：通常使用源代码的类名
• 日志内容
  注：Logback没有FATAL级别。它被映射到ERROR级别。

3、自定义日志配置

由于日志服务一般都在ApplicationContext创建前就初始化了，它并不是必须通过Spring的配置文件控制。因此通过系统属性和传统的Spring Boot外部配置文件依然可以很好的支持日志控制和管理。

根据不同的日志系统，你可以按如下规则组织配置文件名，就能被正确加载：

日志	规则
logback	logback-spring.xml, logback-spring.groovy, logback.xml, 或者 logback.groovy
log4j	log4j-spring.properties, log4j-spring.xml, log4j.properties, log4j.xml
log4j2	log4j2-spring.xml 或者 log4j2.xml
JDK (Java Util Logging)	logging.properties

SpringBoot官方建议你使用-spring的文件名进行日志配置（例如，logback-spring.xml而不是logback.xml）

自定义配置文件参考：
logback-spring.xml

<?xml version="1.0" encoding="UTF-8"?>
<configuration  scan="true" scanPeriod="60 seconds" debug="false">
    <contextName>demo</contextName>
    <property name="log.path" value="/Users/mengday/Documents/logs" />
    <property name="log.name" value="demo" />

    <!--输出到控制台-->
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <!-- <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
             <level>ERROR</level>
         </filter>-->
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} %contextName [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!--输出到文件-->
    <appender name="file" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${log.path}/${log.name}.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxFileSize>1MB</maxFileSize>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} %contextName [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="INFO">
        <appender-ref ref="console" />
        <appender-ref ref="file" />
    </root>

    <logger name="com.example.demo.mapper" level="DEBUG" additivity="false">
        <appender-ref ref="console" />
    </logger>

    <!-- 测试环境+开发环境. -->
    <springProfile name="test,dev">
        <logger name="com.example.demo" level="INFO" />
    </springProfile>
    <!-- 生产环境 -->
    <springProfile name="prod">
        <logger name="com.example.demo" level="ERROR"/>
    </springProfile>
</configuration>

三、集成mybatis

1、前置条件

先创建好一个最简单的spring boot项目，可参考之前章节的源代码或直接自己创建一个。

2、创建数据库

create database springboot;

创建用户表tbl_user并插入测试数据

CREATE TABLE `tbl_user`(
	`user_id` bigint(20) NOT NULL,
	`user_name` varchar(50) DEFAULT NULL,
	`user_age` int(11) DEFAULT NULL,
	PRIMARY KEY(`user_id`)
)ENGINE=InnoDB DEFAULT CHARSET=utf8;

INSERT INTO tbl_user VALUES(1,'小明',27);
INSERT INTO tbl_user VALUES(2,'小赵',19);
INSERT INTO tbl_user VALUES(3,'小东',20);

脚本sql在源码的db文件夹中。

3、引入mybatis依赖

<!-- mybatis -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.3.2</version>
</dependency>

<!-- mysql -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

4、编写代码

1、创建实体

/**
 * @Description
 * @Author sgl
 * @Date 2018-05-02 14:59
 */
 @Data
public class User {
    private Long userId;
    private String userName;
    private Integer userAge;
}

2、创建Mapper文件

在resources文件夹下创建mapper文件夹，然后在mapper文件夹里创建UserMapper.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.songguoliang.mybatis.mapper.UserMapper">

    <select id="getUsers" resultType="User">
        SELECT * FROM tbl_user
    </select>
</mapper>

3、创建Mapper(Dao)接口

package com.songguoliang.mybatis.mapper;

import com.songguoliang.mybatis.entity.User;

import java.util.List;

/**
 * @Description
 * @Author sgl
 * @Date 2018-05-02 15:02
 */
public interface UserMapper {

    List<User> getUsers();
}

4、创建Service

package com.songguoliang.mybatis.service;

import com.songguoliang.mybatis.entity.User;
import com.songguoliang.mybatis.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * @Description
 * @Author sgl
 * @Date 2018-05-02 15:01
 */
@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    public List<User> getUsers() {
        return userMapper.getUsers();
    }
}

5、创建controller

package com.songguoliang.mybatis.controller;

import com.songguoliang.mybatis.entity.User;
import com.songguoliang.mybatis.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

/**
 * @Description
 * @Author sgl
 * @Date 2018-05-02 14:59
 */
@RestController
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/users")
    public List<User> lists() {
        return userService.getUsers();
    }

}

5、配置mybatis

1、配置数据源
在application.properties配置文件中添加如下代码：

## 数据源配置
spring.datasource.url=jdbc:mysql://localhost:3306/springboot?useUnicode=true&characterEncoding=utf-8&useSSL=false
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

2、添加mybatis配置
在application.properties配置文件中添加mybatis的配置，如下代码：

# mybatis
mybatis.type-aliases-package=com.songguoliang.mybatis.entity
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.configuration.map-underscore-to-camel-case=true

• mybatis.type-aliases-package：别名类(实体类)所在包
• mybatis.mapper-locations：mapper文件所在文件夹
• mybatis.configuration.map-underscore-to-camel-case：采用驼峰命名方式转换

3、扫描Mapper接口
在启动类上添加注解@MapperScan("com.songguoliang.mybatis.mapper")，注意MapperScan的包路径(org.mybatis.spring.annotation.MapperScan)，后面章节和Mapper4集成时会修改导入的包。

package com.songguoliang.mybatis;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @Description
 * @Author sgl
 * @Date 2018-05-02 14:51
 */
@SpringBootApplication
@MapperScan("com.songguoliang.mybatis.mapper")
public class MybatisApplication {
    public static void main(String[] args) {
        SpringApplication.run(MybatisApplication.class, args);
    }
}

六、测试
启动服务，浏览器输入http://localhost:8080/users,可看到如下内容：