Spring Boot是由Pivotal團(tuán)隊(duì)提供的全新框架，其設(shè)計(jì)目的是用來(lái)簡(jiǎn)化新Spring應(yīng)用的初始搭建以及開發(fā)過(guò)程。該框架使用了特定的方式來(lái)進(jìn)行配置，從而使開發(fā)人員不再需要定義樣板化的配置。通過(guò)這種方式，Boot致力于在蓬勃發(fā)展的快速應(yīng)用開發(fā)領(lǐng)域（rapid application development）成為領(lǐng)導(dǎo)者。

?

?

多年以來(lái)，Spring IO平臺(tái)飽受非議的一點(diǎn)就是大量的XML配置以及復(fù)雜的依賴管理。在去年的SpringOne 2GX會(huì)議上，Pivotal的CTO Adrian Colyer回應(yīng)了這些批評(píng)，并且特別提到該平臺(tái)將來(lái)的目標(biāo)之一就是實(shí)現(xiàn)免XML配置的開發(fā)體驗(yàn)。Boot所實(shí)現(xiàn)的功能超出了這個(gè)任務(wù)的描述，開發(fā)人員不僅不再需要編寫XML，而且在一些場(chǎng)景中甚至不需要編寫繁瑣的import語(yǔ)句。在對(duì)外公開的beta版本剛剛發(fā)布之時(shí)，Boot描述了如何使用該框架在140個(gè)字符內(nèi)實(shí)現(xiàn)可運(yùn)行的web應(yīng)用，從而獲得了極大的關(guān)注度，該樣例發(fā)表在tweet上。

?

然而，Spring Boot并不是要成為Spring IO平臺(tái)里面眾多“Foundation”層項(xiàng)目的替代者。Spring Boot的目標(biāo)不在于為已解決的問(wèn)題域提供新的解決方案，而是為平臺(tái)帶來(lái)另一種開發(fā)體驗(yàn)，從而簡(jiǎn)化對(duì)這些已有技術(shù)的使用。對(duì)于已經(jīng)熟悉Spring生態(tài)系統(tǒng)的開發(fā)人員來(lái)說(shuō)，Boot是一個(gè)很理想的選擇，不過(guò)對(duì)于采用Spring技術(shù)的新人來(lái)說(shuō)，Boot提供一種更簡(jiǎn)潔的方式來(lái)使用這些技術(shù)。

?

在追求開發(fā)體驗(yàn)的提升方面，Spring Boot，甚至可以說(shuō)整個(gè)Spring生態(tài)系統(tǒng)都使用到了Groovy編程語(yǔ)言。Boot所提供的眾多便捷功能，都是借助于Groovy強(qiáng)大的MetaObject協(xié)議、可插拔的AST轉(zhuǎn)換過(guò)程以及內(nèi)置的依賴解決方案引擎所實(shí)現(xiàn)的。在其核心的編譯模型之中，Boot使用Groovy來(lái)構(gòu)建工程文件，所以它可以使用通用的導(dǎo)入和樣板方法（如類的main方法）對(duì)類所生成的字節(jié)碼進(jìn)行裝飾（decorate）。這樣使用Boot編寫的應(yīng)用就能保持非常簡(jiǎn)潔，卻依然可以提供眾多的功能。

?

安裝Boot

從最根本上來(lái)講，Spring Boot就是一些庫(kù)的集合，它能夠被任意項(xiàng)目的構(gòu)建系統(tǒng)所使用。簡(jiǎn)便起見(jiàn)，該框架也提供了命令行界面，它可以用來(lái)運(yùn)行和測(cè)試Boot應(yīng)用。框架的發(fā)布版本，包括集成的CLI（命令行界面），可以在Spring倉(cāng)庫(kù)中手動(dòng)下載和安裝。一種更為簡(jiǎn)便的方式是使用Groovy環(huán)境管理器（Groovy enVironment Manager，GVM），它會(huì)處理Boot版本的安裝和管理。Boot及其CLI可以通過(guò)GVM的命令行g(shù)vm install springboot進(jìn)行安裝。在OS X上安裝Boot可以使用Homebrew包管理器。為了完成安裝，首先要使用brew tap pivotal/tap切換到Pivotal倉(cāng)庫(kù)中，然后執(zhí)行brew install springboot命令。

要進(jìn)行打包和分發(fā)的工程會(huì)依賴于像Maven或Gradle這樣的構(gòu)建系統(tǒng)。為了簡(jiǎn)化依賴圖，Boot的功能是模塊化的，通過(guò)導(dǎo)入Boot所謂的“starter”模塊，可以將許多的依賴添加到工程之中。為了更容易地管理依賴版本和使用默認(rèn)配置，框架提供了一個(gè)parent POM，工程可以繼承它。Spring Boot工程的樣例POM文件定義如程序清單1所示。

程序清單1

<?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>com.example</groupId><artifactId>myproject</artifactId><version>1.0.0-SNAPSHOT</version><!-- Inherit defaults from Spring Boot --><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>1.0.0.RC1</version></parent><!-- Add typical dependencies for a web application --><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency></dependencies><repositories><repository><id>spring-snapshots</id><url>http://repo.spring.io/libs-snapshot</url></repository></repositories><pluginRepositories><pluginRepository><id>spring-snapshots</id><url>http://repo.spring.io/libs-snapshot</url></pluginRepository></pluginRepositories><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build> </project>

為了實(shí)現(xiàn)更為簡(jiǎn)單的構(gòu)建配置，開發(fā)人員可以使用Gradle構(gòu)建系統(tǒng)中簡(jiǎn)潔的Groovy DSL，如程序清單1.1所示。

程序清單1.1

buildscript {repositories {maven { url "http://repo.spring.io/libs-snapshot" }mavenCentral()}dependencies {classpath("org.springframework.boot:spring-boot-gradle-plugin:1.0.0.RC1")} }apply plugin: 'java' apply plugin: 'spring-boot'repositories {mavenCentral()maven { url "http://repo.spring.io/libs-snapshot" } }dependencies {compile 'org.springframework.boot:spring-boot-starter-actuator:1.0.0.RC1' }

為了快速地搭建和運(yùn)行Boot工程，Pivotal提供了稱之為“Spring Initializr” 的web界面，用于下載預(yù)先定義好的Maven或Gradle構(gòu)建配置。我們也可以使用Lazybones模板實(shí)現(xiàn)快速起步，在執(zhí)行l(wèi)azybones create spring-boot-actuator my-app命令后，它會(huì)為Boot應(yīng)用創(chuàng)建必要的工程結(jié)構(gòu)以及gradle構(gòu)建文件。

開發(fā)Spring Boot應(yīng)用

Spring Boot在剛剛公開宣布之后就將一個(gè)樣例發(fā)布到了Twitter上，它目前成為了最流行的一個(gè)應(yīng)用樣例。它的全部描述如程序清單1.2所示，一個(gè)非常簡(jiǎn)單的Groovy文件可以生成功能強(qiáng)大的以Spring為后端的web應(yīng)用。

程序清單1.2

@RestController class App {@RequestMapping("/")String home() {"hello"} }

