SpringBoot Mybatis 集成
一個簡單的SpringBoot項目，用到了一些自己常用的技術。
數據庫連接池為HiKariCP
Mybatis集成了通用Mapper和PageHelper
Lombok
一、用Gradle構建項目，并在IDEA中打開
如下為build.gradle文件內容：
buildscript {
repositories {
mavenLocal()
maven { url 'https://plugins.gradle.org/m2/' } // 用于下載Gradle插件
maven { url 'http://jcenter.bintray.com/' }
maven { url 'http://repo1.maven.org/maven2/' }
maven { url 'http://repo.spring.io/snapshot' }
maven { url 'http://repo.spring.io/milestone' }
maven { url 'http://repo.spring.io/libs-milestone/' }
maven { url 'http://repo.spring.io/release' }
}
dependencies {
classpath 'org.springframework.boot:spring-boot-gradle-plugin:1.5.2.RELEASE' // org.springframework.boot的構建版本控制
classpath 'io.spring.gradle:dependency-management-plugin:1.0.1.RELEASE' // 用于管理jar包之間的依賴問題
}
}
apply plugin: 'java' // java插件，同時也聲明是一個java項目
apply plugin: 'idea' // idea插件，可直接讓IDEA集成能力
apply plugin: 'org.springframework.boot' // 管理這個組織的jar包插件
apply plugin: 'io.spring.dependency-management' // 管理jar包之間的依賴關系
idea {
module {
inheritOutputDirs = false
outputDir = file("$buildDir/classes/main/") // 在idea中build后輸出的class目錄
}
}
jar {
baseName = 'springboot'
version = new Date().format("yyyy-MM-dd_HH:mm").toString() // 根據當前時間控制版本
// e.g. Gradle是基于Groovy的構建語言，本身也是JVM語言
}
bootRun {
addResources = false
systemProperties = System.properties
main = 'com.avcdata.Application' // 程序運行的主文件，每個項目需指定一個運行入口
}
repositories {
mavenLocal()
maven { url 'http://jcenter.bintray.com/' }
maven { url 'http://repo1.maven.org/maven2/' }
maven { url 'http://repo.spring.io/snapshot' }
maven { url 'http://repo.spring.io/libs-milestone/' }
maven { url 'http://repo.spring.io/release' }
maven { url 'http://repo.spring.io/milestone' }
}
dependencies {
compile 'com.zaxxer:HikariCP:2.6.1'
compile 'org.projectlombok:lombok:1.16.12'
compile 'mysql:mysql-connector-java:6.0.5'
compile 'org.springframework.boot:spring-boot-starter-web'
compile 'org.mybatis.spring.boot:mybatis-spring-boot-starter:1.2.0'
compile 'tk.mybatis:mapper-spring-boot-starter:1.0.0'
compile 'com.github.pagehelper:pagehelper-spring-boot-starter:1.1.0'
testCompile ( 'org.springframework.boot:spring-boot-starter-test' )
}
二、在項目中集成一些工作
①引入通用mapper，在指定位置。
如圖所示：在com.avcdata.util下
其中MyMapper的源代碼為：
package com.avcdata.util;/*
* The MIT License (MIT)
*
* Copyright (c) 2014-2016 abel533@gmail.com
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
import tk.mybatis.mapper.common.Mapper;
import tk.mybatis.mapper.common.MySqlMapper;
/**
* 繼承自己的MyMapper
*
* @author liuzh
* @since 2015-09-06 21:53
*/
public interface MyMapper<T> extends Mapper<T>, MySqlMapper<T> {
//TODO
//FIXME 特別注意，該接口不能被掃描到，否則會出錯
}
②在resources下創建一個mapper目錄
image.png
③書寫application.yml文件
spring:
datasource:
url: jdbc:mysql://192.168.2.200/jdbc_db?useUnicode=true&characterEncoding=utf-8&useSSL=false
type: com.zaxxer.hikari.HikariDataSource
driver-class-name: com.mysql.cj.jdbc.Driver
hikari:
username: root
password: new.1234
max-lifetime: 1765000
maximum-pool-size: 15
minimum-idle: 2
connection-timeout: 1765000
mybatis:
type-aliases-package: com.avcdata.model # 配置Bean對應的別名目錄
mapper-locations: classpath:mapper/*.xml # 配置mapper對應目錄
configuration:
call-setters-on-nulls: true # 為null不清除
map-underscore-to-camel-case: true #開啟駝峰命名
mapper:
#通用Mapper目錄
mappers:
- com.avcdata.util.MyMapper # 配置MyMapper目錄
not-empty: false
identity: MYSQL
pagehelper:
helperDialect: mysql
reasonable: true
supportMethodsArguments: true
params: count=countSql
logging:
# 日志打印級別配置
config: classpath:logback.xml
三、初始化業務相關的Dao層
①、根據表結構，去建立一個Bean
user表
此為一張表，其中表名為user，id為主鍵，username和password為兩個字段。所對應的Bean放在com.avcdata.model下，Bean名為User
package com.avcdata.model;
import lombok.*;
import org.apache.ibatis.type.Alias;
import javax.persistence.Column;
import javax.persistence.Id;
import javax.persistence.Table;
/**
*
* Created by huangcheng on 2017/3/24.
*/
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Alias(value = "user")
@Table(name = "user")
public class User {
@Id
private Integer id;
@Column(name = "username")
private String username; // 因為開啟了駝峰命名，所以password不需要@column
private String password;
}
②創建對應的UserMapper
1、在com.avcdata.mapper下創建一個UserMapper
UserMapper繼承MyMapper<User>
代碼如下:
package com.avcdata.dao;
import com.avcdata.model.User;
import com.avcdata.util.MyMapper;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;
/**
*
* Created by huangcheng on 2017/3/24.
*/
//繼承了通用MyMapper，則可以根據Bean實現簡單的增刪改查
@Mapper
public interface UserMapper extends MyMapper<User> {
List<User> query(String s);
}
2、在resources中創建一個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.avcdata.dao.UserMapper">
<select id="query" parameterType="java.lang.String"
resultType="user">
SELECT
username ,
password
FROM user
</select>
</mapper>
至此，實現了Dao層。
四、簡單實現Controller和Service
①、初始化一個Service命名為UserService
源代碼如下：
package com.avcdata.service;
import com.avcdata.dao.UserMapper;
import com.avcdata.model.PageInfoParam;
import com.avcdata.model.User;
import com.github.pagehelper.PageHelper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
/**
*
* Created by huangcheng on 2017/3/24.
*/
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public List<User> query(PageInfoParam pageInfoParam){
PageHelper.startPage(pageInfoParam.getPageSize(), pageInfoParam.getCurrentPage());
return userMapper.selectAll();
}
}
②、初始化一個Controller，命名為：UserController
源代碼如下：
package com.avcdata.controller;
import com.avcdata.model.PageInfoParam;
import com.avcdata.model.User;
import com.avcdata.service.UserService;
import com.github.pagehelper.PageInfo;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
/**
*
* Created by huangcheng on 2017/3/24.
*/
@RestController
@RequestMapping(value = "/user")
@Slf4j
public class UserController {
@Autowired
UserService userService;
@RequestMapping(value = "/query", method = RequestMethod.POST)
public PageInfo<User> query(@RequestBody PageInfoParam pageInfoParam){
log.info("currentPage:{}, pageSize:{}", pageInfoParam.getCurrentPage(), pageInfoParam.getPageSize());
return new PageInfo<>(userService.query(pageInfoParam));
}
}
五、啟動服務并測試
①、啟動服務
②、用postman發送請求
其中pageSize為每頁數量，currentPage為當前頁
請求相關參數
返回得到相對應的ResponseBody，攜帶了分頁信息的全部查詢:
{
"pageNum": 0,
"pageSize": 0,
"size": 1,
"startRow": 1,
"endRow": 1,
"total": 1,
"pages": 0,
"list": [
{
"id": 1,
"username": "hc",
"password": "1234"
}
],
"prePage": 0,
"nextPage": 0,
"isFirstPage": false,
"isLastPage": true,
"hasPreviousPage": false,
"hasNextPage": false,
"navigatePages": 8,
"navigatepageNums": [],
"navigateFirstPage": 0,
"navigateLastPage": 0,
"firstPage": 0,
"lastPage": 0
}
