《Spring Boot實戰》之二：開發第一個應用程式-有解無憂

本章使用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/qukuanlian/5811.html

標籤：區塊鏈

上一篇：設計模式（一）：“懶漢式”與“餓漢式”單例模式

下一篇：Java初學之人機猜拳游戲