這個(gè)應(yīng)用可以通過(guò)spring run App.groovy命令在Spring Boot CLI中運(yùn)行。Boot會(huì)分析文件并根據(jù)各種“編譯器自動(dòng)配置（compiler auto-configuration）”標(biāo)示符來(lái)確定其意圖是生成Web應(yīng)用。然后，它會(huì)在一個(gè)嵌入式的Tomcat中啟動(dòng)Spring應(yīng)用上下文，并且使用默認(rèn)的8080端口。打開瀏覽器并導(dǎo)航到給定的URL，隨后將會(huì)加載一個(gè)頁(yè)面并展現(xiàn)簡(jiǎn)單的文本響應(yīng)：“hello”。提供默認(rèn)應(yīng)用上下文以及嵌入式容器的這些過(guò)程，能夠讓開發(fā)人員更加關(guān)注于開發(fā)應(yīng)用以及業(yè)務(wù)邏輯，從而不用再關(guān)心繁瑣的樣板式配置。

Boot能夠自動(dòng)確定類所需的功能，這一點(diǎn)使其成為了強(qiáng)大的快速應(yīng)用開發(fā)工具。當(dāng)應(yīng)用在Boot CLI中執(zhí)行時(shí)，它們?cè)谑褂脙?nèi)部的Groovy編譯器進(jìn)行構(gòu)建，這個(gè)編譯器可以在字節(jié)碼生成的時(shí)候以編碼的方式探查并修改類。通過(guò)這種方式，使用CLI的開發(fā)人員不僅可以省去定義默認(rèn)配置，在一定程度上甚至可以不用定義特定的導(dǎo)入語(yǔ)句，它們可以在編譯的過(guò)程中識(shí)別出來(lái)并自動(dòng)進(jìn)行添加。除此之外，當(dāng)應(yīng)用在CLI中運(yùn)行時(shí)，Groovy內(nèi)置的依賴管理器，“Grape”，將會(huì)解析編譯期和運(yùn)行時(shí)的類路徑依賴，與Boot編譯器的自動(dòng)配置機(jī)制類似。這種方式不僅使得框架更加對(duì)用戶友好，而且能夠讓不同版本的Spring Boot與特定版本的來(lái)自于Spring IO平臺(tái)的庫(kù)相匹配，這樣一來(lái)開發(fā)人員就不用關(guān)心如何管理復(fù)雜的依賴圖和版本結(jié)構(gòu)了。另外，它還有助于快速原型的開發(fā)并生成概念原型的工程代碼。

對(duì)于不是使用CLI構(gòu)建的工程，Boot提供了許多的“starter”模塊，它們定義了一組依賴，這些依賴能夠添加到構(gòu)建系統(tǒng)之中，從而解析框架及其父平臺(tái)所需的特定類庫(kù)。例如，spring-boot-starter-actuator依賴會(huì)引入一組基本的Spring項(xiàng)目，從而實(shí)現(xiàn)應(yīng)用的快速配置和即時(shí)可用。關(guān)于這種依賴，值得強(qiáng)調(diào)的一點(diǎn)就是當(dāng)開發(fā)Web應(yīng)用，尤其是RESTful Web服務(wù)的時(shí)候，如果包含了spring-boot-starter-web依賴，它就會(huì)為你提供啟動(dòng)嵌入式Tomcat容器的自動(dòng)化配置，并且提供對(duì)微服務(wù)應(yīng)用有價(jià)值的端點(diǎn)信息，如服務(wù)器信息、應(yīng)用指標(biāo)（metrics）以及環(huán)境詳情。除此之外，如果引入spring-boot-starter-security模塊的話，actuator會(huì)自動(dòng)配置Spring Security，從而為應(yīng)用提供基本的認(rèn)證以及其他高級(jí)的安全特性。它還會(huì)為應(yīng)用結(jié)構(gòu)引入一個(gè)內(nèi)部的審計(jì)框架，這個(gè)框架可以用來(lái)生成報(bào)告或其他的用途，比如開發(fā)認(rèn)證失敗的鎖定策略。

為了闡述在Java Maven工程中，如何快速地使Spring Web工程準(zhǔn)備就緒，考慮一下程序清單1.3中的應(yīng)用程序代碼。

程序清單1.3

package com.infoq.springboot;import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.EnableAutoConfiguration; import org.springframework.web.bind.annotation.*;@RestController @EnableAutoConfiguration public class Application {@RequestMapping("/")public String home() {return "Hello";}public static void main(String[] args) {SpringApplication.run(Application.class, args);} }

在Application類上的@EnableAutoConfiguration注解會(huì)告知Boot要采用一種特定的方式來(lái)對(duì)應(yīng)用進(jìn)行配置。這種方法會(huì)將其他樣板式的配置均假設(shè)為框架默認(rèn)的約定，因此能夠聚焦于如何盡快地使應(yīng)用準(zhǔn)備就緒以便運(yùn)行起來(lái)。Application類是可運(yùn)行的，因此，當(dāng)我們以Java Application的方式運(yùn)行這個(gè)類時(shí)，就能啟動(dòng)該應(yīng)用及其嵌入式的容器，這樣也能實(shí)現(xiàn)即時(shí)地開發(fā)。

為了發(fā)布版本而構(gòu)建工程時(shí)，Boot的Maven和Gradle插件可以嵌入（hook）到這些構(gòu)建系統(tǒng)的打包過(guò)程中，以生成可執(zhí)行的“胖jar包（fat jar）”，這種jar包含了工程的所有依賴并且能夠以可運(yùn)行jar的方式執(zhí)行。使用Maven打包Boot應(yīng)用只需運(yùn)行mvn package命令，與之類似，使用Gradle時(shí)，執(zhí)行g(shù)radle build命令將會(huì)在構(gòu)建的目標(biāo)地址下生成可運(yùn)行的jar。

開發(fā)微服務(wù)

Boot對(duì)Spring應(yīng)用的開發(fā)進(jìn)行了簡(jiǎn)化，提供了模塊化方式導(dǎo)入依賴的能力，強(qiáng)調(diào)了開發(fā)RESTful Web服務(wù)的功能并提供了生成可運(yùn)行jar的能力，這一切都清晰地表明在開發(fā)可部署的微服務(wù)方面Boot框架是一個(gè)強(qiáng)大的工具。正如前面的例子所示，借助于Boot，讓一個(gè)RESTful Web工程運(yùn)行起來(lái)是一件很容易的事情；不過(guò)，為了了解Boot所有潛在的功能，我們會(huì)闡述在開發(fā)完整功能的微服務(wù)時(shí)，會(huì)遇到的所有繁瑣的事情。在企業(yè)級(jí)基礎(chǔ)設(shè)施領(lǐng)域，微服務(wù)是一種越來(lái)越流行的應(yīng)用架構(gòu)，因?yàn)樗軌驅(qū)崿F(xiàn)快速開發(fā)、更小的代碼庫(kù)、企業(yè)級(jí)集成以及模塊化部署。有眾多的框架致力于該領(lǐng)域的開發(fā)，該章節(jié)將會(huì)討論使用Boot如何簡(jiǎn)化這一過(guò)程。

數(shù)據(jù)訪問(wèn)

