使用Spring Boot快速構建應用

隨着Spring 4新版本的發佈,Spring Boot這個新的子項目獲得了普遍的關注,由於不論是Spring 4官方發佈的新聞稿仍是針對首席架構師Adrian Colyer的專訪,都對這個子項目所帶來的生產率提高讚譽有加。html


Spring Boot充分利用了JavaConfig的配置模式以及「約定優於配置」的理念,可以極大的簡化基於Spring MVC的Web應用和REST服務開發。java


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


要Spring Boot進行功能開發,須要使用Gradle或者Maven做爲構建工具。在本例中,咱們會使用Eclipse和Maven插件進行開發。要使用 Spring Boot,首先建立一個Maven工程,並修改Maven主要的配置文件pom.xml,以下所示:github

 

Pom.xml代碼  收藏代碼web

  1. <properties>  spring

  2.     <java.version>1.7</java.version>  數據庫

  3.     <start-class>com.test.springboot.Startup</start-class>  apache

  4. </properties>  api

  5. <!-- Inherit defaults from Spring Boot -->  瀏覽器

  6. <parent>  

  7.     <groupId>org.springframework.boot</groupId>  

  8.     <artifactId>spring-boot-starter-parent</artifactId>  

  9.     <version>1.0.1.RELEASE</version>  

  10. </parent>  

  11.   

  12. <!-- Add typical dependencies for a web application -->  

  13. <dependencies>  

  14.     <dependency>  

  15.         <groupId>org.springframework.boot</groupId>  

  16.         <artifactId>spring-boot-starter-web</artifactId>  

  17.     </dependency>  

  18. </dependencies>  

  19.   

  20. <build>  

  21.     <pluginManagement>  

  22.         <plugins>  

  23.             <plugin>  

  24.                 <artifactId>maven-compiler-plugin</artifactId>  

  25.                 <configuration>  

  26.                     <source>1.7</source>  

  27.                     <target>1.7</target>  

  28.                 </configuration>  

  29.             </plugin>  

  30.         </plugins>  

  31.     </pluginManagement>  

  32. </build>  

  33.   

  34. <repositories>  

  35.     <repository>  

  36.         <id>spring-snapshots</id>  

  37.         <url>http://repo.spring.io/snapshot</url>  

  38.         <snapshots>  

  39.             <enabled>true</enabled>  

  40.         </snapshots>  

  41.     </repository>  

  42.     <repository>  

  43.         <id>spring-milestones</id>  

  44.         <url>http://repo.spring.io/milestone</url>  

  45.     </repository>  

  46. </repositories>  

  47. <pluginRepositories>  

  48.     <pluginRepository>  

  49.         <id>spring-snapshots</id>  

  50.         <url>http://repo.spring.io/snapshot</url>  

  51.     </pluginRepository>  

  52.     <pluginRepository>  

  53.         <id>spring-milestones</id>  

  54.         <url>http://repo.spring.io/milestone</url>  

  55.     </pluginRepository>  

  56. </pluginRepositories>  

 

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


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

 

User代碼  收藏代碼

  1. public class User {  

  2.     private Long id;    

  3.     private String name;    

  4.     

  5.     public Long getId() {    

  6.         return id;    

  7.     }    

  8.     

  9.     public void setId(Long id) {    

  10.         this.id = id;    

  11.     }    

  12.     

  13.     public String getName() {    

  14.         return name;    

  15.     }    

  16.     

  17.     public void setName(String name) {    

  18.         this.name = name;    

  19.     }      

  20. }  

 

接下來,咱們須要聲明一個Spring MVC的Controller,響應對實體的請求:

 

Usercontroller代碼  收藏代碼

  1. //@EnableAutoConfiguration  

  2. @RestController    

  3. @RequestMapping("/user")   

  4. public class UserController {  

  5.     @RequestMapping("/{id}")    

  6.     public User view(@PathVariable("id") Long id) {    

  7.         User user = new User();    

  8.         user.setId(id);    

  9.         user.setName("zhang");    

  10.         return user;    

  11.     }    

  12.     

  13.     //public static void main(String[] args) {    

  14.     //    SpringApplication.run(UserController.class);    

  15.     //}    

  16. }  

 

這個類與咱們在使用Spring MVC定義Controller時並沒有任何差異。接下來,咱們須要聲明一個主類啓動這個應用程序:

 

Startup 代碼  收藏代碼

  1. @Configuration    

  2. @ComponentScan    

  3. @EnableAutoConfiguration    

  4. public class Startup {  

  5.     public static void main(String[] args) {  

  6.         SpringApplication app = new SpringApplication(Startup.class);  

  7.         app.setWebEnvironment(true);  

  8.         app.setShowBanner(false);  

  9.           

  10.         Set<Object> set = new HashSet<Object>();  

  11.         //set.add("classpath:applicationContext.xml");  

  12.         app.setSources(set);  

  13.         app.run(args);  

  14.     }    

  15. }  

  

這個 類的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包了。Myeclipse的Maven的package請參考(http://mrlee23.iteye.com/blog/2047946 )所呈現出的效果與在調試期是同樣的。如今看一下這個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應用上下文,此時咱們須要聲明這樣一個類:

 

Hellowebxml 代碼  收藏代碼

  1. public class HelloWebXml extends SpringBootServletInitializer {  

  2.     @Override  

  3.     protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {  

  4.         return application.sources(Application.class);  

  5.     }  

  6.   

  7. }  

 

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

若是要將最終的打包形式改成WAR的話,還須要對pom.xml文件進行修改,除了須要將packaging的值修改成war之外,還須要對依賴進行適當的配置(這一部分在Spring Boot的樣例和文檔中均未說起,提醒你們注意):

Pom.xml代碼  收藏代碼

  1. <dependency>  

  2.             <groupId>org.springframework.boot</groupId>  

  3.             <artifactId>spring-boot-starter-web</artifactId>   

  4.            <exclusions>  

  5.             <exclusion>  

  6.                 <groupId>org.springframework.boot</groupId>  

  7.                 <artifactId>spring-boot-starter-tomcat</artifactId>  

  8.             </exclusion>  

  9.            </exclusions>   

  10. </dependency>  

 

在這裏須要移除對嵌入式Tomcat的依賴,這樣打出的WAR包中,在lib目錄下才不會包含Tomcat相關的JAR包,不然將會出現啓動錯誤。另外,在移除對Tomcat的依賴後,爲了保證編譯正確,還須要添加對servlet-api的依賴,所以添加以下的配置:

Pom.xml代碼  收藏代碼

  1. <dependency>  

  2.             <groupId>org.apache.tomcat</groupId>  

  3.             <artifactId>tomcat-servlet-api</artifactId>  

  4.             <version>7.0.42</version>  

  5.             <scope>provided</scope>  

  6. </dependency>  

 

在這裏將scope屬性設置爲provided,這樣在最終造成的WAR中不會包含這個JAR包,由於Tomcat或Jetty等服務器在運行時將 會提供相關的API類。此時,執行mvn package命令就會獲得一個WAR文件,咱們能夠直接將其放到Tomcat下運行(須要7.0.42版本以上)。

以上介紹了基於Spring Boot開發應用的過程,目前它的文檔尚不完善,可是在GitHub上有很多的樣例,包括與Spring Data集成訪問數據庫(關係型以及非關係型)、安全、WebSocket等,讀者感興趣能夠下載運行。

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

 

參考資料

http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/

https://github.com/spring-projects

相關文章
相關標籤/搜索