Spring-boot+Mybatis+Maven+MySql搭建實例

轉自：https://www.jianshu.com/p/95fb7be049ae

最近讀了spring-boot開發手冊，spring-boot相比於spring-mvc封裝了很多常用的依賴，並且內置了tomcat容器，啟動生成的jar包即可啟動項目，也是目前流行的微服務常用框架。本文主要用到了spring-boot，以及mybatis，數據庫用到了mysql。
源碼下載

准備工作

1.首先創建一個表：

CREATE TABLE `t_user` (  
  `USER_ID` int(11) NOT NULL AUTO_INCREMENT, `USER_NAME` char(30) NOT NULL, `USER_PASSWORD` char(10) NOT NULL, `USER_EMAIL` char(30) NOT NULL, PRIMARY KEY (`USER_ID`), KEY `IDX_NAME` (`USER_NAME`) ) ENGINE=InnoDB AUTO_INCREMENT=11 DEFAULT CHARSET=utf8 

插入一些數據：

INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (1, '林炳文', '1234567@', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (2, 'evan', '123', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (3, 'kaka', 'cadg', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (4, 'simle', 'cscs', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (5, 'arthur', 'csas', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (6, '小德', 'yuh78', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (7, '小小', 'cvff', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (8, '林林之家', 'gvv', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (9, '林炳文Evankaka', 'dfsc', '[e-mail]'); INSERT INTO t_user (USER_ID, USER_NAME, USER_PASSWORD, USER_EMAIL) VALUES (10, 'apple', 'uih6', '[e-mail]'); 

創建工程

我習慣於先創建好maven項目，構建目錄再導入到編譯器中，這樣的好處就是搭建好一個腳手架模板，后面改改參數就可以用到各個工程里面。

構建pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.boot</groupId> <artifactId>testSpringBoot</artifactId> <version>0.0.1-SNAPSHOT</version> <name>testSpringBoot</name> <packaging>jar</packaging> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.9.RELEASE</version> <relativePath/> </parent> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- mybatis依賴 --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.3.1</version> </dependency> <!-- 引入thymelaf 則不需要引入web依賴，若不需要thymelaf則需要添加spring-boot-starter-web --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> <!-- mysql依賴 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> </dependency> </dependencies> <build> <plugins> <!-- 要使生成的jar可運行，需要加入此插件 --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project> 

工程目錄

創建的文件目錄如圖：

 

工程目錄

啟動器以及controller

（1） 啟動器
在com.boot(即最外層目錄文件)下寫一個如下main方法:

package com.boot; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class Application { public static void main(String[] args) throws Exception { SpringApplication.run(Application.class, args); } } 

（2）controller
在com.boot.web下創建一個類如下:

package com.boot.web; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class MainController { @RequestMapping(value = "/") String home() { return "Hello World!"; } } 

（3）啟動項目
找到com.boot下的Application以java Application方式啟動，然后打開瀏覽器輸入localhost:8080就會出現Hello World!

 

啟動頁面

 

添加java代碼

（1）User.java
對應數據庫中表的字段，放在src/main/java下的包com.boot.domain

package com.boot.domain; public class User { private Integer userId; private String userName; private String userPassword; private String userEmail; public Integer getUserId() { return userId; } public void setUserId(Integer userId) { this.userId = userId; } public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public String getUserPassword() { return userPassword; } public void setUserPassword(String userPassword) { this.userPassword = userPassword; } public String getUserEmail() { return userEmail; } public void setUserEmail(String userEmail) { this.userEmail = userEmail; } @Override public String toString() { return "User [userId=" + userId + ", userName=" + userName + ", userPassword=" + userPassword + ", userEmail=" + userEmail + "]"; } } 

（2）UserDao.java
Dao接口類，用來對應mapper文件。放在src/main/java下的包com.lin.dao,內容如下：

package com.boot.dao; import org.apache.ibatis.annotations.Mapper; import com.boot.domain.User; @Mapper public interface UserDao { public User selectUserById(Integer userId); } 

（3）UserService.java和UserServiceImpl.java
service接口類和實現類，放在src/main/java下的包com.lin.service,內容如下：

UserService.java

package com.boot.service; import com.boot.domain.User; public interface UserService { User selectUserById(Integer userId); } 

UserServiceImpl.java

package com.boot.service.impl; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import com.boot.dao.UserDao; import com.boot.domain.User; import com.boot.service.UserService; @Service public class UserServiceImpl implements UserService{ @Autowired private UserDao userDao; @Override public User selectUserById(Integer userId) { return userDao.selectUserById(userId); } } 

（4）mapper文件
用來和dao文件對應，放在src/main/resources中的com/boot/mapper目錄下

 

UserMapper.xml路徑

 

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.boot.dao.UserDao"> <!--設置domain類和數據庫中表的字段一一對應，注意數據庫字段和domain類中的字段名稱不致，此處一定要！--> <resultMap id="BaseResultMap" type="com.boot.domain.User"> <id column="USER_ID" property="userId" jdbcType="INTEGER" /> <result column="USER_NAME" property="userName" jdbcType="CHAR" /> <result column="USER_PASSWORD" property="userPassword" jdbcType="CHAR" /> <result column="USER_EMAIL" property="userEmail" jdbcType="CHAR" /> </resultMap> <!-- 查詢單條記錄 --> <select id="selectUserById" parameterType="int" resultMap="BaseResultMap"> SELECT * FROM t_user WHERE USER_ID = #{userId} </select> </mapper> 

資源配置

下列所有文件均在src/main/resources目錄下
（1）spring-boot配置
不少人都Properties資源文件來配置，不過這種文件在eclipse編碼的默認設置是ISO-8859-1，需要修改eclipse的設置才能顯示中文。因此我比較喜歡用yml文件來配置，一個是結構明顯，另外一個不用考慮編碼的問題。

application.yml

spring: thymeleaf: mode: HTML5 encoding: UTF-8 content-type: text/html # 開發禁用緩存 cache: false datasource: url: jdbc:mysql://localhost:3306/ssmDb?characterEncoding=UTF-8&useSSL=true username: root password: password # 可省略驅動配置, sprin-boot 會由url檢測出驅動類型 # driver-class-name: com.mysql.jdbc.Driver hikari: connection-timeout: 60000 mybatis: mapperLocations: classpath:com/boot/mapper/*.xml typeAliasesPackage: cn.boot.domain # spring-boot默認打印輸出info級別以上的，可在此處修改輸出級別 logging: level: root: info 

（2）日志打印logback-spring.xml

<?xml version="1.0" encoding="UTF-8"?> <configuration> <!-- 控制台輸出 --> <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender"> <encoder> <pattern>%date [%thread] %-5level %logger{80} - %msg%n</pattern> </encoder> </appender> <!-- 時間滾動輸出 level為 INFO 日志 --> <appender name="file-info" class="ch.qos.logback.core.rolling.RollingFileAppender"> <filter class="ch.qos.logback.classic.filter.LevelFilter"> <level>INFO</level> <onMatch>ACCEPT</onMatch> <onMismatch>DENY </onMismatch> </filter> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <FileNamePattern>./logs/info.%d{yyyy-MM-dd}.log</FileNamePattern> <MaxHistory>30</MaxHistory> </rollingPolicy> <encoder> <pattern>%date [%thread] %-5level %logger{80} - %msg%n</pattern> </encoder> </appender> <!-- 時間滾動輸出 level為 DEBUG 日志 --> <appender name="file-debug" class="ch.qos.logback.core.rolling.RollingFileAppender"> <filter class="ch.qos.logback.classic.filter.LevelFilter"> <level>DEBUG</level> <onMatch>ACCEPT</onMatch> <onMismatch>DENY </onMismatch> </filter> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <FileNamePattern>./logs/debug.%d{yyyy-MM-dd}.log</FileNamePattern> <MaxHistory>30</MaxHistory> </rollingPolicy> <encoder> <pattern>%date [%thread] %-5level %logger{80} - %msg%n</pattern> </encoder> </appender> <!-- 時間滾動輸出 level為 ERROR 日志 --> <appender name="file—error" class="ch.qos.logback.core.rolling.RollingFileAppender"> <filter class="ch.qos.logback.classic.filter.LevelFilter"> <level>ERROR</level> <onMatch>ACCEPT</onMatch> <onMismatch>DENY </onMismatch> </filter> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <FileNamePattern>./logs/error.%d{yyyy-MM-dd}.log</FileNamePattern> <MaxHistory>30</MaxHistory> </rollingPolicy> <encoder> <pattern>%date [%thread] %-5level %logger{80} - %msg%n</pattern> </encoder> </appender> <logger name="org.apache.ibatis" level="INFO"/> <logger name="java.sql.Connection" level="debug" /> <logger name="java.sql.Statement" level="debug" /> <logger name="java.sql.PreparedStatement" level="debug" /> <root level="info"> <appender-ref ref="stdout" /> <appender-ref ref="file-info" /> </root> </configuration> 

單元測試

spring-boot單元測試只需引入spring-boot-starter-test即可，里面集成了Junit以及Spring Test & Spring Boot Test等依賴。

 

測試類目錄

（1）測試基類

package com.boot.baseTest; import org.junit.runner.RunWith; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; @RunWith(SpringJUnit4ClassRunner.class) @SpringBootTest public abstract class SpringTestCase { Logger logger = LoggerFactory.getLogger(this.getClass()); } 

（2）測試類

package com.boot.serviceTest; import org.junit.Test; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import com.boot.baseTest.SpringTestCase; import com.boot.domain.User; import com.boot.service.UserService; public class UserServiceTest extends SpringTestCase{ Logger logger = LoggerFactory.getLogger(this.getClass()); @Autowired private UserService userService; @Test public void selectUserByIdTest(){ User user = userService.selectUserById(10); logger.info("查找結果" + user); } } 

選中測試類右鍵run as選中Junit Test即可，可以看到打印輸出了id為10的User對象

2018-02-04 21:20:07,442 [main] INFO com.boot.serviceTest.UserServiceTest - 查找結果User [userId=10, userName=apple, userPassword=uih6, userEmail=[e-mail]]

 

數據庫數據

若看到正常輸出，此時可以開始配置web頁面了。

web頁面配置

（1）靜態資源
靜態資源放在src/main/resources/static目錄下

 

圖片.png

（2）index.html
spring-boot支持thymeleaf模板引擎，模板文件默認放在src/main/resources/templates目錄下

 

<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta content="text/html;charset=UTF-8"/> <meta name="viewport" content="width=device-width,initial-scale=1"/> <link th:href="@{/js/jquery-1.11.3.min.js}" rel="stylesheet"/> </head> <body> <h2>Hello World!</h2> <p th:text="${user.userId}"></p> <p th:text="${user.userName}"></p> <p th:text="${user.userPassword}"></p> <p th:text="${user.userEmail}"></p> </body> </html> 

xmlns:th="http://www.thymeleaf.org"命名空間，將鏡頭轉化為動態的視圖，需要進行動態處理的元素使用“th:”前綴；link引入jquery框架，通過@{}引入web靜態資源（括號里面是資源路徑）訪問model中的數據通過${}訪問。
（4）自定義錯誤頁面
spring-boot錯誤頁面默認在src/main/resources/static/error或者src/main/resources/public/error下，在此簡單寫了個404頁面，命名為404.html放到目錄下即可

404.html

<!DOCTYPE html> <html > <body> <h2>404 not found</h2> </body> </html> 

（5）controller

package com.boot.web; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import com.boot.domain.User; import com.boot.service.UserService; @Controller @RequestMapping("/user") public class UserController { @Autowired private UserService userService; @RequestMapping(value = "") public String getIndex(Model model){ User user = userService.selectUserById(1); model.addAttribute("user", user); return "index"; } } 

**（6）啟動工程
啟動工程以后打開http://localhost:8080/user即可看到如下圖：

 

index頁面

 

若打開任意不存在的頁面，會返回404.html中內容

 

404

打包工程

使用package命令給工程打包成jar包

mvn package 

此時會在target下生成一個jar包，啟動即可：

java -jar target\testSpringBoot-0.0.1-SNAPSHOT.jar 

輸出如下

λ java -jar target\testSpringBoot-0.0.1-SNAPSHOT.jar . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v1.5.9.RELEASE)

作者：GCYML
鏈接：https://www.jianshu.com/p/95fb7be049ae
來源：簡書
簡書著作權歸作者所有，任何形式的轉載都請聯系作者獲得授權並注明出處。