我們可以基于各種目的來(lái)構(gòu)建微服務(wù)，但有一點(diǎn)是肯定的，那就是大多數(shù)都需要讀取和寫入數(shù)據(jù)庫(kù)的能力。Spring Boot使數(shù)據(jù)庫(kù)集成變成了一項(xiàng)非常簡(jiǎn)單的任務(wù)，因?yàn)樗哂凶詣?dòng)配置Spring Data以訪問(wèn)數(shù)據(jù)庫(kù)的能力。只需在你的工程中將spring-boot-starter-data-jpa包含進(jìn)來(lái)，Boot的自動(dòng)配置引擎就能探測(cè)到你的工程需要數(shù)據(jù)訪問(wèn)功能，并且會(huì)在Spring應(yīng)用上下文中創(chuàng)建必要的Bean，這樣你就可以使用Repository和服務(wù)了。為了更具體地闡述這一點(diǎn)，請(qǐng)參見(jiàn)程序清單1.4中的Gradle構(gòu)建文件，它列出了一個(gè)基于Groovy的微服務(wù)web應(yīng)用的構(gòu)建結(jié)構(gòu)，該應(yīng)用使用了Spring Data對(duì)JPA的支持來(lái)實(shí)現(xiàn)數(shù)據(jù)訪問(wèn)。

程序清單1.4

buildscript {repositories {maven { url "http://repo.spring.io/libs-snapshot" }mavenCentral()}dependencies {classpath("org.springframework.boot:spring-boot-gradle-plugin:1.0.0.RC1")} }apply plugin: 'groovy' apply plugin: 'spring-boot'repositories {mavenCentral()maven { url "http://repo.spring.io/libs-snapshot" } }ext {springBootVersion = "1.0.0.RC1" }dependencies {compile 'org.codehaus.groovy:groovy-all:2.2.1'compile "org.springframework.boot:spring-boot-starter-web:$springBootVersion"compile "org.springframework.boot:spring-boot-starter-data-jpa:$springBootVersion"compile "org.springframework.boot:spring-boot-starter-actuator:$springBootVersion" }

在這個(gè)配置中，Boot的actuator模塊提供了對(duì)hsqldb的依賴，這會(huì)搭建所有必要的依賴——包括模式的創(chuàng)建——因此Spring Data可以使用這個(gè)內(nèi)存數(shù)據(jù)庫(kù)作為數(shù)據(jù)源。這種簡(jiǎn)便的方式能夠讓開發(fā)人員免于在開發(fā)期創(chuàng)建和管理復(fù)雜的XML配置，進(jìn)而能夠快速地開發(fā)數(shù)據(jù)庫(kù)驅(qū)動(dòng)的微服務(wù)。如果在classpath中有H2或Derby數(shù)據(jù)庫(kù)的話，這種自動(dòng)化配置也會(huì)生效。Boot所提供的另一個(gè)便利之處就是能夠快速簡(jiǎn)便地使用相關(guān)數(shù)據(jù)啟動(dòng)應(yīng)用的數(shù)據(jù)庫(kù)模式。這在開發(fā)期是非常有用的，此時(shí)數(shù)據(jù)庫(kù)可能是在內(nèi)存中或者是不穩(wěn)定的，開發(fā)人員需要保證的是在應(yīng)用啟動(dòng)的時(shí)候能夠訪問(wèn)到這些特定的數(shù)據(jù)。為了闡述這一點(diǎn)，考慮一下程序清單1.5中的示例JPA實(shí)體，它代表了微服務(wù)所提供的“User”數(shù)據(jù)結(jié)構(gòu)。

程序清單1.5

@Entity class User {@Id@GeneratedValueLong idString usernameString firstNameString lastNameDate createdDateDate lastAccessedBoolean isActive = Boolean.TRUE }

為了啟用代表User對(duì)象的通用數(shù)據(jù)，我們只需創(chuàng)建一個(gè)名為schema.sql或data.sql的文件，并將其包含在classpath之中。這個(gè)文件會(huì)在模式創(chuàng)建完成之后執(zhí)行，所以基于程序清單1.5所給出的實(shí)體，我們可以使用SQL語(yǔ)句啟用一個(gè)用戶賬號(hào)，如程序清單1.6所示。

程序清單1.6

insert into user(username, first_name, last_name, created_date) values ('danveloper', 'Dan', 'Woods', now())

在啟動(dòng)的時(shí)候，我們所提供的SQL代碼會(huì)執(zhí)行，這樣就能確保有一個(gè)測(cè)試賬號(hào)可以使用。微服務(wù)此時(shí)已經(jīng)具有了數(shù)據(jù)訪問(wèn)的起始點(diǎn)，程序清單1.7展現(xiàn)了如何按照Spring Data的開發(fā)模式創(chuàng)建Repository接口，該接口會(huì)作為User實(shí)體的數(shù)據(jù)訪問(wèn)對(duì)象（Data Access Object）。

程序清單1.7

public interface UserRepository extends CrudRepository<User, Long> { }

CrudRepository提供了一些通用的接口方法來(lái)創(chuàng)建、查詢、更新以及刪除對(duì)象和對(duì)象集合。應(yīng)用所需的其他特定功能可以按照Spring Data的Repository開發(fā)約定進(jìn)行定義。一旦UserRepository接口創(chuàng)建成功，Boot的spring-data-jpa層會(huì)在工程中探測(cè)到它，并將其添加到Spring應(yīng)用上下文之中，這樣對(duì)于controller和sevice對(duì)象來(lái)說(shuō)，它就成為可以進(jìn)行自動(dòng)注入的可選對(duì)象。這種自動(dòng)化的配置只有在Boot應(yīng)用要求按照這種方式初始化的時(shí)候才生效，這是通過(guò)存在@EnableAutoConfiguration注解來(lái)標(biāo)識(shí)的。借助程序清單1.8中所實(shí)現(xiàn)的controller，微服務(wù)現(xiàn)在就可以定義RESTful端點(diǎn)了，服務(wù)的使用者可以獲取到User的列表或單個(gè)User。

程序清單1.8

@RestController @EnableAutoConfiguration @RequestMapping("/user") class UserController {@AutowiredUserRepository repository@RequestMapping(method=[RequestMethod.GET])def get(Long id) {id ? repository.findOne(id) : repository.findAll()}public static void main(String[] args) {SpringApplication.run UserController, args} }

在啟動(dòng)的時(shí)候，應(yīng)用將會(huì)輸出日志，表明Hibernate按照User實(shí)體的定義創(chuàng)建數(shù)據(jù)庫(kù)結(jié)構(gòu)，在應(yīng)用初始化的最后，Boot還會(huì)從schema.sql文件中導(dǎo)入數(shù)據(jù)。

在開發(fā)微服務(wù)應(yīng)用時(shí)，需要特別注意的一點(diǎn)是使用了@RequestMapping注解。這不是Boot特定的注解。不過(guò)，因?yàn)锽oot安裝了自己的端點(diǎn)以監(jiān)控應(yīng)用的性能、健康情況以及配置，所以需要確保應(yīng)用的代碼不要與這些內(nèi)置的提供詳情的路徑解析相沖突。鑒于此，如果有從請(qǐng)求路徑中解析屬性的需求（在我們的場(chǎng)景中，也就是user的id屬性），那么我們需要仔細(xì)考慮這個(gè)動(dòng)態(tài)的屬性解析會(huì)對(duì)微服務(wù)的其他行為產(chǎn)生什么影響。在本例中，只是簡(jiǎn)單地將controller映射到/user端點(diǎn)而不是根上下文，就能允許Boot的端點(diǎn)也可以進(jìn)行訪問(wèn)。

