快速入門

本章主要目標完成Spring Boot基礎專案的構建，並且實現一個簡單的Http請求處理，通過這個例子對Spring Boot有一個初步的瞭解，並體驗其結構簡單、開發快速的特性。

系統要求：

• Java 7及以上
• Spring Framework 4.1.5及以上

本文采用Java 1.8.0_73、Spring Boot 1.3.2除錯通過。

使用Maven構建專案

1. 通過SPRING INITIALIZR工具產生基礎專案
   1. 訪問：http://start.spring.io/
   2. 選擇構建工具Maven Project、Spring Boot版本1.3.2以及一些工程基本資訊，可參考下圖所示SPRING INITIALIZR
   3. 點選Generate Project下載專案壓縮包
2. 解壓專案包，並用IDE以Maven專案匯入，以IntelliJ IDEA 14為例：
   1. 選單中選擇File–>New–>Project from Existing Sources...
   2. 選擇解壓後的專案資料夾，點選OK
   3. 點選Import project from external model並選擇Maven，點選Next到底為止。
   4. 若你的環境有多個版本的JDK，注意到選擇Java SDK的時候請選擇Java 7以上的版本

專案結構解析

專案結構

通過上面步驟完成了基礎專案的建立，如上圖所示，Spring Boot的基礎結構共三個檔案（具體路徑根據使用者生成專案時填寫的Group所有差異）：

• src/main/java下的程式入口：Chapter1Application
• src/main/resources下的配置檔案：application.properties
• src/test/下的測試入口：Chapter1ApplicationTests

生成的Chapter1Application和Chapter1ApplicationTests類都可以直接執行來啟動當前建立的專案，由於目前該專案未配合任何資料訪問或Web模組，程式會在載入完Spring之後結束執行。

引入Web模組

當前的pom.xml內容如下，僅引入了兩個模組：

• spring-boot-starter：核心模組，包括自動配置支援、日誌和YAML
• spring-boot-starter-test：測試模組，包括JUnit、Hamcrest、Mockito

  <dependencies>
      <dependency>
          <groupId>org.springframework.boot</groupId>
  		<artifactId>spring-boot-starter</artifactId>
  	</dependency>
  
  	<dependency>
  		<groupId>org.springframework.boot</groupId>
  		<artifactId>spring-boot-starter-test</artifactId>
  		<scope>test</scope>
  	</dependency>
  </dependencies>

  
  

• 引入Web模組，需新增spring-boot-starter-web模組：

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

  
  

  編寫HelloWorld服務

• 建立package命名為com.didispace.web（根據實際情況修改）
• 建立HelloController類，內容如下

  @RestController
  public class HelloController {
  
      @RequestMapping("/hello")
      public String index() {
          return "Hello World";
      }
  
  }

  
  
• 啟動主程式，開啟瀏覽器訪問http://localhost:8080/hello，可以看到頁面輸出Hello World

• 編寫單元測試用例

  開啟的src/test/下的測試入口Chapter1ApplicationTests類。下面編寫一個簡單的單元測試來模擬http請求，具體如下：

  @RunWith(SpringJUnit4ClassRunner.class)
  @SpringApplicationConfiguration(classes = MockServletContext.class)
  @WebAppConfiguration
  public class Chapter1ApplicationTests {
  
  	private MockMvc mvc;
  
  	@Before
  	public void setUp() throws Exception {
  		mvc = MockMvcBuilders.standaloneSetup(new HelloController()).build();
  	}
  
  	@Test
  	public void getHello() throws Exception {
  		mvc.perform(MockMvcRequestBuilders.get("/hello").accept(MediaType.APPLICATION_JSON))
  				.andExpect(status().isOk())
  				.andExpect(content().string(equalTo("Hello World")));
  	}
  
  }

  
  

• 使用MockServletContext來構建一個空的WebApplicationContext，這樣我們建立的HelloController就可以在@Before函式中建立並傳遞到MockMvcBuilders.standaloneSetup（）函式中。

• 注意引入下面內容，讓status、content、equalTo函式可用

  import static org.hamcrest.Matchers.equalTo;
  import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
  import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

  
  

• 至此已完成目標，通過Maven構建了一個空白Spring Boot專案，再通過引入web模組實現了一個簡單的請求處理。

• 原始碼來源