[01] 初識SpringBoot：Hello World

引用百科的一句話來講，SpringBoot是一款全新框架，設計目的是爲了簡化新Spring應用的初始搭建以及開發過程。

怎麼講呢，首先要明確的就是SpringBoot不是替代Spring的一種解決方案，而是整合Spring技術資源的方案，它已經幫你集成了大量的內容，以致於你能夠「開箱即用」，由於它須要的搭建步驟和配置文件真的不多不多。

這裏直接從Spring官方的 Demo入手，帶你領略一下SpringBoot的魅力所在。

一、Demo說明

咱們接下來將要使用SpringBoot來建立一個 RESTful 風格的Web服務應用，固然是Hello World級別的入門程序。

當咱們訪問 http://localhost:8080/greeting 時，服務器會返回JSON格式的數據，如 {"id":1, "content":"Hello, World!"}；

若是咱們對接口增長參數name時，如 http://localhost:8080/greeting?name=zhangsan  ，則返回的數據爲  {"id":1, "content":"Hello, zhangsan!"}

二、配置環境說明

• JDK 1.8+
• Maven 3.2+

以上是SpringBoot 從2.0版本開始的最低要求了，若是你的JDK版本較低，那麼獲取你也只能使用低版本的SpringBoot，本篇中的Demo將會基於SpringBoot-version2.0.3。

三、SpringBoot：Hello World

3.1 配置pom

新建一個Maven項目，而後在pom.xml中引入SpringBoot相關的配置，官方Demo中給出配置以下（看似配置很複雜，其實咱們並用不了這麼多，如今只管複製着用就行了，在後面會說明，實際上必要的pom配置也就三部分）：

<?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>

    <!-- Inherit defaults from Spring Boot -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.3.RELEASE</version>
    </parent>

    <!-- Add typical dependencies for a web application -->
    <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>

    <!-- Package as an executable jar -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

    <!-- Add Spring repositories -->
    <!-- (you don't need this if you are using a .RELEASE version) -->
    <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>

63

 

1

<?xml version="1.0" encoding="UTF-8"?>

2

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

3

    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

4

    <modelVersion>4.0.0</modelVersion>

5

6

    <groupId>org.springframework</groupId>

7

    <artifactId>gs-rest-service</artifactId>

8

    <version>0.1.0</version>

9

10

    <!-- Inherit defaults from Spring Boot -->

11

    <parent>

12

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

13

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

14

        <version>2.0.3.RELEASE</version>

15

    </parent>

16

17

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

18

    <dependencies>

19

        <dependency>

20

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

21

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

22

        </dependency>

23

        <dependency>

24

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

25

            <artifactId>spring-boot-starter-test</artifactId>

26

            <scope>test</scope>

27

        </dependency>

28

        <dependency>

29

            <groupId>com.jayway.jsonpath</groupId>

30

            <artifactId>json-path</artifactId>

31

            <scope>test</scope>

32

        </dependency>

33

    </dependencies>

34

35

    <properties>

36

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

37

    </properties>

38

39

    <!-- Package as an executable jar -->

40

    <build>

41

        <plugins>

42

            <plugin>

43

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

44

                <artifactId>spring-boot-maven-plugin</artifactId>

45

            </plugin>

46

        </plugins>

47

    </build>

48

49

    <!-- Add Spring repositories -->

50

    <!-- (you don't need this if you are using a .RELEASE version) -->

51

    <repositories>

52

        <repository>

53

            <id>spring-releases</id>

54

            <url>https://repo.spring.io/libs-release</url>

55

        </repository>

56

    </repositories>

57

    <pluginRepositories>

58

        <pluginRepository>

59

            <id>spring-releases</id>

60

            <url>https://repo.spring.io/libs-release</url>

61

        </pluginRepository>

62

    </pluginRepositories>

63

</project>

3.2 新建實體類用以表示返回對象

JSON格式要求爲 {"id":1, "content":"Hello, World!"} ，則對應的實體類以下：

public class Greeting {
    private final long id;
    private final String content;

    public long getId() {
        return id;
    }

    public String getContent() {
        return content;
    }

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

17

 

1

public class Greeting {

2

    private final long id;

3

    private final String content;

4

5

    public long getId() {

6

        return id;

7

    }

8

9

    public String getContent() {

10

        return content;

11

    }

12

13

    public Greeting(long id, String content) {

14

        this.id = id;

15

        this.content = content;

16

    }

17

}

3.3 新建Controller

@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));
    }

}

