Spring Boot是由Pivotal团队提供的全新框架,其设计目的是用来简化新Spring应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置,从而使开发人员不再需要定义样板化的配置。
因此采用Spring Boot框架可以省去大量的配置文件,我们只需要将关注重点放到代码本身。除此之外,Spring Boot集成了Spring的常用功能,甚至嵌入了tomcat,作为小白来说,上手极快。
在本例中,采用Spring Boot1.56搭配目前主流的orm框架mybatis,数据库采用mysql,项目管理采用maven。注意JDK版本号为1.7。
1.修改pom.xml,添加maven依赖,引入jar包。
<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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.gaoyuan</groupId>
<artifactId>spring-boot</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>spring-boot Maven Webapp</name>
<url>http://maven.apache.org</url>
<!-- spring-boot父节点依赖 -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.6.RELEASE</version>
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- mysql数据库驱动,spring-boot会自动选择匹配的jar包 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<!-- mybatis,注意选择合适的版本 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.3.0</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
2.添加配置文件,Spring Boot省去了大量的配置文件,但是并不代表没有配置文件。在main/resources下创建名为application.properties的文件,添加mysql配置和mybatis配置。
#配置文件
spring.datasource.driverClassName=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/gaoyuan?useUnicode=true&characterEncoding=utf-8
spring.datasource.username=root
spring.datasource.password=
mybatis.config-locations=classpath:mybatis-config.xml
mybatis.mapper-locations=classpath:mappings/*.xml
本例中的mysql密码为空,请注意输入密码。
Spring Boot启动的时候会自动对application.properties的内容进行加载。同样在main/resources下创建名为mybatis-config.xml的文件,加入mybatis的配置参数。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<properties>
<property name="dialect" value="mysql" />
</properties>
<settings>
<!-- 开启驼峰匹配 -->
<setting name="mapUnderscoreToCamelCase" value="true"/>
<!-- 这个配置使全局的映射器启用或禁用缓存。系统默认值是true,设置只是为了展示出来 -->
<setting name="cacheEnabled" value="true" />
<!-- 全局启用或禁用延迟加载。当禁用时,所有关联对象都会即时加载。 系统默认值是true,设置只是为了展示出来 -->
<setting name="lazyLoadingEnabled" value="true" />
<!-- 允许或不允许多种结果集从一个单独的语句中返回(需要适合的驱动)。 系统默认值是true,设置只是为了展示出来 -->
<setting name="multipleResultSetsEnabled" value="true" />
<!--使用列标签代替列名。不同的驱动在这方便表现不同。参考驱动文档或充分测试两种方法来决定所使用的驱动。 系统默认值是true,设置只是为了展示出来 -->
<setting name="useColumnLabel" value="true" />
<!--允许 JDBC 支持生成的键。需要适合的驱动。如果设置为 true 则这个设置强制生成的键被使用,尽管一些驱动拒绝兼容但仍然有效(比如
Derby)。 系统默认值是false,设置只是为了展示出来 -->
<setting name="useGeneratedKeys" value="false" />
<!--配置默认的执行器。SIMPLE 执行器没有什么特别之处。REUSE 执行器重用预处理语句。BATCH 执行器重用语句和批量更新 系统默认值是SIMPLE,设置只是为了展示出来 -->
<setting name="defaultExecutorType" value="SIMPLE" />
<!--设置超时时间,它决定驱动等待一个数据库响应的时间。 系统默认值是null,设置只是为了展示出来 -->
<setting name="defaultStatementTimeout" value="25000" />
</settings>
</configuration>
3.编写实体类Business
package com.gaoyuan.entity;
public class Business {
private Integer id;
private String name;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
4.编写BusinessMapper 接口。
package com.gaoyuan.mapper;
import java.util.List;
import com.gaoyuan.entity.Business;
public interface BusinessMapper {
public List<Business> findList();
}
5.编写mapper.xml文件。在main/resources下创建包mappings,在里面添加BusinessMapper .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.gaoyuan.mapper.BusinessMapper">
<select id="findList" resultType="com.gaoyuan.entity.Business">
SELECT id, name FROM red_business
</select>
</mapper>
对于需要编写大量sql的项目来说,结果集前面长长的包名让人看到头痛。有一个简单的方法将其去掉。在application.properties中加入mybatis配置。
mybatis.type-aliases-package=com.gaoyuan.entity
这样,将xml中的查询语句我们可以修改成这样。
<select id="findList" resultType="Business">
SELECT id, name FROM red_business
</select>
6.编写BusinessService
package com.gaoyuan.service;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.gaoyuan.entity.Business;
import com.gaoyuan.mapper.BusinessMapper;
@Service
public class BusinessService {
@Autowired
private BusinessMapper businessMapper;
public List<Business> findList(){
return businessMapper.findList();
}
}
7.编写BusinessController
package com.gaoyuan.controller;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.gaoyuan.entity.Business;
import com.gaoyuan.service.BusinessService;
@RestController
public class BusinessController {
@Autowired
private BusinessService businessService;
@RequestMapping("/findList")
public List<Business> findList(){
List<Business> list = businessService.findList();
return list;
}
}
8.编写Application启动类,加入注解。其中MapperScan注解中要加入你的mapper接口。注意启动类必须要在你的项目的根目录下,否则启动会报错!
package com.gaoyuan;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
@MapperScan("com.gaoyuan.mapper")
public class SpringBootMybatisApplication {
public static void main(String[] args) throws Exception {
SpringApplication.run(SpringBootMybatisApplication.class, args);
}
}
右击启动类,选择Run As–Java Application。访问运行http://localhost:8080/findList。运行结果为
[{"id":1,"name":"始祖鸟"},{"id":2,"name":"品牌专卖店"},{"id":3,"name":"品牌专卖店"}]
本项目目录结构为