微服務(wù)所提供的數(shù)據(jù)并不一定全部適合關(guān)系型結(jié)構(gòu)，針對(duì)這一點(diǎn)Spring Boot也暴露了一些模塊，從而讓開發(fā)人員可以使用Spring Data的MongoDB和Redis項(xiàng)目，不過(guò)依然采取特定的方式來(lái)進(jìn)行配置。Spring Data用來(lái)定義數(shù)據(jù)訪問(wèn)對(duì)象（Data Access Object）的高層框架，這樣快速切換JPA與非JPA數(shù)據(jù)源會(huì)變得非常容易。參見(jiàn)程序清單1.9，它展現(xiàn)了一個(gè)重新定義的UserRepository接口，這個(gè)接口設(shè)計(jì)為使用MongoDB取代JPA。

程序清單1.9

public interface UserRepository extends MongoRepository<User, Long> { }

MongoRepository接口也擴(kuò)展了CrudRepository，因此微服務(wù)的Controller代碼，也就是程序清單1.8所示并不需要修改。為了實(shí)現(xiàn)與MongoDB的集成，工程唯一要做的就是在應(yīng)用的classpath中包含spring-boot-starter-data-mongodb。程序清單1.4所示的Gradle構(gòu)建文件需要稍微調(diào)整一下依賴的部分，如程序清單1.10所示。

程序清單1.10

dependencies {compile 'org.codehaus.groovy:groovy-all:2.2.1'compile "org.springframework.boot:spring-boot-starter-web:$springBootVersion"compile "org.springframework.boot:spring-boot-starter-data-mongodb:$springBootVersion"compile "org.springframework.boot:spring-boot-starter-actuator:$springBootVersion" }

MongoDB依賴都置于classpath之中以后，Boot將會(huì)自動(dòng)配置Spring Data連接到localhost上的數(shù)據(jù)庫(kù)，并且默認(rèn)的數(shù)據(jù)庫(kù)名為test。在這個(gè)庫(kù)中，將會(huì)自動(dòng)創(chuàng)建User集合（按照MongoDB的標(biāo)準(zhǔn)），微服務(wù)現(xiàn)在就能使用MongoDB作為后端了。對(duì)非JPA的數(shù)據(jù)存儲(chǔ)來(lái)說(shuō)，初始化數(shù)據(jù)比其他的方式更為簡(jiǎn)單，這主要是因?yàn)樗荒茚槍?duì)MongoDB的文檔存儲(chǔ)和Redis的鍵值存儲(chǔ)運(yùn)行SQL文件。鑒于Spring Data會(huì)使用這些存儲(chǔ)的持久化實(shí)例，這就意味著開發(fā)期創(chuàng)建的數(shù)據(jù)需要在重啟后保留。為了持久化數(shù)據(jù)，我們需要修改微服務(wù)的controller，這樣服務(wù)的使用者就能創(chuàng)建User實(shí)例了。我們也可以將微服務(wù)的UserController進(jìn)行修改，使其符合通用的RESTful API結(jié)構(gòu)，讓controller以不同的方式處理不同的HTTP方法。程序清單1.11展現(xiàn)了為controller添加創(chuàng)建新User實(shí)例的功能。

程序清單1.11

@RestController @RequestMapping("/user") @EnableAutoConfiguration class UserController {@AutowiredUserRepository repository@RequestMapping(method=[RequestMethod.GET])def get(Long id) {id ? repository.findOne(id) : repository.findAll()}@RequestMapping(method=[RequestMethod.POST])def create(@RequestBody User user) {repository.save useruser}public static void main(String[] args) {SpringApplication.run UserController, args} }

當(dāng)微服務(wù)的使用者往應(yīng)用的端點(diǎn)上發(fā)送一個(gè)HTTP POST請(qǐng)求時(shí)，Spring將會(huì)把請(qǐng)求體轉(zhuǎn)換為User實(shí)例。代碼接下來(lái)會(huì)使用UserRepository將這個(gè)對(duì)象存儲(chǔ)到MongoDB集合之中。使用curl創(chuàng)建User實(shí)例的樣例如程序清單1.12所示。

程序清單1.12

curl -v -H "Content-Type: application/json" -d "{ \"username\": \"danveloper\", \"firstName\": \"Dan\", \"lastName\": \"Woods\", \"createdDate\": \"2014-02-02T00:00:00\" }" http://localhost:8080/user

按照Boot針對(duì)Mongo數(shù)據(jù)源的特定配置，新的User實(shí)例默認(rèn)會(huì)持久化到本地Mongo實(shí)例的test數(shù)據(jù)庫(kù)的user集合之中。如果我們打開web瀏覽器并對(duì)微服務(wù)發(fā)起一個(gè)HTTP GET請(qǐng)求，我們就能看到所創(chuàng)建的user存在于返回的列表之中。

配置

我們可以很快地重寫Spring Boot的默認(rèn)配置。默認(rèn)情況下，應(yīng)用的配置可以使用Java屬性文件來(lái)進(jìn)行定義，這個(gè)文件名為application.properties并且位于應(yīng)用的classpath根目錄下。不過(guò)，一種更好的方式是使用?YAML配置，它提供了結(jié)構(gòu)化以及嵌套的配置。在應(yīng)用的運(yùn)行時(shí)類路徑之中包含snakeyaml之后，你的工程就可以在application.yml文件中直接定義配置了。為了詳述這一點(diǎn)，考慮程序清單1.13的示例YAML配置，這里列出了應(yīng)用的嵌入式HTTP服務(wù)器（默認(rèn)是Tomcat，也可選擇Jetty）的各種設(shè)置項(xiàng)。

程序清單1.13

# Server settings (ServerProperties) server:port: 8080address: 127.0.0.1sessionTimeout: 30contextPath: /# Tomcat specificstomcat:accessLogEnabled: falseprotocolHeader: x-forwarded-protoremoteIpHeader: x-forwarded-forbasedir:backgroundProcessorDelay: 30 # secs

允許重寫B(tài)oot的自動(dòng)化配置，這一點(diǎn)能夠使你的應(yīng)用從原型轉(zhuǎn)化為真正的產(chǎn)品，Boot使用相同的application.yml文件進(jìn)行配置，這樣就會(huì)非常容易。自動(dòng)化配置的指令被設(shè)計(jì)的盡可能簡(jiǎn)短，所以當(dāng)使用actuator構(gòu)建微服務(wù)時(shí)，會(huì)安裝一個(gè)配置屬性的端點(diǎn)，也就是/configprops，當(dāng)確定哪些指令需要重寫時(shí)可以進(jìn)行參考。如果我們的微服務(wù)要使用持久化數(shù)據(jù)源，如MySQL，那么只需將MySQL的Java驅(qū)動(dòng)添加到運(yùn)行時(shí)classpath中，然后在application.yml中添加必要的配置指令即可，如程序清單1.14所示。

程序清單1.14

spring:datasource:driverClassName: com.mysql.jdbc.Driverurl: jdbc:mysql://localhost:3306/proddb username: rootpassword

在一些場(chǎng)景下你可能需要更為靈活的配置，Boot允許你通過(guò)Java的系統(tǒng)屬性（System properties）重寫很多它的默認(rèn)配置。例如，如果你的應(yīng)用需要在部署到產(chǎn)品化環(huán)境中使用不同的數(shù)據(jù)庫(kù)用戶，那么username配置指令可以通過(guò)標(biāo)準(zhǔn)的Java系統(tǒng)屬性傳入到應(yīng)用之中，而這需要切換到命令行中執(zhí)行-Dspring.datasource.username=user。關(guān)于這一點(diǎn)更為現(xiàn)實(shí)的場(chǎng)景是云部署環(huán)境，如Cloud Foundry或Heroku，這些平臺(tái)需要應(yīng)用啟動(dòng)特定的HTTP端口，這一點(diǎn)通過(guò)操作系統(tǒng)的環(huán)境變量可以實(shí)現(xiàn)。Boot能夠從系統(tǒng)屬性繼承得到配置，這樣你的應(yīng)用就可以在命令行中使用-Dserver.port=$PORT來(lái)得到HTTP端口。在開發(fā)微服務(wù)時(shí)，這是一種相當(dāng)有用的特性，因?yàn)樗梢宰屛⒎?wù)應(yīng)用運(yùn)行在各種環(huán)境配置之中。

