使用Spring Boot快速構建應用

作者張衛濱發佈於 2014年1月21日 | 4 討論

隨着Spring 4新版本的發佈，Spring Boot這個新的子項目得到了廣泛的關注，因爲不管是Spring 4官方發佈的新聞稿還是針對首席架構師Adrian Colyer的專訪，都對這個子項目所帶來的生產率提升讚譽有加。

Spring Boot充分利用了JavaConfig的配置模式以及“約定優於配置”的理念，能夠極大的簡化基於Spring MVC的Web應用和REST服務開發。

Spring 4倡導微服務的架構，針對這一理念，近來在微博上也有一些有價值的討論，如這裏和這裏。微服務架構倡導將功能拆分到離散的服務中，獨立地進行部署，Spring Boot能夠很方便地將應用打包成獨立可運行的JAR包，因此在開發模式上很契合這一理念。目前，Spring Boot依然是0.5.0的里程碑版本，因此相關的文檔尚不完善，本文將會以一個簡單的樣例來介紹基於這個項目的開發過程。

要Spring Boot進行功能開發，需要使用Gradle或者Maven作爲構建工具。在本例中，我們會使用Eclipse和Maven插件進行開發。要使用 Spring Boot，首先創建一個Maven工程，並修改Maven主要的配置文件pom.xml，如下所示：

<parent>
       <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>0.5.0.M7</version>
 </parent>
  <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.thymeleaf</groupId>
            <artifactId>thymeleaf-spring3</artifactId>
        </dependency>
    </dependencies>

    <properties>
        <start-class>com.levin.Application</start-class>
    </properties>

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

    <repositories>
        <repository>
            <id>spring-milestone</id>
            <url>http://repo.spring.io/libs-milestone</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>

    <pluginRepositories>
        <pluginRepository>
            <id>spring-milestone</id>
            <url>http://repo.spring.io/libs-milestone</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </pluginRepository>
    </pluginRepositories>

在上面的配置中，需要將工程的parent設置爲spring-boot-starter-parent，並添加對spring-boot- starter-web的依賴，這樣我們就無需設置各個依賴項及其版本信息了。並且在構建中要聲明使用spring-boot-maven-plugin 這個插件，它會對Maven打包形成的JAR進行二次修改，最終產生符合我們要求的內容結構。

在我們的應用中將要發佈一個REST服務，顯示一個基本的用戶信息，首先定義一個簡單的模型類：

	
	package com.levin;

public class Person {
	private String name;
	private String email;
	
	public Person(String name, String email) {
		this.name = name;
		this.email = email;
	}
	
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getEmail() {
		return email;
	}
	public void setEmail(String email) {
		this.email = email;
	}
	
}

接下來，我們需要聲明一個Spring MVC的Controller，響應對實體的請求：

@Controller
public class ShowPersonController {
    @RequestMapping("/showPerson")
    public @ResponseBody Person showPerson() {
        return new Person("levinzhang","[email protected]");
    }
}

這個類與我們在使用Spring MVC定義Controller時並無任何差別。接下來，我們需要聲明一個主類啓動這個應用程序：

@ComponentScan
@EnableAutoConfiguration
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

這個類的main方法中使用了SpringApplication幫助類，並以Application這個類作爲配置來啓動Spring的應用上下文。在這個類中使用了ComponentScan以及EnableAutoConfiguration註解，其中ComponentScan註解會告知 Spring掃描指定的包來初始化Spring Bean，這能夠確保我們聲明的Bean能夠被發現。EnableAutoConfiguration將會啓動自動配置模式，在我們的配置中會將對 Tomcat的依賴級聯進來，因此在應用啓動時將會自動啓動一個嵌入式的Tomcat，因爲在樣例中使用了Spring MVC，所以也會自動註冊所需的DispatcherServlet，這都不需要類似web.xml這樣的配置。

