SpringBoot

簡介

微框架，與 Spring4 一起誕生，基於約定、生來為了簡化 spring 的配置

優點

• 可以快速的上手，整合了一些子專案(開源框架或者第三方開源庫)
• 可以依賴很少的配置快速的搭建專案
• 基於 spring 使開發者快速入門，門檻很低。
• 可以建立獨立執行的應用而不需要依賴容器
• 提供很多 maven 極簡配置，缺點是會引入很多不需要的包
• 提供視覺化的相關功能，方便監控
• 簡化配置

使用場景

• 有 Spring 的地方都行
• J2EE/web 專案
• 微服務的基礎

需要的Java版本：1.8+

核心功能

起步依賴

起步依賴實際上就是一個 Maven 專案物件模型，定義了對其他庫的傳遞依賴。這些東西加在一起支援某項功能。從一定程度上規避了依賴衝突問題

自動配置

對於一些約定的屬性，springboot 在 spring-boot-autoconfigure 包下 META-INF/spring-configuration-metadata.json 檔案中進行了預設屬性配置。如果我們不通過配置檔案覆蓋這個配置，在應用程式啟動時，如果應用程式啟動條件符合註解的要求，就會採用這些預設配置來完成應用的初始化配置。如果我們覆蓋這個配置，就會採用我們定義的配置

原理分析：

@SpringBootConfiguration // 相當於 @Configuration
@EnableAutoConfiguration // 開啟自動配置
@ComponentScan( // 配置註解掃描。掃描該包及其子包的註解
    excludeFilters = {@Filter(
    type = FilterType.CUSTOM,
    classes = {TypeExcludeFilter.class}
), @Filter(
    type = FilterType.CUSTOM,
    classes = {AutoConfigurationExcludeFilter.class}
)}
)
public @interface SpringBootApplication {}
 

快速搭建

使用IDEA可以快速的建立 springboot 專案，當然也可以通過建立 Maven 工程並匯入依賴來新建 springboot 專案

快速建立的工程只能選擇最新的幾個版本，如果想使用老版本可以在工程搭建完成後手動更改版本號

配置檔案

SpringBoot使用一個全域性的配置檔案，並且名稱是固定的，配置檔案有兩種(截圖自來自spring-boot-starter-parent-1.5.9.RELEASE.pom)：

由該 pom 檔案也可以得出一個結論，當同時存在 .yml 和 .properties 配置檔案且配置了相同的引數時，會因為後加載 properties 而導致 yml 裡面的相同配置配覆蓋。當然實際開發也幾乎不會有人這麼做

application.properties 就是常規的 key=value 格式配置檔案，當要配置的引數比較多就會發現他的層次不是那麼清晰，不便於閱讀

application.yml

yml(也叫yaml)：是一種以資料為中心的配置檔案， 比 json,xml 等更適合做配置檔案

yml基本語法：

key:(空格)value ---> 鍵和值中間用冒號空格！！！連線，記住是冒號空格，缺一不可

不同層級的關係用空格表示,只要是左對齊的一列資料，都是同一層級的：

server:
 port: 8888

字串

預設不用加引號，

如果加上 “” 雙引號，雙引號內的特殊字元將作為本身的意思展示

如果加上 ‘’ 單引號，單引號內的特殊字元將會被轉義

物件、Map

在下一行來寫物件的屬性和值的關係；注意縮排

user:
  name: yaya
  age: 18
  address: xian
firends: {name: zhangsan, age: 18}
# map裡面的 冒號後面也得有 空格

陣列 List、Set

用 - 值表示陣列中的一個元素

arr:
  - 1
  - 2
  - 3

例：用yml構造一個物件

person: # 字首名
  name: yaya
  age: 18
  address: 西安
  arr:
    - 1
    - 2
    - 3
  friend: {name: zs,age: 13}
  son:
    name: 張三
    age: 13

@Component // 配置 Bean 被 Spring 容器管理
@ConfigurationProperties(prefix = "person") // 配置檔案和實體進行對映，配置字首，這裡對應 yml 檔案中的物件名
public class User {
    private String name;
    private int age;
    private String address;
    private List<Integer> arr;
    private Map<String, Object> friend;
    private Son son; // 引入一個外部類
    setter/getter ...   
}

public class Son{ // 該類不用加任何註解，框架還是會將 yml 中的屬性對映到該類的屬性上
    private String name;
    private int age;
}

@Value 獲取值和 @ConfigurationProperties 獲取值的比較:

	@ConfigurationProperties	@Value
功能	批量注入配置檔案中的屬性	一個個指定
鬆散繫結（鬆散語法）	支援	不支援
SpEL	不支援	支援
JSR303資料校驗	支援	不支援
複雜型別封裝	支援	不支援

Bean對Json對映處理

@JsonIngore

@JsonFormat

public class Person {
    private String name;
    @JsonIgnore // 轉換時忽略該欄位
    private Integer age;
    // Json格式化
    @JsonFormat(pattern = "yyyy年MM月dd日 HH:mm:ss", locale = "zh", timezone = "GMT+8")
    private Date birthday;
}

@RequestMapping("/person")
public Person person(){
    Person p = new Person();
    p.setName("張三");
    p.setAge(23);
    p.setBirthday(new Date());

    System.out.println(p);
    return p;
}