外部化配置

微服務(wù)必須要支持的很重要的一點(diǎn)就是外部化配置。這種配置可以包含任何的內(nèi)容，從占位符信息到數(shù)據(jù)庫(kù)配置等等，在初始規(guī)劃和構(gòu)建應(yīng)用原型時(shí)，這是必須要考慮的架構(gòu)內(nèi)容。在Spring IO平臺(tái)中，已經(jīng)存在各種導(dǎo)入配置的策略，但是應(yīng)用能夠以多種方式使用配置所造成的后果往往是產(chǎn)生冗長(zhǎng)的編碼性耦合。

Boot一個(gè)很棒的特性在于它能管理外部化的配置并將其轉(zhuǎn)換為對(duì)象結(jié)構(gòu)，這個(gè)對(duì)象可以在整個(gè)應(yīng)用上下文中使用。創(chuàng)建一個(gè)簡(jiǎn)單老式的Java/Groovy對(duì)象（Plain Old Java/Groovy Object），并使用@ConfigurationProperties注解，那么這個(gè)對(duì)象就能使用Boot配置結(jié)構(gòu)中預(yù)先定義的name名下的配置項(xiàng)。更具體一點(diǎn)來(lái)講，考慮一下程序清單1.15中的POGO，它能夠得到application.key下的配置指令。

程序清單1.15

@ConfigurationProperties(name = "application") class ApplicationProperties {String nameString version }

當(dāng)ApplicationProperties對(duì)象在Spring上下文中創(chuàng)建完成之后，Boot將會(huì)識(shí)別出它是一個(gè)配置對(duì)象，并且會(huì)按照運(yùn)行時(shí)classpath之中application.properties或application.yml文件中的配置指令填充它的屬性。因此，如果我們?cè)谖⒎?wù)的application.yml文件中添加application內(nèi)容區(qū)的話，如程序清單1.16所示，那么我們就可以在應(yīng)用的其他部分以編程的方式訪問(wèn)這些配置指令。

程序清單1.16

application:name: sb-ms-custdeplversion: 0.1-CUSTOMER

這些配置指令可以有各種用途，要訪問(wèn)這些指令的唯一要求就是代表它們的POJO/POGO必須是Spring應(yīng)用上下文的成員。Boot能夠?qū)⒁粋€(gè)controller作為Spring Java配置對(duì)象，這樣就能很容易地管理配置bean與應(yīng)用上下文的集成，如程序清單1.17所示。

程序清單1.17

@RestController @Configuration @RequestMapping("/appinfo") @EnableAutoConfiguration class AppInfoController {@AutowiredApplicationProperties applicationProperties@RequestMapping(method=[RequestMethod.GET])def get() {[name: applicationProperties.name,version: applicationProperties.version]}@BeanApplicationProperties applicationProperties() {new ApplicationProperties()}public static void main(String[] args) {SpringApplication.run UserController, args} }

程序清單1.17中的樣例代碼可能有些牽強(qiáng)，不過(guò)，即便是在更為復(fù)雜的場(chǎng)景下，如何使用Boot來(lái)訪問(wèn)應(yīng)用特定配置的原則是相同的。配置類也支持嵌套式的對(duì)象圖，這樣來(lái)自于配置中的深層數(shù)據(jù)就能更便利地進(jìn)行訪問(wèn)，也有了更好的語(yǔ)義。例如，如果我們想要得到的配置指令是application.根下的那些metrics key，那么可以在ApplicationProperties?POGO中添加一個(gè)嵌套對(duì)象來(lái)表示這些值，如程序清單1.18所示。

程序清單1.18

@ConfigurationProperties(name = "application") class ApplicationProperties {String nameString versionfinal Metrics metrics = new Metrics()static class Metrics {String dbExecutionTimeKey} }

現(xiàn)在，我們的application.yml文件可以如程序清單1.19所示，它在application.代碼塊中包含了metrics配置。

程序清單1.19

application:name: sb-ms-custdeplversion: 0.1-CUSTOMERmetrics:dbExecutionTimeKey: user.get.db.time

當(dāng)我們需要訪問(wèn)application.metrics.dbExecutionTimeKey的值時(shí)，能夠以編程的方式通過(guò)ApplicationProperties對(duì)象來(lái)進(jìn)行訪問(wèn)。

為了在整個(gè)應(yīng)用之中使用application.properties或application.yml文件中的這些配置指令，我們并不是必須要將其轉(zhuǎn)換為對(duì)象圖。Boot也為Spring應(yīng)用上下文提供了PropertySourcesPlaceholderConfiguration，這樣的話，來(lái)自于application.properties或application.yml文件的指令或者來(lái)自于Java系統(tǒng)的重寫屬性都可以作為Spring屬性占位符來(lái)使用。Spring的這種機(jī)制能夠讓你以一種特定的語(yǔ)法來(lái)為屬性定義占位符值，如果Spring發(fā)現(xiàn)了占位符配置的話，就會(huì)用這個(gè)配置來(lái)進(jìn)行填充。作為示例，我們可以在controller中使用@Value注解來(lái)直接訪問(wèn)application.metrics.dbExecutionTimeKey，如程序清單1.20所示。

程序清單1.20

@RestController @RequestMapping("/user") @EnableAutoConfiguration class UserController {@AutowiredUserRepository repository@AutowiredGaugeService gaugeService@Value('${application.metrics.dbExecutionTimeKey}')String dbExecutionKey@RequestMapping(method=[RequestMethod.GET])def get(Long id) {def start = new Date().timedef result = id ? repository.findOne(id) : repository.findAll()gaugeService.submit dbExecutionKey, new Date().time - startresult}public static void main(String[] args) {SpringApplication.run UserController, args} }

關(guān)于應(yīng)用指標(biāo)的報(bào)告，后面會(huì)有更為詳細(xì)的介紹，但現(xiàn)在重要的一點(diǎn)在于，理解@Value注解如何與Spring屬性占位符一起使用，使Boot能夠自動(dòng)注入值，從而滿足這個(gè)微服務(wù)的特定配置需求。

安全

在微服務(wù)的開發(fā)中，對(duì)于完備安全場(chǎng)景的需求會(huì)持續(xù)增長(zhǎng)。為了滿足這種需求，Boot引入了強(qiáng)大完整的Spring Security，并且提供了自動(dòng)配置的功能，以快速簡(jiǎn)便地啟用安全層。只需在應(yīng)用的classpath中包含spring-boot-starter-security模塊就能使Boot引入一些安全特性，如跨站腳本防護(hù)（cross-site scripting protection）并且會(huì)添加頭信息以防止點(diǎn)擊劫持（click-jacking）。除此之外，添加一條簡(jiǎn)單的配置指令就能啟用基本認(rèn)證來(lái)保護(hù)你的應(yīng)用，如程序清單1.21所示。

程序清單1.21

security:basic:enabled: true

