1.目標是什麼

構建一個web應用，我們可以請求：

http://localhost:8080/greeting

返回一個JSON：

{"id":1,"content":"Hello, World!"}

還可以發起一個帶引數的請求：

http://localhost:8080/greeting?name=User

返回一個JSON：

{"id":1,"content":"Hello, User!"}

2.你需要有什麼

• 大約15分鐘的時間
• 一個喜歡的文字編輯器或者IDE
• JDK 8（或者更高）
• Maven 3.0+

3.開始我們的教程

3.1 maven依賴

建立一個maven專案，專案結構如下：

└── src
    └── main
        └── java
            └── hello

pom.xml：

<?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>org.springframework</groupId>
    <artifactId>gs-rest-service</artifactId>
    <version>0.1.0</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId
 
>spring-boot-starter-parent</artifactId>
        <version>1.5.8.RELEASE</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-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.jayway.jsonpath</groupId>
            <artifactId>json-path</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <properties>
        <java.version>1.8</java.version>
    </properties>


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

    <repositories>
        <repository>
            <id>spring-releases</id>
            <url>https://repo.spring.io/libs-release</url>
        </repository>
    </repositories>
    <pluginRepositories>
        <pluginRepository>
            <id>spring-releases</id>
            <url>https://repo.spring.io/libs-release</url>
        </pluginRepository>
    </pluginRepositories>
</project>

其中，spring-boot-maven-plugin給我們提供了這麼幾個功能：
+ 他會把classpath下的jar統一打包成一個可直接執行的”über-jar”，方便我們執行。
+ 他會自動搜尋public static void main()作為程式執行的入口。
+ 他內建一個依賴版本決定者。也就是他會指定依賴的版本。當然你也可以指定版本，如果你不指定，預設由他來決定版本。

3.2 實體類

根據

{
    "id": 1,
    "content": "Hello, World!"
}

來寫出一個表達這個json的beansrc/main/java/hello/Greeting.java

package hello;

public class Greeting {

    private final long id;
    private final String content;

    public Greeting(long id, String content) {
        this.id = id;
        this.content = content;
    }

    public long getId() {
        return id;
    }

    public String getContent() {
        return content;
    }
}

Spring會使用Jackson JSON自動把Greeting的例項序列化成JSON。

3.3 controller

在Spring構建的restful應用中，HTTP請求是由controller接收並處理的。想要建立一個controller可以使用@RestController修飾一個類，那麼這個類就變成了一個controller。一個controller裡的每個方法都可以接收一個特定的URI，需要使用@RequestMapping來修飾每個方法，來制定URI的路徑，引數，方法等。

src/main/java/hello/GreetingController.java

package hello;

import java.util.concurrent.atomic.AtomicLong;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class GreetingController {

    private static final String template = "Hello, %s!";
    private final AtomicLong counter = new AtomicLong();

    @RequestMapping("/greeting")
    public Greeting greeting(@RequestParam(value="name", defaultValue="World") String name) {
        return new Greeting(counter.incrementAndGet(),
                            String.format(template, name));
    }
}

這個controller很簡潔明瞭，但是在背後隱藏了很多事先細節，我們一點點來分解。

@RequestMapping這個註解確保/greeting這個HTTP請求會被路由到greeting()這個方法上來處理。

上面的例子沒有指明GET，PUST或者是PUT等HTTP方法，因為@RequestMapping預設是對映所有的方法。如果你只希望某個方法被對映到這個方法，可以使用@RequestMapping(method=GET)來縮小對映範圍。

@RequestParam把請求引數中的name的值繫結到greeting()的引數name上。這個引數被標記為可選的，也就是可傳可不傳的，（預設情況下，required=true是必須要傳的），在這裡，如果沒有傳name，就會使用defaultValue的值。

greeting()方法裡建立了一個Greeting物件，然後返回，用一個自增的int作為id，用name的值拼接成content。