這時，返回的JSON資料中就不會出現 age 屬性，並且對 birthday 進行了格式化

{"name":"張三","birthday":"2019年08月07日 15:34:45"}

@JsonInclude

忽略null屬性

如果前端需要將 null 返回為空串/不返回，我們可以使用。

@JsonInclude(content = JsonInclude.Include.NON_NULL) // 如果該屬性為 null，則它不參與序列化

注意：在 spring-boot 1.5.9 版本中， @JsonInclude 註解沒有對 value 和 content 關聯(沒有在 content 上配置 @AliasFor 註解)，所以剛剛上面的配置是無效的。採用下面的配置：

@JsonInclude(JsonInclude.Include.NON_NULL)

也可以在 yml 檔案中配置全域性忽略,配置方法如下：

spring:
  jackson:
    default-property-inclusion: non_null

Devtools熱部署

1. 在pom.xml中新增

<dependency>  
    <groupId>org.springframework.boot</groupId>  
    <artifactId>spring-boot-devtools</artifactId> 
    <!-- 關閉此項的依賴傳遞，即別的專案依賴該專案時，不會傳遞依賴此jar -->
    <optional>true</optional>
</dependency>  

1. 配置IDEA自動編譯
   
2. 按 Ctrl+Shift+Alt+/ , 開啟 Registry .配置IDEA執行時自動編譯

一些額外的配置

spring:
  freemarker:
    cache: true # 關閉thymeleaf的頁面快取
  devtools:
    remote:
      restart:
        enabled: false # 熱部署開關
    restart:
      additional-paths: springboot-demo/src/main/java # 設定重啟的目錄，對那個目錄的檔案進行修改後需要重啟
      exclude: static/** # 設定classpath下 static 目錄內容修改後不重啟。一般設定為靜態資源目錄

資原始檔屬性配置

配置資原始檔屬性讀取

有時我們採用一些自己定義的資原始檔(非 application.xxx )想要獲取裡面的屬性值時，需要採用以下配置

<!-- 配置檔案處理器依賴，配置後可以進行資源配置檔案的載入 -->
<!-- 配置這個依賴後，書寫yml檔案時自定義的屬性會有提示 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

@Configuration // 也是一個 @Component 語義化註解
@ConfigurationProperties(value = "admin") // 配置檔案中共有的字首名
@PropertySource(value = "classpath:user.properties") // 資原始檔的位置
public class Admin implements Serializable {
    private String username;
    private String password;
}

配置tomcat

server:
  port: 8888 # 埠號
  session-timeout: 60 # session 超時時間/分鐘，預設是30
  context-path: /demo # 全域性虛擬路徑
  error:
    path: /error.html # 錯誤跳轉頁
  tomcat:
    uri-encoding: utf-8 # 設定tomcat編碼

整合模板引擎

整合FreeMarker

匯入FreeMarker啟動器

 <!-- freemarker -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

配置 freemarker

spring:
  freemarker:
    cache: false # 關閉freemarker快取。即時重新整理。上線環境建議修改為 true
    template-loader-path: classpath:/template # 模板檔案的路徑
    charset: UTF-8 # 編碼,預設也是u8
    check-template-location: true # 檢查模板路徑
    content-type: text/html # 預設也是 text/html

整合 mybatis

新增 mybatis 起步依賴,mysql 資料庫依賴

<!-- 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>
    <scope>runtime</scope>
</dependency>

在 yml 檔案中配置資料來源

spring:
  datasource:
    username: keats
    password: 521
    url: jdbc:mysql://localhost:3306/springboot?useUnicode=true&characterEncoding=utf-8&useSSL=true&serverTimezone=UTC
    driver-class-name: com.mysql.jdbc.Driver
    # 對於mysql資料庫連線版本 v6+ 這個驅動要修改成 com.mysql.cj.jdbc.Driver。當然也可以什麼都不寫用預設的

MyBatis相關配置

mybatis:
  mapper-locations: classpath:mapping/*Mapping.xml # 配置 mapper 檔案所在的路徑
  type-aliases-package: cn.keats.mybatisdemo.pojo # 配置這個包下的所有類起別名

建立實體類

public class User implements Serializable {
    private Integer id;
    private String username;
    private String password;
    private Date birthday;
    setter/getter ...
}

建立對映關係介面

介面要新增 @Mapper 註解，這樣容器中才會有介面的實現類

@Mapper // 
public interface UserMapper {

    @Select("select * from user where id = #{id}")
    User selectById(Integer id);  // 採用註解的方式書寫SQL語句

    void insert(User user); // 採用mapper配置檔案的方式書寫SQL語句
}

Mapper對映檔案,四個要求

namespace 等於 UserMapper 介面的全限定名

id 等於 方法名

parameterType 等於方法的引數型別

resaultType 等於方法的返回值型別

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN" "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd">

<mapper namespace="cn.keats.mybatisdemo.mapper.UserMapper">

    <insert id="insert" parameterType="user">
        insert into user values (null , #{username}, #{password}, #{birthday})
    </insert>

</mapper>

整合 Redis

匯入Redis啟動器

 <!-- redis -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

配置host和埠

其實從圖中可以看出，springboot預設對Redis的配置就是 localhost:6379 所以如果Redis也是這個路徑，可以不用自行配置

相關推薦