Boot會(huì)為你提供一個(gè)默認(rèn)的用戶賬號(hào)user和默認(rèn)角色USER，并且會(huì)在應(yīng)用啟動(dòng)的時(shí)候在控制臺(tái)上輸出隨機(jī)生成的密碼。就像Boot的其他功能那樣，對(duì)于內(nèi)置的user賬號(hào)，我們可以很容易地指定不同的用戶名和密碼（分別為“secured”和“foo”），這需要通過(guò)明確定義的配置指令來(lái)實(shí)現(xiàn)，如程序清單1.22所示。

程序清單1.22

security:basic:enabled: trueuser:name: securedpassword: foo

對(duì)于簡(jiǎn)單的內(nèi)部應(yīng)用或開發(fā)原型來(lái)說(shuō)，Boot內(nèi)置的基礎(chǔ)設(shè)施能夠快速地在微服務(wù)中啟用基本認(rèn)證，這是非常有用的。隨著需求的演化，你的應(yīng)用毫無(wú)疑問(wèn)會(huì)需要更細(xì)粒度的安全特性，如保護(hù)端點(diǎn)只能由特定的角色訪問(wèn)。從這個(gè)角度來(lái)看，我們可能希望具有USER角色的調(diào)用者只能讀取數(shù)據(jù)（即GET請(qǐng)求），而對(duì)具有ADMIN角色的調(diào)用者可以讀取和寫入數(shù)據(jù)（即POST請(qǐng)求）。為了做到這一點(diǎn)，我們需要在工程的application.yml文件中禁用Boot的基本認(rèn)證自動(dòng)配置功能，并且定義我們自己的user和admin賬號(hào)以及對(duì)應(yīng)的角色。當(dāng)你的需求超過(guò)Boot所提供的默認(rèn)功能時(shí)，它通常很快就能實(shí)現(xiàn)，這可以作為佐證這一點(diǎn)的又一個(gè)例子。為了更具體地闡述這一點(diǎn)，考慮一下程序清單1.23中的代碼。這個(gè)樣例可以闡述如何發(fā)揮Spring Security所有潛在的功能以及更為復(fù)雜的認(rèn)證策略，如基于JDBC后端、OpenID或單點(diǎn)登錄（Single-Sign On）。

程序清單1.23

@RestController @RequestMapping("/user") @Configuration @EnableGlobalMethodSecurity(securedEnabled = true) @EnableAutoConfiguration class UserController extends WebSecurityConfigurerAdapter {@AutowiredUserRepository repository@RequestMapping(method = [GET])@Secured(['ROLE_USER'])def get(Long id) {id ? repository.findOne(id) : repository.findAll()}@RequestMapping(method = [POST])@Secured(['ROLE_ADMIN'])def create(@RequestBody User user) {repository.save useruser}@Overridevoid configure(AuthenticationManagerBuilder auth) {auth.inMemoryAuthentication().withUser "user" password "password" roles "USER" and() withUser "admin" password "password" roles "USER", "ADMIN"}@Overridevoid configure(HttpSecurity http) throws Exception {BasicAuthenticationEntryPoint entryPoint = new BasicAuthenticationEntryPoint()entryPoint.realmName = "Spring Boot"http.exceptionHandling().authenticationEntryPoint(entryPoint)http.requestMatchers().antMatchers("/**").anyRequest().and().httpBasic().and().anonymous().disable().csrf().disable()}public static void main(String[] args) {SpringApplication.run UserController, args} }

在程序清單1.23的樣例之中，應(yīng)用現(xiàn)在被明確地配置為要基于user和admin用戶賬號(hào)進(jìn)行訪問(wèn)，它們的密碼都是password，具有的角色分別是USER和ADMIN。微服務(wù)的GET和POST端點(diǎn)分別通過(guò)USER和ADMIN角色進(jìn)行保護(hù)，這就意味著普通用戶可以訪問(wèn)只讀的數(shù)據(jù)，而執(zhí)行讀取-寫入操作的話，需要admin用戶憑證。

對(duì)于微服務(wù)來(lái)說(shuō)，基本認(rèn)證是很好的一個(gè)選擇，因?yàn)樗裱撕軐?shí)用且廣泛使用的認(rèn)證協(xié)議。換句話說(shuō)，很多的API調(diào)用者，包括移動(dòng)應(yīng)用，能夠很容易地使用這一點(diǎn)來(lái)訪問(wèn)你的微服務(wù)。當(dāng)你的認(rèn)證需求超過(guò)了基本認(rèn)證的功能時(shí)（如OpenID或OAuth），微服務(wù)可以使用Spring Security的全部功能來(lái)滿足你的需求。

消息集成

在任何的應(yīng)用中，消息（messaging）都是一種很強(qiáng)大的工具，在一點(diǎn)上，微服務(wù)當(dāng)然也不能例外。使用消息驅(qū)動(dòng)架構(gòu)開發(fā)的應(yīng)用能夠更好地支持可重用性和擴(kuò)展性。Spring Boot能夠讓開發(fā)人員在編寫微服務(wù)時(shí)將消息作為架構(gòu)的核心組成部分，它使用到了Spring IO平臺(tái)的企業(yè)集成模式（Enterprise Integration Patterns）實(shí)現(xiàn)，即Spring Integration。Spring Integration提供了開發(fā)消息驅(qū)動(dòng)架構(gòu)的基本結(jié)構(gòu)，以及與分布式企業(yè)平臺(tái)集成的模塊。這種能力使得微服務(wù)可以使用來(lái)自抽象消息源的業(yè)務(wù)對(duì)象，這些消息源可以在應(yīng)用內(nèi)部，也可能是組織機(jī)構(gòu)內(nèi)部的其他服務(wù)所提供的。

盡管Boot并沒(méi)有提供明確的Spring上下文自動(dòng)化配置，但是它為Spring Integration提供了一個(gè)starter模塊，它會(huì)負(fù)責(zé)引入Spring Integration項(xiàng)目的一系列依賴。這些依賴包括Spring Integration的核心庫(kù)（Core library）、HTTP模塊（用來(lái)進(jìn)行面向HTTP的企業(yè)集成）、IP模塊（用來(lái)進(jìn)行基于Socket的集成操作）、File模塊（用于進(jìn)行文件系統(tǒng)集成）以及Stream模塊（用于支持使用Stream的操作，如stdin和stdout）。這個(gè)starter模塊為開發(fā)人員提供了健壯的消息功能的工具集，可以使已有的基礎(chǔ)設(shè)施適應(yīng)微服務(wù)API。

除了starter模塊，Boot也為通過(guò)CLI構(gòu)建的應(yīng)用提供了編譯器自動(dòng)配置的功能。對(duì)于需要快速構(gòu)建微服務(wù)原型并驗(yàn)證可行性的開發(fā)者來(lái)說(shuō)，這種方式提供了一些捷徑。使用企業(yè)級(jí)平臺(tái)的應(yīng)用可以快速地進(jìn)行開發(fā)，在轉(zhuǎn)移到正式的工程和構(gòu)建系統(tǒng)之前，就能確認(rèn)其價(jià)值。使用Spring Boot和Spring Integration使一個(gè)消息驅(qū)動(dòng)的微服務(wù)運(yùn)行起來(lái)非常簡(jiǎn)單，如程序清單1.24的樣例代碼所示。

程序清單1.24

