构建一个 Spring Boot 应用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
package hello;

import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;

// 使用 @RestController 注解，意味着准备好使用 Spring MVC 处理请求
// @RestController 组合了 @Controller 和 @ResponseBoby，这两个注解的结果是返回数据，而不是视图。
@RestController
public class HelloController {

    // 将 '/' 映射到 index() 方法；
    @RequestMapping("/")
    public String index() {
        return "Greetings from Spring Boot!";
    }

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
package hello;

import java.util.Arrays;

import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
// @SpringBootAppication 是一个方便的注解，增加了以下内容：
// 1. @Configuration：标志这个类作为一个为应用程序上下文的 bean 定义的源。
// 2. @EnableAutoConfiguration：告诉 Spring Boot 开始增加基于 Classpath 设置、其他 beans 和不同属性设置的 beans。
// 3. 你通常想给一个 Spring MVC app 增加 @EnableWebMvc，但当 Spring Boot 看见 spring=webmvc 在 classpath 时，就自动添加了。这个标志应用程序作为一个 web 应用程序并激活键行为例如设置一个 DispatcherServlet.
// 4. @ComponentScan 告诉 Spring 在 hello 包中寻找其他的组件、配置和服务，允许它找 controllers.
public class Application {

  // main() 使用 Spring Boot 的 SpringApplication.run() 方法来启动一个应用程序。
  public static void main(String[] args) {
      SpringApplication.run(Application.class, args);
  }

  // 被标记 @Bean 并且在启动时运行。它取所有创建的（无论是你的 app 还是 Spring Boot 自动添加的）beans，排序并打印出它们。
  @Bean
  public CommandLineRunner commandLineRunner(ApplicationContext ctx) {
      return args -> {
         System.out.println("Let's inspect the beans provided by Spring Boot:");

          String[] beanNames = ctx.getBeanDefinitionNames();
          Arrays.sort(beanNames);
          for (String beanName : beanNames) {
              System.out.println(beanName);
          }
     };
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
  package hello;

  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;

  import org.junit.Test;
  import org.junit.runner.RunWith;
  import org.springframework.beans.factory.annotation.Autowired;
  import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
  import org.springframework.boot.test.context.SpringBootTest;
  import org.springframework.http.MediaType;
  import org.springframework.test.context.junit4.SpringRunner;
  import org.springframework.test.web.servlet.MockMvc;
  import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;

  @RunWith(SpringRunner.class)
  // 下面两个注解一起使用，注入 MockMvc 实例。
  @SpringBootTest
  @AutoConfigureMockMvc
  public class HelloControllerTest {

      // 这个 MockMvc 来自 Spring Test, 允许你通过一个方便的构建类集合发送 HTTP 请求到 DispatcherServlet 并断言结果；
      @Autowired
      private MockMvc mvc;

      @Test
      public void getHello() throws Exception {
          mvc.perform(MockMvcRequestBuilders.get("/").accept(MediaType.APPLICATION_JSON))
  		.andExpect(status().isOk())
  		.andExpect(content().string(equalTo("Greetings from Spring Boot!")));
      }
  }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
  package hello;

  import static org.hamcrest.Matchers.equalTo;
  import static org.junit.Assert.assertThat;

  import java.net.URL;

  import org.junit.Before;
  import org.junit.Test;
  import org.junit.runner.RunWith;
  import org.springframework.beans.factory.annotation.Autowired;
  import org.springframework.boot.context.embedded.LocalServerPort;
  import org.springframework.boot.test.context.SpringBootTest;
  import org.springframework.boot.test.web.client.TestRestTemplate;
  import org.springframework.http.ResponseEntity;
  import org.springframework.test.context.junit4.SpringRunner;

  @RunWith(SpringRunner.class)
  // 在随机端口启动
  @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
  public class HelloControllerIT {

      // 运行时发现实际端口
      @LocalServerPort
      private int port;

      private URL base;

      @Autowired
      private TestRestTemplate template;

      @Before
      public void setUp() throws Exception {
        this.base = new URL("http://localhost:" + port + "/");
      }

      @Test
      public void getHello() throws Exception {
        ResponseEntity<String> response = template.getForEntity(base.toString(), String.class);
  	    assertThat(response.getBody(), equalTo("Greetings from Spring Boot!"));
      }
  }