12

 

1

@RestController

2

public class GreetingController {

3

4

    private static final String template = "Hello, %s!";

5

    private final AtomicLong counter = new AtomicLong();

6

7

    @RequestMapping("/greeting")

8

    public Greeting greeting(@RequestParam(value = "name", defaultValue = "World") String name) {

9

        return new Greeting(counter.incrementAndGet(), String.format(template, name));

10

    }

11

12

}

• @RestController 即表示了 @Controller 和 @ResponseBody 的整合
• @RequestMapping 用來映射url請求到該方法
• @RequestParam 用來綁定請求中的參數，其中value爲參數名稱，defaultValue爲參數默認值

3.4 新建執行類

常規的方式咱們每每將資源打爲war包而後部署在服務器下，而SpringBoot則默認採用了打爲jar包並執行main()函數的方法，咱們新建類以下：

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

6

 

1

@SpringBootApplication

2

public class Application {

3

    public static void main(String[] args) {

4

        SpringApplication.run(Application.class, args);

5

    }

6

}

• SpringBootApplication 整合了不少其餘註解的功能（詳見官方Demo部分的說明）

3.5 運行main函數

是的，接下來你只須要運行main函數就能夠了：

你甚至能夠將工程打成可執行的jar包（Maven，先clean，再package打包）：

而後經過 java -jar 執行jar包的主程序，效果也是同樣的：

服務器哪來的，我明明只是執行了一個main函數而已：

• SpringBoot內置了三種Servlet容器：Tomcat、Jetty、Undertow
• 默認使用的是Tomcat

SpringBoot怎麼知道我要的是MVC模式的web應用：

• 別忘了咱們在pom中配置了所謂的「starter」
• SpringBoot提供各類starter，其實就是不少Spring包的集合，不過Spring替咱們整合起來了

四、Demo部分補充說明

4.1 關於pom配置

對於SpringBoot的pom配置來講，官方也進行了 詳細的說明。能夠看出該Demo中其實必要的留下以下三部分便可：

<!-- Inherit defaults from Spring Boot -->
<!-- springBoot 核心包 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.4.BUILD-SNAPSHOT</version>
</parent>

<!-- Add typical dependencies for a web application -->
<!-- 若是搭建的是web應用則增長典型的依賴 -->
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

<!-- Package as an executable jar -->
<!-- 將springBoot打包爲jar包的插件 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

27

 

1

<!-- Inherit defaults from Spring Boot -->

2

<!-- springBoot 核心包 -->

3

<parent>

4

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

5

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

6

    <version>2.0.4.BUILD-SNAPSHOT</version>

7

</parent>

8

9

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

10

<!-- 若是搭建的是web應用則增長典型的依賴 -->

11

<dependencies>

12

    <dependency>

13

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

14

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

15

    </dependency>

16

</dependencies>

17

18

<!-- Package as an executable jar -->

19

<!-- 將springBoot打包爲jar包的插件 -->

20

<build>

21

    <plugins>

22

        <plugin>

23

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

24

            <artifactId>spring-boot-maven-plugin</artifactId>

25

        </plugin>

26

    </plugins>

27

</build>

4.2 關於starter

依賴的集合，官方的說明（ 13.5 Starters）就很貼切了：The starters contain a lot of the dependencies that you need to get a project up and running quickly and with a consistent, supported set of managed transitive dependencies.

4.3 關於默認配置變動

內置的Tomcat默認端口是8080，固然是能夠修改的，拋磚引玉，本篇不作詳述：

• spring-boot-02 Spring Boot 如何修改默認配置？默認配置都有哪些？（外置配置文件）修改tomcat默認端口

4.4 關於部署war包

SpringBoot默認是按照jar包執行，實際上也是能夠打包成爲war包，單獨放在服務器下運行。一樣，此處不展開，參考連接便可：

• 88.1 Create a Deployable War File
• Spring Boot 打包war

五、其餘參考連接

• Building a RESTful Web Service
• 【springboot 入門篇】第0篇 spring-boot是什麼
• Springboot 版本+ jdk 版本 + Maven 版本的匹配