@RestController @EnableIntegrationPatterns class App {@Beandef userLookupChannel() {new DirectChannel()}@Beandef userTemplate() {new MessagingTemplate(userLookupChannel())}@RequestMapping(method=[RequestMethod.GET])def get(@RequestParam(required=false) Long id) {userTemplate().convertSendAndReceive( id ? id : "")} }class User {Long id }@MessageEndpoint class UserLookupObject {@ServiceActivator(inputChannel="userLookupChannel")def get(Long id) {id ? new User(id:id) : new User()} }

使用消息驅(qū)動(dòng)的方式來(lái)進(jìn)行微服務(wù)的開發(fā)能提供很大的代碼可重用性，并且能夠與底層的服務(wù)提供者實(shí)現(xiàn)相解耦。在更為正式的場(chǎng)景之中，程序清單1.24的代碼可能會(huì)負(fù)責(zé)組合數(shù)據(jù)，這些數(shù)據(jù)可能來(lái)自于數(shù)據(jù)庫(kù)調(diào)用和企業(yè)組織中某個(gè)外部的服務(wù)集成。Spring Integration具有內(nèi)置的設(shè)施用來(lái)進(jìn)行負(fù)載路由（payload routing）和處理器鏈（handler chaining），這對(duì)于組合不同的數(shù)據(jù)來(lái)說(shuō)，是一個(gè)很有吸引力的方案，我們的微服務(wù)可以作為一個(gè)數(shù)據(jù)的提供者（provider）。

提供度量指標(biāo)

微服務(wù)最重要的一個(gè)特性可能就是為報(bào)表終端（reporting agent）提供度量指標(biāo)。不像那些功能完備的Web應(yīng)用，微服務(wù)是輕量級(jí)的，設(shè)計(jì)時(shí)可能就不會(huì)規(guī)劃提供報(bào)表界面或完備的接口來(lái)分析服務(wù)的活動(dòng)。這種類型的操作最好是留給專門進(jìn)行數(shù)據(jù)聚合和分析的應(yīng)用，這些數(shù)據(jù)能夠用來(lái)進(jìn)行穩(wěn)定性、性能以及商務(wù)智能的監(jiān)控。基于這樣的前提，微服務(wù)應(yīng)該為這些工具提供端點(diǎn)，從而更加容易地獲取有關(guān)該服務(wù)活動(dòng)的數(shù)據(jù)。而報(bào)表工具負(fù)責(zé)將數(shù)據(jù)聚合到一個(gè)視圖或報(bào)告中，對(duì)于關(guān)心數(shù)據(jù)的人這才是有意義的。

微服務(wù)的一些指標(biāo)如穩(wěn)定性和性能，對(duì)所有的應(yīng)用都是通用的，但是與業(yè)務(wù)操作相關(guān)的指標(biāo)必須由應(yīng)用本身來(lái)具體進(jìn)行管理。針對(duì)這一點(diǎn)，Spring Boot的actuator模塊為開發(fā)人員提供了一種機(jī)制，允許開發(fā)人員通過(guò)/metrics端點(diǎn)以編碼的方式暴露微服務(wù)狀態(tài)的細(xì)節(jié)。Boot將指標(biāo)拆分為“counter”和“gauge”兩種類別：counter是所有以Number類型來(lái)展現(xiàn)的指標(biāo)，而gauge是衡量雙精度計(jì)算的指標(biāo)。為了讓微服務(wù)的開發(fā)人員更加容易地使用指標(biāo)，Boot暴露了CounterService和GaugeService，它們可以自動(dòng)織入到應(yīng)用上下文之中。請(qǐng)參見(jiàn)程序清單1.25的樣例，它闡述了如何通過(guò)CounterService對(duì)外暴露點(diǎn)擊數(shù)。

程序清單1.25

@RestController @RequestMapping("/user") @EnableAutoConfiguration class UserController {@AutowiredUserRepository repository@AutowiredCounterService counterService@RequestMapping(method = [GET])def get() {get(null)}@RequestMapping(value="/{id}", method = [GET])def get(@PathVariable Long id) {counterService.increment id ? "queries.by.id.$id" : "queries.without.id"id ? repository.findOne(id) : repository.findAll()} }

在點(diǎn)擊/user端點(diǎn)時(shí)，有可能提供ID也有可能不提供ID，/metrics端點(diǎn)都會(huì)在counter.父節(jié)點(diǎn)下記錄新的key。例如，如果我們只是查詢/user端點(diǎn)而不帶有ID的話，那么就會(huì)注冊(cè)counter.queries.without.id指標(biāo)。類似的，如果我們帶有ID的話，那么就會(huì)看到有一個(gè)counter.queries.by.id.<id>的key，它能用來(lái)標(biāo)記對(duì)于給定的ID已經(jīng)進(jìn)行了多少次查詢。這些指標(biāo)可能會(huì)有助于掌握最經(jīng)常訪問(wèn)的User對(duì)象并指導(dǎo)要采取的行為，如緩存或數(shù)據(jù)庫(kù)索引。類似于遞增指標(biāo)的數(shù)值，CounterService也允許將指標(biāo)的值將為零。這對(duì)于跟蹤打開的連接數(shù)或其他頻率分布（histographic）的測(cè)量都是很有用處的。

gauge是稍微有所不同的一種類型指標(biāo)，它會(huì)進(jìn)行探索性的計(jì)算或基于請(qǐng)求來(lái)確定值。如GaugeService的JavaDocs所述，“gauge”可以測(cè)量任意的值，從方法執(zhí)行的次數(shù)到會(huì)議室的溫度。當(dāng)需要為報(bào)表工具暴露細(xì)節(jié)時(shí)，這種類型的測(cè)量尤其適合于使用GaugeService。gauge的指標(biāo)會(huì)在/metrics端點(diǎn)之下進(jìn)行訪問(wèn)，并且?guī)в術(shù)auge.前綴。它們的注冊(cè)方式與counter有些差別，如程序清單1.26所示。

程序清單1.26

@RestController @RequestMapping("/user") @EnableAutoConfiguration class UserController {@AutowiredUserRepository repository@AutowiredCounterService counterService@RequestMapping(method = [GET])def get() {get(null)}@RequestMapping(value="/{id}", method = [GET])def get(@PathVariable Long id) {def start = new Date().timedef result = id ? repository.findOne(id) : repository.findAll()def time = new Date().time - startgaugeService.submit("user.get.db.time", time.doubleValue())result} }

默認(rèn)情況下，指標(biāo)會(huì)存儲(chǔ)在一個(gè)易失的內(nèi)存數(shù)據(jù)庫(kù)之中，但Boot同時(shí)也為應(yīng)用上下文提供了MetricsRepository實(shí)現(xiàn)，它能支持更為持久化的行為。Boot自帶了一個(gè)RedisMetricsRepository，它能夠自動(dòng)織入進(jìn)來(lái)，從而將指標(biāo)存儲(chǔ)到Redis值存儲(chǔ)之中，另外，可以編寫自定義的實(shí)現(xiàn)將指標(biāo)存儲(chǔ)到任意的數(shù)據(jù)存儲(chǔ)形式之中。

Boot還提供了對(duì)Coda Hale Metrics庫(kù)的支持，它會(huì)將以特定名稱開頭的指標(biāo)強(qiáng)制轉(zhuǎn)換為對(duì)應(yīng)的Metrics類型。例如，如果有一個(gè)指標(biāo)是以histogram.開頭，那么這個(gè)值將會(huì)作為Histogram對(duì)象類型。這種自動(dòng)化的強(qiáng)制轉(zhuǎn)換對(duì)于meter.和timer.key也是有效的，而普通的指標(biāo)將會(huì)作為Gauge類型。

