6.1 Spring Boot集成mybatis
在SpringBoot集成MyBatis时，我们将去掉和Mybatis配置相关的xml文件配置方式，用注解和属性配置来代替这些繁杂的配置。
本节我们使用SpringBoot集成Mybatis开发一个简易的H5性能测试的Web后台。我们采用Java，Groovy混合编程的方式。
新建gradle工程
组织工程目录结构如下
.
├── build.gradle
├── settings.gradle
└── src
├── main
│ ├── groovy
│ ├── java
│ └── resources
│ └── application.yml
└── test
├── groovy
├── java
└── resources
9 directories, 3 files
配置build.gradle
添加mybatis-spring-boot-starter依赖
compile('org.mybatis.spring.boot:mybatis-spring-boot-starter:1.1.1')
该starter将会自动配置好Spring Boot集成mybatis需要的mybatis,mybatis-spring等所有依赖。这个starter的依赖树如下图所示：
其中，mybatis-spring-boot-autoconfigure会完成我们之前使用xml配置mybatis使用的sqlmap-config.xml类似如下配置：
和data-source.xml文件配置数据源dataSource和TransactionManager，
com.mysql.jdbc.Driver
jdbc:mysql://127.0.0.1:3306/h5perf?useUnicode=true&autoReconnect=true&characterEncoding=UTF8&zeroDateTimeBehavior=convertToNull
root
root
配置application.yml
配置数据源
spring:
datasource:
name: h5perf
url: jdbc:mysql://localhost:3306/h5perf?autoReconnect=true&useSSL=false
username: root
password: root
# 使用druid数据源
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: com.mysql.cj.jdbc.Driver
配置mybatis
mybatis:
type-aliases-package: com.easy.springboot.h5perf.model
configuration:
# 开启mybatis开启数据库字段自动映射驼峰命名规则java属性
map-underscore-to-camel-case: true
default-fetch-size: 100
default-statement-timeout: 30
数据库表结构
CREATE DATABASE IF NOT EXISTS `h5perf`
DEFAULT CHARACTER SET utf8;
USE `h5perf`;
DROP TABLE IF EXISTS `test_case`;
CREATE TABLE `test_case` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`container_type` VARCHAR(45) DEFAULT NULL
COMMENT '‘ORIGIN_WEBVIEW’,’UC_WEBVIEW’',
`test_url` VARCHAR(45) DEFAULT NULL,
`net_type` VARCHAR(45) DEFAULT NULL
COMMENT '‘WIFI’,‘3G’,‘4G’',
`gmt_created` DATETIME DEFAULT NULL,
`gmt_modified` DATETIME DEFAULT NULL,
PRIMARY KEY (`id`)
)
ENGINE = InnoDB
DEFAULT CHARSET = utf8;
DROP TABLE IF EXISTS `test_resource`;
CREATE TABLE `test_resource` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`test_case_id` INT(11) DEFAULT NULL,
`start_time` BIGINT(11) DEFAULT NULL,
`resource_url` VARCHAR(500) DEFAULT NULL,
`resource_type` VARCHAR(45) DEFAULT NULL
COMMENT 'IMG,JS,CSS,OTHER',
`resource_time` BIGINT(11) DEFAULT NULL
COMMENT 'onLoadResource资源时间戳',
`resource_size` BIGINT(11) DEFAULT NULL
COMMENT '资源大小',
`gmt_created` DATETIME DEFAULT NULL,
PRIMARY KEY (`id`)
)
ENGINE = InnoDB
DEFAULT CHARSET = utf8;
DROP TABLE IF EXISTS `test_time_data`;
CREATE TABLE `test_time_data` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`test_case_id` INT(11) DEFAULT NULL,
`on_recieve_title` VARCHAR(45) DEFAULT NULL
COMMENT '近似白屏时间',
`on_page_finished` VARCHAR(45) DEFAULT NULL
COMMENT '页面加载完成时间',
`dom_content_load` VARCHAR(45) DEFAULT NULL
COMMENT 'dom内容加载完成时间',
`load` VARCHAR(45) DEFAULT NULL
COMMENT '资源加载完成时间',
`gmt_created` DATETIME DEFAULT NULL,
PRIMARY KEY (`id`)
)
ENGINE = InnoDB
DEFAULT CHARSET = utf8;
Model层代码
我们在application.yml中开启了mybatis开启数据库字段自动映射驼峰命名规则java属性：
map-underscore-to-camel-case: true
所以，我们model类的属性命名规则按照驼峰命名规则。
TestCase.groovy代码：
package com.easy.springboot.h5perf.model
/**
* Created by jack on 2017/4/22.
*/
class TestCase {
Integer id
String containerType
String testUrl
String netType
Date gmtCreated
Date gmtModified
@Override
String toString() {
return "TestCase{" +
"id=" + id +
", containerType='" + containerType + '\'' +
", testUrl='" + testUrl + '\'' +
", netType='" + netType + '\'' +
", gmtCreated=" + gmtCreated +
", gmtModified=" + gmtModified +
'}';
}
}
Mapper接口层代码
我们以往的通过xml配置显式指定Mapper文件位置:
我们现在用注解方式，直接在接口上添加@Mapper注解即可。代码示例TestCaseMapper.groovy
package com.easy.springboot.h5perf.mapper
import com.easy.springboot.h5perf.model.TestCase
import org.apache.ibatis.annotations.Insert
import org.apache.ibatis.annotations.Mapper
import org.apache.ibatis.annotations.Options
import org.apache.ibatis.annotations.Param
import org.apache.ibatis.annotations.Select
@Mapper
interface TestCaseMapper {
@Insert([
"insert into test_case",
"set container_type = #{t.containerType},",
"test_url = #{t.testUrl},",
"net_type = #{t.netType},",
"gmt_created = #{t.gmtCreated},",
"gmt_modified = #{t.gmtModified}"
])
@Options(useGeneratedKeys = true, keyProperty = "t.id")
int insert(@Param("t") TestCase testCase)
@Select("select * from test_case")
List findAll()
@Select("select * from test_case where net_type=#{netType}")
List findByNetType(@Param(value="netType")String netType)
@Select("select * from test_case where id=#{id} limit 1")
TestCase findOne(@Param(value="id")Integer id)
int insertSelective(TestCase record)
}
Controller层代码
package com.easy.springboot.h5perf.controller
import com.easy.springboot.h5perf.model.TestCase
import com.easy.springboot.h5perf.result.Result
import com.easy.springboot.h5perf.service.TestCaseService
import com.github.pagehelper.PageInfo
import groovy.json.JsonOutput
import io.swagger.annotations.Api
import io.swagger.annotations.ApiImplicitParam
import io.swagger.annotations.ApiOperation
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.stereotype.Controller
import org.springframework.ui.Model
import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.PostMapping
import org.springframework.web.bind.annotation.RequestParam
import org.springframework.web.bind.annotation.ResponseBody
/**
* Created by jack on 2017/4/22.
* http://springfox.github.io/springfox/docs/current/#springfox-samples
*/
//在Controller上使用@Api会生成这个Controller的整体描述
@Api(value = "测试任务管理", tags = ["测试任务管理API"], description = "描述信息")
@Controller
class TestCaseController {
@Autowired
TestCaseService testCaseService
@PostMapping("/saveTestCase")
@ResponseBody
def saveTestCase(TestCase testCase) {
testCase.gmtCreated = new Date()
println("testCase===" + testCase)
int insert = testCaseService.save(testCase)
println("testCase===" + testCase)
Result result = new Result()
if (insert == 1) {
result.success = true
result.result = testCase
} else {
result.success = false
result.result = testCase
}
def jsonOutput = new JsonOutput()
println("saveTestCase result===" + jsonOutput.toJson(result))
result
}
@GetMapping("/listTestCase")
def listTestCase(Model model,
@RequestParam(value = "pageNo", required = false) Integer pageNo,
@RequestParam(value = "pageSize", required = false) Integer pageSize) {
def pageInfo = testCaseService.findAll(pageNo, pageSize)
model.addAttribute("testCaseList", pageInfo.list)
model.addAttribute("pageNo", pageInfo.pageNum)
model.addAttribute("totalPage", pageInfo.pages)
model.addAttribute("prePage", pageInfo.prePage)
model.addAttribute("nextPage", pageInfo.nextPage)
model.addAttribute("hasPreviousPage", pageInfo.hasPreviousPage)
model.addAttribute("hasNextPage", pageInfo.hasNextPage)
"/test_case/list"
}
// 在具体方法上使用@ApiOperation可以生成接口的描述
@ApiOperation(value = "list all TestCase Json", notes = "listTestCaseJson", produces = "application/json")
@GetMapping("/listTestCaseJson")
@ResponseBody
def listTestCaseJson(@RequestParam(value = "pageNo", required = false) Integer pageNo,
@RequestParam(value = "pageSize", required = false) Integer pageSize) {
testCaseService.findAll(pageNo, pageSize)
}
@ApiOperation(value = "findOne TestCase Json", notes = "findOne TestCase", produces = "application/json")
// 在方法上使用@ApiImplicitParam可以增加对参数等的描述
@ApiImplicitParam(name = "id",
value = "测试任务ID",
dataType = "Integer",//This can be the class name or a primitive
required = true,
paramType = "query")
//Valid values are {@code path}, {@code query}, {@code body}, {@code header} or {@code form}
@GetMapping("/findOne")
@ResponseBody
def findOne(@RequestParam(value = "id", required = true) Integer id) {
testCaseService.findOne(id)
}
@ApiOperation(value = "findByNetType TestCase Json", notes = "findByNetType TestCase", produces = "application/json")
// 在方法上使用@ApiImplicitParam可以增加对参数等的描述
@ApiImplicitParam(name = "netType",
value = "findByNetType",
dataType = "String",//This can be the class name or a primitive
required = true,
paramType = "query")
@GetMapping("/findByNetType")
@ResponseBody
def findByNetType(@RequestParam(value = "netType", required = false) String netType,
@RequestParam(value = "pageNo", required = false) Integer pageNo,
@RequestParam(value = "pageSize", required = false) Integer pageSize
) {
testCaseService.queryByPage(netType, pageNo, pageSize)
}
}
使用PageHelper实现后端分页
（1）添加pagehelper-spring-boot-starter
// pagehelper
compile('com.github.pagehelper:pagehelper-spring-boot-starter:1.1.0')
（2）Service层代码实现
接口类 TestCaseService.groovy
package com.easy.springboot.h5perf.service
import com.easy.springboot.h5perf.model.TestCase
import com.github.pagehelper.PageInfo
/**
* Created by jack on 2017/4/23.
*/
interface TestCaseService {
def save(TestCase testCase)
PageInfo findAll(Integer pageNo, Integer pageSize)
TestCase findOne(Integer id)
PageInfo queryByPage(String netType, Integer pageNo, Integer pageSize)
}
实现类TestCaseServiceImpl.groovy
package com.easy.springboot.h5perf.service
import com.easy.springboot.h5perf.mapper.TestCaseMapper
import com.easy.springboot.h5perf.model.TestCase
import com.github.pagehelper.PageHelper
import com.github.pagehelper.PageInfo
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.stereotype.Service
/**
* Created by jack on 2017/4/23.
*/
@Service
class TestCaseServiceImpl implements TestCaseService {
@Autowired
TestCaseMapper testCaseMapper;
@Override
def save(TestCase testCase) {
testCaseMapper.insert(testCase)
}
@Override
PageInfo findAll(Integer pageNo, Integer pageSize) {
pageNo = pageNo == null ? 1 : pageNo
pageSize = pageSize == null ? 10 : pageSize
PageHelper.startPage(pageNo, pageSize)
List testCaseList = testCaseMapper.findAll()
//用PageInfo对结果进行包装
PageInfo testCasePageInfo = new PageInfo<>(testCaseList)
testCasePageInfo
}
@Override
TestCase findOne(Integer id) {
testCaseMapper.findOne(id)
}
@Override
PageInfo queryByPage(String netType, Integer pageNo, Integer pageSize) {
pageNo = pageNo == null ? 1 : pageNo
pageSize = pageSize == null ? 10 : pageSize
PageHelper.startPage(pageNo, pageSize)
List testCaseList = testCaseMapper.findByNetType(netType)
//用PageInfo对结果进行包装
PageInfo testCasePageInfo = new PageInfo<>(testCaseList)
testCasePageInfo
}
}
（3）Controller层与前端代码集成
传到前端的Model层数据：
@GetMapping("/listTestCase")
def listTestCase(Model model,
@RequestParam(value = "pageNo", required = false) Integer pageNo,
@RequestParam(value = "pageSize", required = false) Integer pageSize) {
def pageInfo = testCaseService.findAll(pageNo, pageSize)
model.addAttribute("testCaseList", pageInfo.list)
model.addAttribute("pageNo", pageInfo.pageNum)
model.addAttribute("totalPage", pageInfo.pages)
model.addAttribute("prePage", pageInfo.prePage)
model.addAttribute("nextPage", pageInfo.nextPage)
model.addAttribute("hasPreviousPage", pageInfo.hasPreviousPage)
model.addAttribute("hasNextPage", pageInfo.hasNextPage)
"/test_case/list"
}
前端使用Bootstrap pagination样式类：
Id
testUrl
containerType
netType
gmtCreated
<#list testCaseList as tc >
${tc.id}
${tc.testUrl}
${tc.containerType}
${tc.netType}
${tc.gmtCreated?string('yyyy/MM/dd HH:mm:ss')}
（4）运行测试
第1页
第2页
另外，我们还可以集成Druid对数据库进行监控。相关的资料可以去网上搜索学习。本章节不再赘述。
本节完整的工程源代码：https://github.com/EasySpringBoot/h5perf