1. 程式人生 > >Spring Boot【快速入門】

Spring Boot【快速入門】

Spring Boot 概述

Build Anything with Spring Boot:Spring Boot is the starting point for building all Spring-based applications. Spring Boot is designed to get you up and running as quickly as possible, with minimal upfront configuration of Spring.

上面是引自官網的一段話,大概是說: Spring Boot 是所有基於 Spring 開發的專案的起點。Spring Boot 的設計是為了讓你儘可能快的跑起來 Spring 應用程式並且儘可能減少你的配置檔案。

什麼是 Spring Boot

  • 它使用 “習慣優於配置” (專案中存在大量的配置,此外還內建一個習慣性的配置,讓你無須)的理念讓你的專案快速執行起來。
  • 它並不是什麼新的框架,而是預設配置了很多框架的使用方式,就像 Maven 整合了所有的 jar 包一樣,Spring Boot 整合了所有框架(引自:springboot(一):入門篇——純潔的微笑

使用 Spring Boot 有什麼好處

回顧我們之前的 SSM 專案,搭建過程還是比較繁瑣的,需要:

  • 1)配置 web.xml,載入 spring 和 spring mvc
  • 2)配置資料庫連線、配置日誌檔案
  • 3)配置家在配置檔案的讀取,開啟註解
  • 4)配置mapper檔案
  • .....

而使用 Spring Boot 來開發專案則只需要非常少的幾個配置就可以搭建起來一個 Web 專案,並且利用 IDEA 可以自動生成生成,這簡直是太爽了...

  • 劃重點:簡單、快速、方便地搭建專案;對主流開發框架的無配置整合;極大提高了開發、部署效率。

Spring Boot 快速搭建

第一步:新建專案

選擇 Spring Initializr ,然後選擇預設的 url 點選【Next】:

然後修改一下專案的資訊:

勾選上 Web 模板:

選擇好專案的位置,點選【Finish】:

如果是第一次配置 Spring Boot 的話可能需要等待一會兒 IDEA 下載相應的 依賴包,預設建立好的專案結構如下:

專案結構還是看上去挺清爽的,少了很多配置檔案,我們來了解一下預設生成的有什麼:

  • SpringbootApplication: 一個帶有 main() 方法的類,用於啟動應用程式
  • SpringbootApplicationTests:一個空的 Junit 測試了,它載入了一個使用 Spring Boot 字典配置功能的 Spring 應用程式上下文
  • application.properties:一個空的 properties 檔案,可以根據需要新增配置屬性
  • pom.xml: Maven 構建說明檔案

第二步:HelloController

在【cn.wmyskxz.springboot】包下新建一個【HelloController】:

package cn.wmyskxz.springboot;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 測試控制器
 *
 * @author: @我沒有三顆心臟
 * @create: 2018-05-08-下午 16:46
 */
@RestController
public class HelloController {

    @RequestMapping("/hello")
    public String hello() {
        return "Hello Spring Boot!";
    }
}
  • @RestController 註解: 該註解是 @Controller 和 @ResponseBody 註解的合體版

第三步:利用 IDEA 啟動 Spring Boot

我們回到 SpringbootApplication 這個類中,然後右鍵點選執行:

  • 注意:我們之所以在上面的專案中沒有手動的去配置 Tomcat 伺服器,是因為 Spring Boot 內建了 Tomcat

等待一會兒就會看到下方的成功執行的提示資訊:

可以看到我們的 Tomcat 執行在 8080 埠,我們來訪問 “/hello” 地址試一下:

可以看到頁面成功顯示出我們返回的資訊。

解析 Spring Boot 專案

解析 pom.xml 檔案

讓我們來看看預設生成的 pom.xml 檔案中到底有一些什麼特別:

<?xml version="1.0" encoding="UTF-8"?>
<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>cn.wmyskxz</groupId>
    <artifactId>springboot</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>springboot</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

我們可以看到一個比較陌生一些的標籤 <parent> ,這個標籤是在配置 Spring Boot 的父級依賴:

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.1.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

有了這個,當前的專案才是 Spring Boot 專案,spring-boot-starter-parent 是一個特殊的 starter ,它用來提供相關的 Maven 預設依賴,使用它之後,常用的包依賴就可以省去 version 標籤。