一旦微服務(wù)的指標(biāo)在Boot中進(jìn)行了注冊(cè)，那么報(bào)表工具就可以通過(guò)/metrics端點(diǎn)來(lái)檢索它們。已命名的指標(biāo)可以通過(guò)/metrics端點(diǎn)獲取，只需將指標(biāo)的key名作為查詢字符串的一部分即可。例如，如果只是訪問(wèn)gauge指標(biāo)下的“user.get.db.time”，報(bào)表工具可以針對(duì)/metrics/gauge.user.get.db.time進(jìn)行查詢。

打包Boot應(yīng)用

正如前面所討論的，Boot提供了Maven和Gradle插件，它為構(gòu)建系統(tǒng)的打包階段提供了一種鉤子（hook），以產(chǎn)生所謂的“胖jar”，在這種jar中包含了工程的所有依賴。當(dāng)這個(gè)胖jar包執(zhí)行時(shí)，應(yīng)用將會(huì)運(yùn)行在與工程開發(fā)期相同的嵌入式容器之中。這種簡(jiǎn)便的方式能夠讓開發(fā)人員省去很多麻煩，因?yàn)樗麄兊牟渴鸢陂_發(fā)期和運(yùn)行時(shí)環(huán)境之中具有相同的依賴結(jié)構(gòu)。這也能夠緩解運(yùn)維團(tuán)隊(duì)的焦慮，他們不用擔(dān)心部署的場(chǎng)景，因?yàn)樵诓渴饡r(shí)一個(gè)錯(cuò)誤配置的運(yùn)行時(shí)容器可能會(huì)帶有某個(gè)特定的依賴，而在項(xiàng)目的開發(fā)期所依賴的可能是另外一個(gè)。

為了在Maven下執(zhí)行打包，只需執(zhí)行mvn package命令。Spring Boot的插件會(huì)備份工程所創(chuàng)建的原始jar并且在文件名上添加“.original”。在這里，能夠得到可運(yùn)行的jar，文件符合Maven artifact的命名約定，它可以按照工程最合適的方式進(jìn)行部署。使用Gradle構(gòu)建Boot工程同樣很簡(jiǎn)單，只需執(zhí)行標(biāo)準(zhǔn)的gradle build命令即可。類似于Maven，Boot插件在原有的打包任務(wù)之后使用Gradle安裝了一個(gè)生命周期事件，并且會(huì)在build/libs目錄下創(chuàng)建胖jar包。對(duì)所生成的胖jar包進(jìn)行檢查的一種方式就是所有依賴的jar都會(huì)位于歸檔文件的lib/目錄下。

打包完成之后，胖jar包就能夠像其他可運(yùn)行的jar文件那樣在命令行中執(zhí)行了，也就是使用$JAVA_HOME/bin/java -jar path/to/myproject.jar命令。啟動(dòng)后，Boot應(yīng)用的日志將會(huì)顯示在控制臺(tái)上。

對(duì)于需要部署到傳統(tǒng)servlet容器之中的應(yīng)用，Boot提供了一種方式以編碼的方式初始化Web配置。為了使用這一點(diǎn)，Boot提供了可選的WebApplicationInitializer，它會(huì)使用servlet容器來(lái)注冊(cè)應(yīng)用，這會(huì)通過(guò)Servlet 3.0 API以編碼的方式注冊(cè)servlet并且會(huì)用到ServletContext。通過(guò)提供SpringBootServletInitializer的子類，Boot應(yīng)用能夠使用嵌入的Spring上下文來(lái)注冊(cè)配置，這個(gè)Spring上下文是在容器初始化的時(shí)候創(chuàng)建的。為了闡述這個(gè)功能，考慮程序清單1.27中的示例代碼。

程序清單1.27

@RestController @EnableAutoConfiguration class Application extends SpringBootServletInitializer {@RequestMapping(method = RequestMethod.GET)String get() {"home"}static void main(String[] args) {SpringApplication.run this, args}@OverrideSpringApplicationBuilder configure(SpringApplicationBuilder application) {application.sources Application} }

Application類中被重寫的configure方法就是使用嵌入式的Spring上下文注冊(cè)應(yīng)用的地方。在更為正式的場(chǎng)景之中，這個(gè)方法可能會(huì)用來(lái)注冊(cè)Spring Java配置類，它會(huì)定義應(yīng)用中所有controller和服務(wù)的bean。

當(dāng)將應(yīng)用打包部署到servlet容器之中時(shí)，工程要構(gòu)建為一個(gè)war文件。在Maven工程中，為了適應(yīng)這一點(diǎn)，需要移除Boot插件，并且packaging需要明確定義為“war”類型，如程序清單1.28所示。

程序清單1.28

<?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>com.example</groupId><artifactId>myproject</artifactId><version>1.0.0-SNAPSHOT</version><packaging>war</packaging><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>1.0.0.RC1</version></parent><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency></dependencies><repositories><repository><id>spring-snapshots</id><url>http://repo.spring.io/libs-snapshot</url></repository></repositories> </project>

對(duì)這個(gè)工程執(zhí)行mvn install命令會(huì)在target目錄下生成myproject-1.0.0-SNAPSHOT.war文件。使用Gradle構(gòu)建的工程可以使用Gradle War Plugin，它為構(gòu)建war文件暴露了一個(gè)war任務(wù)。類似于Maven的配置，Boot Gradle工程也需要移除所包含的Boot插件。產(chǎn)生war文件的示例Gradle構(gòu)建腳本如程序清單1.29所示。

程序清單1.29

apply plugin: 'java' apply plugin: 'war'repositories {mavenCentral()maven { url "http://repo.spring.io/snapshot" }maven { url "http://repo.spring.io/milestone" } }ext {springBootVersion = '1.0.0.BUILD-SNAPSHOT' }dependencies {compile "org.springframework.boot:spring-boot-starter-web:${springBootVersion}"compile "org.springframework.boot:spring-boot-starter-actuator:${springBootVersion}" }

對(duì)于Boot工程，使用這個(gè)構(gòu)建腳本運(yùn)行Gradle的war任務(wù)將會(huì)在build/libs目錄下產(chǎn)生war文件。

不管是Maven還是Gradle的配置，一旦war文件產(chǎn)生，它就可以部署到任意兼容Servlet 3.0的應(yīng)用服務(wù)器之中。部分兼容的容器包括Tomcat 7+、Jetty 8、Glassfish 3.x、JBoss AS 6.x/7.x以及Websphere 8.0。

延伸閱讀

Spring Boot團(tuán)隊(duì)已經(jīng)編寫了完整的指導(dǎo)和樣例來(lái)闡述框架的功能。Blog文章、參考資料以及API文檔都可以在Spring.IO網(wǎng)站上找到。項(xiàng)目的GitHub頁(yè)面上可以找到示例的工程，更為具體的細(xì)節(jié)可以閱讀Spring Boot的參考手冊(cè)。SpringSourceDev YouTube頻道有一個(gè)關(guān)于Spring Boot的webinar，它概述了這個(gè)項(xiàng)目的目標(biāo)和功能。在去年在倫敦舉行的Groovy & Grails Exchange上，David Dawson做了一個(gè)使用Spring Boot開發(fā)微服務(wù)的演講。

?

總結(jié)

以上是生活随笔為你收集整理的深入学习微框架：Spring Boot的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。