在Eclipse中要運行這個應用的話，可以直接以Java Application的形式來運行這個main函數，此時會啓動應用，我們在瀏覽器中可以看到如下的運行效果，這就是我們想要的REST服務：

在開發調試完成之後，可以將應用打成JAR包的形式，在Eclipse中可以直接使用Maven插件的package命令，最終會形成一個可運行的 JAR包。我們使用java –jar命令就可以運行這個JAR包了。所呈現出的效果與在調試期是一樣的。現在看一下這個JAR包解壓後的目錄結構：

這個JAR包與傳統JAR包的不同之處在於裏面有一個名爲lib的目錄，在這個目錄中包含了這個簡單應用所依賴的其他JAR包，其中也包含內置的嵌入式Tomcat，正是使用它，才能發佈服務和訪問Web資源。除了我們編寫的源碼所編譯形成的CLASS以外，在org目錄下還有許多Spring所提供的CLASS，正是依賴這些CLASS，才能夠加載位於lib目錄下JAR中的類。這樣的加載機制與在OSGi bundle中聲明Bundle-Classpath很類似，不過在OSGi中會由容器來負責加載指定路徑下的類。這大致闡述了這樣一個JAR包能夠發佈服務的原因。

如果我們想要使用HTML、JSP等Web資源的話，在Controller中直接返回對應的視圖就可以了。

如果我們想要將這個JAR包轉換成可以在Servlet容器中部署的WAR的話，就不能依賴於Application的main函數了，而是要以類似於web.xml文件配置的方式來啓動Spring應用上下文，此時我們需要聲明這樣一個類：

public class HelloWebXml extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Application.class);
    }

}

這個類的作用與在web.xml中配置負責初始化Spring應用上下文的監聽器作用類似，只不過在這裏不需要編寫額外的XML文件了。

如果要將最終的打包形式改爲WAR的話，還需要對pom.xml文件進行修改，除了需要將packaging的值修改爲war以外，還需要對依賴進行適當的配置（這一部分在Spring Boot的樣例和文檔中均未提及，提醒大家注意）：

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId> 
           <exclusions>
           	<exclusion>
           		<groupId>org.springframework.boot</groupId>
        		<artifactId>spring-boot-starter-tomcat</artifactId>
           	</exclusion>
           </exclusions> 
</dependency>

在這裏需要移除對嵌入式Tomcat的依賴，這樣打出的WAR包中，在lib目錄下纔不會包含Tomcat相關的JAR包，否則將會出現啓動錯誤。另外，在移除對Tomcat的依賴後，爲了保證編譯正確，還需要添加對servlet-api的依賴，因此添加如下的配置：

		
<dependency>
        	<groupId>org.apache.tomcat</groupId>
        	<artifactId>tomcat-servlet-api</artifactId>
        	<version>7.0.42</version>
        	<scope>provided</scope>
</dependency>

在這裏將scope屬性設置爲provided，這樣在最終形成的WAR中不會包含這個JAR包，因爲Tomcat或Jetty等服務器在運行時將會提供相關的API類。此時，執行mvn package命令就會得到一個WAR文件，我們可以直接將其放到Tomcat下運行（需要7.0.42版本以上）。

以上介紹了基於Spring Boot開發應用的過程，目前它的文檔尚不完善，但是在GitHub上有不少的樣例，包括與Spring Data集成訪問數據庫（關係型以及非關係型）、安全、WebSocket等，讀者感興趣可以下載運行，需要注意的是有些樣例中使用的是0.5.0.M6版本，這個版本有問題，運行時會出錯，建議手動修改爲0.5.0.M7或快照版本。

基於以上的介紹，希望讀者能夠對Spring Boot這個新項目有所瞭解。它簡化了JAR包管理和相關基礎設施環境的配置，能夠幫助我們快速開發Web應用或構建REST服務，希望它能夠儘快完善成熟，更多地用於實踐，提升開發效率。

來源： <http://www.infoq.com/cn/news/2014/01/spring-boot/>