關於具體 Spring Boot 提供了哪些 jar 包的依賴,我們可以檢視本地 Maven 倉庫下:\repository\org\springframework\boot\spring-boot-dependencies\2.0.1.RELEASE\spring-boot-dependencies-2.0.1.RELEASE.pom 檔案來檢視,挺長的...

應用入口類

Spring Boot 專案通常有一個名為 *Application 的入口類,入口類裡有一個 main 方法, 這個 main 方法其實就是一個標準的 Javay 應用的入口方法。

@SpringBootApplication 是 Spring Boot 的核心註解,它是一個組合註解,該註解組合了:@Configuration、@EnableAutoConfiguration、@ComponentScan; 若不是用 @SpringBootApplication 註解也可以使用這三個註解代替。

  • 其中,@EnableAutoConfiguration 讓 Spring Boot 根據類路徑中的 jar 包依賴為當前專案進行自動配置,例如,添加了 spring-boot-starter-web 依賴,會自動新增 Tomcat 和 Spring MVC 的依賴,那麼 Spring Boot 會對 Tomcat 和 Spring MVC 進行自動配置。
  • Spring Boot 還會自動掃描 @SpringBootApplication 所在類的同級包以及下級包裡的 Bean ,所以入口類建議就配置在 grounpID + arctifactID 組合的包名下(這裡為 cn.wmyskxz.springboot 包)

Spring Boot 的配置檔案

Spring Boot 使用一個全域性的配置檔案 application.properties 或 application.yml,放置在【src/main/resources】目錄或者類路徑的 /config 下。

Spring Boot 不僅支援常規的 properties 配置檔案,還支援 yaml 語言的配置檔案。yaml 是以資料為中心的語言,在配置資料的時候具有面向物件的特徵。

Spring Boot 的全域性配置檔案的作用是對一些預設配置的配置值進行修改。

  • 簡單例項一下

我們同樣的將 Tomcat 預設埠設定為 8080 ,並將預設的訪問路徑從 “/” 修改為 “/hello” 時,使用 properties 檔案和 yml 檔案的區別如上圖。

  • 注意: yml 需要在 “:” 後加一個空格,幸好 IDEA 很好地支援了 yml 檔案的格式有良好的程式碼提示;
  • 我們可以自己配置多個屬性

我們直接把 .properties 字尾的檔案刪掉,使用 .yml 檔案來進行簡單的配置,然後使用 @Value 來獲取配置屬性:

重啟 Spring Boot ,輸入地址:localhost:8080/hello 能看到正確的結果:

  • 注意: 我們並沒有在 yml 檔案中註明屬性的型別,而是在使用的時候定義的。

你也可以在配置檔案中使用當前配置:

仍然可以得到正確的結果:

  • 問題: 這樣寫配置檔案繁瑣而且可能會造成類的臃腫,因為有許許多多的 @Value 註解。
  • 封裝配置資訊

我們可以把配置資訊封裝成一個類,首先在我們的 name 和 age 前加一個 student 字首,然後新建一個 StudentProperties 的類用來封裝這些資訊,並用上兩個註解:

  • @Component:表明當前類是一個 Java Bean
  • @ConfigurationProperties(prefix = "student"):表示獲取字首為 sutdent 的配置資訊

這樣我們就可以在控制器中使用,重啟得到正確資訊:

Spring Boot 熱部署

在目前的 Spring Boot 專案中,當發生了任何修改之後我們都需要重新啟動才能夠正確的得到效果,這樣會略顯麻煩,Spring Boot 提供了熱部署的方式,當發現任何類發生了改變,就會通過 JVM 類載入的方式,載入最新的類到虛擬機器中,這樣就不需要重新啟動也能看到修改後的效果了。

  • 做法也很簡單,修改 pom.xml 即可!

我們往 pom.xml 中新增一個依賴就可以了:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional> <!-- 這個需要為 true 熱部署才有效 -->
</dependency>

重新啟動 Spring Boot ,然後修改任意程式碼,就能觀察到控制檯的自動重啟現象:

關於如何在 IDEA 中配置熱部署:傳送門

Spring Boot 使用

上面已經完成了 Spring Boot 專案的簡單搭建,我們僅僅需要進行一些簡單的設定,寫一個 HelloController 就能夠直接運行了,不要太簡單...接下來我們再深入瞭解一下 Spring Boot 的使用。

Spring Boot 支援 JSP

Spring Boot 的預設檢視支援是 Thymeleaf 模板引擎,但是這個我們不熟悉啊,我們還是想要使用 JSP 怎麼辦呢?

  • 第一步:修改 pom.xml 增加對 JSP 檔案的支援
<!-- servlet依賴. -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
</dependency>

<!-- tomcat的支援.-->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
    <scope>provided</scope>
</dependency>
  • 第二步:配置試圖重定向 JSP 檔案的位置

修改 application.yml 檔案,將我們的 JSP 檔案重定向到 /WEB-INF/views/ 目錄下:

  • 第三步:修改 HelloController

修改 @RestController 註解為 @Controller ,然後將 hello 方法修改為:

  • 第四步:新建 hello.jsp 檔案

在【src/main】目錄下依次建立 webapp、WEB-INF、views 目錄,並建立一個 hello.jsp 檔案:

  • 第五步:重新整理網頁

因為我們部署了熱部署功能,所以只需要等待控制檯重啟資訊完成之後再重新整理網頁就可以看到正確效果了:

  • 關於 404,使用 spring-boot:run 執行專案可以解決:

整合 MyBatis

  • 第一步:修改 pom.xml 增加對 MySql和 MyBatis 的支援
 
<!-- mybatis -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.1.1</version>
</dependency>
<!-- mysql -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.21</version>
</dependency>
  • 第二步:新增資料庫連結引數

這裡我們就直接使用之前建立好的 student 表了吧:

  • 第三步:建立 Student 實體類和 StudentMapper 對映類

在【cn.wmyskxz.springboot】下新建一個【pojo】包,然後在其下建立一個 Student 類:

public class Student {

    private Integer id;
    private Integer student_id;
    private String name;
    private Integer age;
    private String sex;
    private Date birthday;

    /* getter and setter */
}

在【cn.wmyskxz.springboot】下新建一個【mapper】包,然後在其下建立一個 StudentMapper 對映類:

package cn.wmyskxz.springboot.mapper;

import cn.wmyskxz.springboot.pojo.Student;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;

import java.util.List;

@Mapper
public interface StudentMapper {

    @Select("SELECT * FROM student")
    List<Student> findAll();
}
  • 第四步:編寫 StudentController

在【cn.wmyskxz.springboot】下新建一個【controller】包,然後在其下建立一個 StudentController :

package cn.wmyskxz.springboot.controller;

import cn.wmyskxz.springboot.mapper.StudentMapper;
import cn.wmyskxz.springboot.pojo.Student;
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 java.util.List;

/**
 * Student 控制器
 *
 * @author: @我沒有三顆心臟
 * @create: 2018-05-08-下午 20:25
 */
@Controller
public class StudentController {

    @Autowired
    StudentMapper studentMapper;

    @RequestMapping("/listStudent")
    public String listStudent(Model model) {
        List<Student> students = studentMapper.findAll();
        model.addAttribute("students", students);
        return "listStudent";
    }
}

第五步:編寫 listStudent.jsp 檔案

我們簡化一下 JSP 的檔案,僅顯示兩個欄位的資料:

<%@ page language="java" contentType="text/html; charset=UTF-8"
         pageEncoding="UTF-8"%>

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>

<table align='center' border='1' cellspacing='0'>
    <tr>
        <td>id</td>
        <td>name</td>
    </tr>
    <c:forEach items="${students}" var="s" varStatus="st">
        <tr>
            <td>${s.id}</td>
            <td>${s.name}</td>
        </tr>
    </c:forEach>
</table>
  • 第六步:重啟伺服器執行

因為往 pom.xml 中新增加了依賴的包,所以自動重啟伺服器沒有作用,我們需要手動重啟一次,然後在地址輸入:localhost:8080/listStudent 檢視效果:

以上。