傳統的MVC的controller和RESTful的controller的最大的區別就是返回的HTTP的response。傳統的controller返回的是一個由後端渲染的HTML，而RESTful返回的是一個物件，然後被序列化成JSON字串。

@RestController是Spring4新加的一個註解，用它修飾的controller返回的是一個物件（也就是JSON），而不是一個檢視（也就是HTML）。這個註解等同於同時使用@Controller和@ResponseBody。

上面提到Spring會自動把物件轉化成JSON，我們還不需要手動來轉換，那麼是誰幫我們做的呢？真相是，只要Jackson 2在classpath下，Spring就會使用MappingJackson2HttpMessageConverter來自動轉換。

3.4 可執行Jar

雖然也可以打包成傳統的war包然後交給servlet容器來執行，但是更多的時候是打包成一個可以直接執行的Jar。

src/main/java/hello/Application.java

package hello;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

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

@SpringBootApplication註解等同於同時使用一下註解：
+ @Configuration修飾的類會被作為定義context上下文的bean。
+ @EnableAutoConfiguration允許Spring從配置檔案，其他bean，等各種方式來載入bean。
+ 一般來說，對於Spirng MVC專案，你需要使用@EnableWebMvc，不過對於Spring Boot來說，只要你的classpath裡包含spring-webmvc，他就會自動幫你加上這個，比如，設定DispatcherServlet。
+ @ComponentScan告訴Spirng去掃描hello包下的其他元件，包含controller,service等。

main()就是這個應用的入口。發現了嗎，整個應用沒有一個XML檔案，全部都是Java程式碼，沒有任何配置，這就是Spring Boot想帶給你的禮物。

3.5 生成可執行Jar

java -jar restful-web-1.0-SNAPSHOT.jar

結果：

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v1.5.8.RELEASE)

2017-10-19 19:38:00.944  INFO 3923 --- [           main] hello.Application                        : Starting Application v1.0-SNAPSHOT on teedeMacBook-Pro.local with PID 3923 (/Users/teeyoung/Desktop/code4me/spring-demo/restful-web/target/restful-web-1.0-SNAPSHOT.jar started by teeyoung in /Users/teeyoung/Desktop/code4me/spring-demo/restful-web/target)
2017-10-19 19:38:00.949  INFO 3923 --- [           main] hello.Application                        : No active profile set, falling back to default profiles: default
2017-10-19 19:38:01.019  INFO 3923 --- [           main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot[email protected]4f6ee6e4: startup date [Thu Oct 19 19:38:01 CST 2017]; root of context hierarchy
WARNING: An illegal reflective access operation has occurred
WARNING: Illegal reflective access by org.springframework.cglib.core.ReflectUtils$1 (jar:file:/Users/teeyoung/Desktop/code4me/spring-demo/restful-web/target/restful-web-1.0-SNAPSHOT.jar!/BOOT-INF/lib/spring-core-4.3.12.RELEASE.jar!/) to method java.lang.ClassLoader.defineClass(java.lang.String,byte[],int,int,java.security.ProtectionDomain)
WARNING: Please consider reporting this to the maintainers of org.springframework.cglib.core.ReflectUtils$1
WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations
WARNING: All illegal access operations will be denied in a future release
2017-10-19 19:38:02.374  INFO 3923 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat initialized with port(s): 8080 (http)
……
2017-10-19 19:38:03.219  INFO 3923 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-10-19 19:38:03.219  INFO 3923 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-10-19 19:38:03.263  INFO 3923 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-10-19 19:38:03.396  INFO 3923 --- [           main] o.s.j.e.a.AnnotationMBeanExporter        : Registering beans for JMX exposure on startup
2017-10-19 19:38:03.465  INFO 3923 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
2017-10-19 19:38:03.474  INFO 3923 --- [           main] hello.Application                        : Started Application in 2.924 seconds (JVM running for 3.436)