本章使用Spring Boot實作一個簡單的例子，主要包括兩個知識點：
- 使用Spring Boot的起步依賴
- 使用Spring Boot自動進行Spring的配置
2.1 運用Spring Boot
下面將使用Spring Boot創建一個簡單的閱讀串列程式，用戶可以輸入想讀的 圖書資訊，查看串列，洗掉已經讀過的書，
首先，使用Spring Boot初始化專案，從技術角度來看，我們要用Spring MVC來處理Web請求，用Thymeleaf來定義Web視圖，用Spring Data JPA來把閱讀串列持久化到資料庫里，這里先用嵌入式的H2資料庫，我們使用Initializr的Web界面進行初始化，在添加依賴的地方添加Web、Thymeleaf和JPA，還要添加H2，以在開發應用程式時使用內嵌式資料庫，
初始化后的檔案結構：
2.1.1 ReadListApplication.java
首先看ReadListApplication.java，ReadListApplication在Spring Boot應用程式里有兩個作用：配置和啟動引導，首先， 這是主要的Spring配置類，雖然Spring Boot的自動配置免除了很多Spring配置，但你還需要進行 少量配置來啟用自動配置，@SpringBootApplication開啟了Spring的組件掃描和Spring Boot的自動配置功能，實際 上，@SpringBootApplication將三個有用的注解組合在了一起，
- Spring的@Configuration：標明該類使用Spring基于Java的配置，
- Spring的@ComponentScan：啟用組件掃描，這樣你寫的Web控制器類和其他組件才能被 自動發現并注冊為Spring應用程式背景關系里的Bean，本章稍后會寫一個簡單的Spring MVC 控制器，使用@Controller進行注解，這樣組件掃描才能找到它，
- Spring Boot 的 @EnableAutoConfiguration ：這個注解也可以稱為 @Abracadabra，就是這一行配置開啟了Spring Boot自動配置的魔力，讓你不用再寫成篇的配置了，
如前所述，ReadListApplication還有一個作用是啟動引導，運行Spring Boot應用程式有兩種方式：一是通過傳統的WAR包形式；二是通過可執行jar包的方式，這里向SpringApplication.run()傳遞了一個ReadingListApplication類的參考，還有命令列引數，通過這些東西啟動應用程式，
package com.yuan.readlist;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication //開啟組件掃描和自動配置
public class ReadlistApplication {
public static void main(String[] args) {
SpringApplication.run(ReadlistApplication.class, args); //負責啟動引導應用程式
}
}
2.1.2 ReadlistApplicationTests.java
ReadingListApplicationTests不僅提供了一個用于測驗Spring Boot專案的框架，它還是一個例子，告訴你如何為Spring Boot應用程式撰寫測驗，
contextLoads()這個空方法足以證明應用程式背景關系的加載沒有問題，如果ReadingListApplication里定義的配置是好的，就能通過測驗，如果有問題，測驗就會失敗，
當然，現在這只是一個新的應用程式，你還會添加自己的測驗，但contextLoads()方法是個良好的開端，此刻可以驗證應用程式提供的各種功能，第4章會更詳細地討論如何測驗Spring Boot應用程式，
package com.yuan.readlist;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
@RunWith(SpringRunner.class)
@SpringBootTest
public class ReadlistApplicationTests {
@Test
public void contextLoads() {
}
}
2.1.3 application.properties
Initializr為你生成的application.properties檔案是一個空檔案，該檔案可以用來調整Spring Boot的自動配置，
要注意的是，你完全不用告訴Spring Boot為你加載application.properties，只要它存在就會被加載，Spring和應用程式代碼都能獲取其中的屬性，當然如果它不存在也完全沒有問題，Spring Boot會使用其默認配置，
2.1.4 運行專案
構建一個Spring Boot應用程式和構建其他Java應用程式的程序類似，可以選擇Gradle或Maven作為構建工具，描述構建說明檔案的方法和描述非Spring Boot應用程式的方法也相似，Spring Boot為Gradle和Maven提供了構建插件，以便輔助構建Spring Boot專案，
將專案匯入到MyEclipse中，執行ReadlistApplication的main方法，即可運行專案，然后瀏覽器訪問127.0.0.1:8080，由于還沒有寫控制器類，會打開一個404的錯誤頁面，
2.2 使用起步依賴
指定基于功能的依賴
通過使用Spring Boot的起步依賴，可以使我們不用指定具體的版本號，甚至不需要指定具體使用的依賴，比如我們前面在引入依賴時，我們只是在Initializr里添加了Web、Thymeleaf、JPA和H2，而通過傳遞依賴，它們宣告的依賴也會被傳遞依賴進來，添加這四個依賴就等價于將相關的庫都添加了進來，在《Spring Boot實戰》附錄B羅列出了全部起步依賴，并簡要描述了一下它們向專案構建引入了什么，
覆寫起步依賴引入的傳遞依賴
起步依賴和你專案里的其他依賴沒什么區別，也就是說，你可以通過構建工具中的功能，選擇性地覆寫它們引入的傳遞依賴的版本號，排除傳遞依賴，當然還可以為那些Spring Boot起步依賴沒有涵蓋的庫指定依賴，在Maven里，可以用元素來排除傳遞依賴，
Maven總是會用最近的依賴，也就是說，如果你在專案里想要覆寫Spring Boot引入的傳遞依賴，可以直接在在專案的構建說明檔案里增加的這個依賴，
（關于起步依賴更多詳細內容，參考《Spring Boot實戰》2.2節使用起步依賴，）
2.3 使用自動配置
簡每當應用程式啟動的時候，Spring Boot檢測ClassPath中包含的包，并對包含的包做一個基本的配置，比如Spring Security是不是在Classpath里？如果是，則進行一個非常基本的Web安全設定，
每當應用程式啟動的時候，Spring Boot的自動配置都要做將近200個這樣的決定，涵蓋安全、 集成、持久化、Web開發等諸多方面，所有這些自動配置就是為了盡量不讓你自己寫配置，從而更多的專注于程式的功能，
下面我們繼續ReadList的功能實作：
- 定義領域模型
讀者閱讀串列上的書是本例的核心領域概念，我們定義一個物體類Book來表示這個概念，
@Entity注解表明它是一個JPA物體，id屬性加了@Id和@GeneratedValue注解，說明這個欄位是物體的唯一標識，并且這個欄位的值是自動生成的，
package com.yuan.readlist;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
@Entity
public class Book {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;
private String reader;
private String isbn;
private String title;
private String author;
private String description;
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getReader() {
return reader;
}
public void setReader(String reader) {
this.reader = reader;
}
public String getIsbn() {
return isbn;
}
public void setIsbn(String isbn) {
this.isbn = isbn;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String getAuthor() {
return author;
}
public void setAuthor(String author) {
this.author = author;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
}
- 定義倉庫介面
用于把Book物件持久化到資料庫的倉庫了，因為用了Spring Data JPA，所以我們要做的就是簡單地定義一個介面，擴展一下Spring Data JPA的JpaRepository介面：
package com.yuan.readlist;
import java.util.List;
import org.springframework.data.jpa.repository.JpaRepository;
public interface ReadingListRepository extends JpaRepository<Book, Long> {
List<Book> findByReader(String reader);
}
通過擴展JpaRepository，ReadingListRepository直接繼承了18個執行常用持久化操作的方法，JpaRepository是個泛型介面，有兩個引數：倉庫操作的領域物件型別，及其ID屬性的型別，此外，我還增加了一個findByReader()方法，可以根據讀者的用戶名來查找閱讀串列， 如果你好奇誰來實作這個ReadingListRepository及其繼承的18個方法，請不用擔心，Spring Data提供了很神奇的魔法，只需定義倉庫介面，在應用程式啟動后，該介面在運行時會自動實作，
- 創建控制器
我們創建Spring MVC控制器來處理HTTP請求，ReadingListController使用了@Controller注解，這樣組件掃描會自動將其注冊為 Spring應用程式背景關系里的一個Bean，它還用了@RequestMapping注解，將其中所有的處理器 方法都映射到了“/”這個URL路徑上，
package com.yuan.readlist;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import java.util.List;
@Controller
@RequestMapping("/")
public class ReadingListController {
private ReadingListRepository readingListRepository;
@Autowired
public ReadingListController(ReadingListRepository readingListRepository) {
this.readingListRepository = readingListRepository;
}
@RequestMapping(value = "https://blog.csdn.net/{reader}", method = RequestMethod.GET)
public String readersBooks(@PathVariable("reader") String reader,
Model model) {
List<Book> readingList = readingListRepository.findByReader(reader);
if (readingList != null) {
model.addAttribute("books", readingList);
}
return "readingList";
}
@RequestMapping(value = "https://blog.csdn.net/{reader}", method = RequestMethod.POST)
public String addToReadingList(@PathVariable("reader") String reader,
Book book) {
book.setReader(reader);
readingListRepository.save(book);
return "redirect:/{reader}";
}
}
該控制器有兩個方法，
readersBooks()：處理/{reader}上的HTTP GET請求，根據路徑里指定的讀者，從（通過控制器的構造器注入的）倉庫獲取Book串列，隨后將這個串列塞入模型，用的鍵是books，最后回傳readingList作為呈現模型的視圖邏輯名稱，
addToReadingList()：處理/{reader}上的HTTP POST請求，將請求正文里的資料系結到一個Book物件上，該方法把Book物件的reader屬性設定為讀者的姓名，隨后通過倉庫的save()方法保存修改后的Book物件，最后重定向到/{reader}（控制器中的另一個方法會處理該請求），
- 創建WEB界面
readersBooks()方法最后回傳readingList作為邏輯視圖名，為此必須創建該視圖，因為在專案開始之初就決定要用Thymeleaf來定義應用程式的視圖，所以接下來就在src/main/resources/templates里創建一個名為readingList.html的檔案：
<html>
<head>
<title>Reading List</title>
<link rel="stylesheet" th:href="https://blog.csdn.net/yuan1164345228/article/details/@{/style.css}"></link>
</head>
<body
<h2>Your Reading List</h2>
<div th:unless="${#lists.isEmpty(books)}">
<dl th:each="book : ${books}">
<dt >
<span th:text="${book.title}">Title</span> by <span
th:text="${book.author}">Author</span> (ISBN: <span
th:text="${book.isbn}">ISBN</span>)
</dt>
<dd >
<span th:if="${book.description}" th:text="${book.description}">Description</span>
<span th:if="${book.description eq null}"> No description
available</span>
</dd>
</dl>
</div>
<div th:if="${#lists.isEmpty(books)}">
<p>You have no books in your book list</p>
</div>
<hr />
<h3>Add a book</h3>
<form method="POST">
<label for="title">Title:</label> <input type="text" name="title"
size="50"></input><br /> <label for="author">Author:</label> <input
type="text" name="author" size="50"></input><br /> <label for="isbn">ISBN:</label>
<input type="text" name="isbn" size="15"></input><br /> <label
for="description">Description:</label><br />
<textarea name="description" cols="80" rows="5">
</textarea>
<br /> <input type="submit"></input>
</form>
</body>
</html>
添加名為style.css的樣式檔案，該檔案位于src/main/resources/static目錄：
body {
background-color: #cccccc;
font-family: arial,helvetica,sans-serif;
}
.bookHeadline {
font-size: 12pt;
font-weight: bold;
}
.bookDescription {
font-size: 10pt;
}
label {
font-weight: bold;
}
- 運行程式
到目前為止，我們就已經完成了一個完整的Spring WEB程式，可見我們并沒有進行什么配置，所有的配置都是Spring Boot自動完成的，
下面我們來運行這個WEB程式，在MyEclipse中右鍵，Run as Java Application，然后瀏覽器訪問127.0.0.1:8080/name即可打開網頁，可提交查詢表單，
關于Spring Boot自動配置更多內容，及其如何實作自動配置功能，參見《Spring Boot實戰》2.3.3節內容，
2.4 總結
通過Spring Boot的起步依賴和自動配置，你可以更加快速、便捷地開發Spring應用程式，在下一章，我們將會看到如何覆寫Spring Boot自動配置，借此達成應用程式的一些特殊要求，還有如何運用類似的技術來配置自己的應用程式組件，
轉載請註明出處，本文鏈接：https://www.uj5u.com/qianduan/18936.html
標籤：其他
下一篇：Java初學之人機猜拳游戲