spring boot入门 -- 介绍和第一个例子

傷城~ 2022-05-19 04:05 280阅读 0赞

基础的备份下：

原地址：[https://www.cnblogs.com/junyang/p/8151802.html][https_www.cnblogs.com_junyang_p_8151802.html]

## [spring boot入门 -- 介绍和第一个例子][https_www.cnblogs.com_junyang_p_8151802.html] ##

“越来越多的企业选择使用spring boot 开发系统，spring boot牛在什么地方？难不难学？心动不如行动，让我们一起开始学习吧！”

使用Spring boot ，可以轻松的创建独立运行的程序，非常容易构建独立的服务组件，是实现分布式架构、微服务架构利器。Spring boot简化了第三方包的引用，通过提供的starter，简化了依赖包的配置。

**Spring boot的优点**

*  轻松创建独立的Spring应用程序。
 *  内嵌Tomcat、jetty等web容器，不需要部署WAR文件。
 *  提供一系列的“starter” 来简化的Maven配置。
 *  开箱即用，尽可能自动配置Spring。

**spring boot 快速入门**

通过构建简单的REST应用，了解spring boot的开发基本流程，验证其简单、易用特性。

**环境要求**

Spring Boot 2.0.0.BUILD-SNAPSHOT 要求 Java 8 和 Spring Framework 5.0.2以上，Maven 3.2 以上或者Gradle 4。

本文使用 Spring Boot 1.5.9 、 Java8 和 Spring Framework 5.0.2.RELEASE以上，Maven 3.2。开发工具使用sping官方提供的spring suit tool 3.9.1(STS)。

**创建项目**

在STS中，通过NEW->Spring starter project创建spring boot 项目。

![732517-20171231004656976-935483811.png][]

输入maven的group 和artifact。

![732517-20171231004729070-2044736475.png][]

选择spring boot版本和starter

![732517-20171231004929695-469110124.png][]

点击下一步，进入如下界面。

选择spring boot的版本，这里选择1.5.9 版本。

选择starter，通过搜索找到web 并勾选。点击完成。

![732517-20171231004900398-784567163.png][]

**创建项目的结构**

点击finish 按钮。创建项目如下：

![732517-20171231005151413-539853218.png][]

目录结构如图。

*  Src/main/java。编写代码存放的目录。自动生成了程序入口代码 SpringBootDemo1Application.java。
 *  Src/main/resources。资源文件存放目录。自动生成了配置文件 application.properties
 *  Src/test/java。测试代码存放目录。自动生成了测试代码SpringBootDemo1ApplicationTests.java

**POM文件说明**

spring boot项目默认使用maven来构建，生成的POM文件如下：

<table> 
 <tbody> 
 <tr> 
 <td> 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 43 44 45 46 47 48 </td> 
 <td> <code>&lt;?</code><code>xml</code> <code>version="1.0" encoding="UTF-8"?&gt;</code> <code>&lt;</code><code>project</code> <code>xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>modelVersion</code><code>&gt;4.0.0&lt;/</code><code>modelVersion</code><code>&gt;</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>groupId</code><code>&gt;com.yuny&lt;/</code><code>groupId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>artifactId</code><code>&gt;demo1&lt;/</code><code>artifactId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>version</code><code>&gt;0.0.1-SNAPSHOT&lt;/</code><code>version</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>packaging</code><code>&gt;jar&lt;/</code><code>packaging</code><code>&gt;</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>name</code><code>&gt;spring-boot-demo1&lt;/</code><code>name</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>description</code><code>&gt;Demo project for Spring Boot&lt;/</code><code>description</code><code>&gt;</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>parent</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>groupId</code><code>&gt;org.springframework.boot&lt;/</code><code>groupId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>artifactId</code><code>&gt;spring-boot-starter-parent&lt;/</code><code>artifactId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>version</code><code>&gt;1.5.9.RELEASE&lt;/</code><code>version</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>relativePath</code><code>/&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>parent</code><code>&gt;</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>properties</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>project.build.sourceEncoding</code><code>&gt;UTF-8&lt;/</code><code>project.build.sourceEncoding</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>project.reporting.outputEncoding</code><code>&gt;UTF-8&lt;/</code><code>project.reporting.outputEncoding</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>java.version</code><code>&gt;1.8&lt;/</code><code>java.version</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>properties</code><code>&gt;</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>dependencies</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>dependency</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>groupId</code><code>&gt;org.springframework.boot&lt;/</code><code>groupId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>artifactId</code><code>&gt;spring-boot-starter-web&lt;/</code><code>artifactId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>dependency</code><code>&gt;</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>dependency</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>groupId</code><code>&gt;org.springframework.boot&lt;/</code><code>groupId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>artifactId</code><code>&gt;spring-boot-starter-test&lt;/</code><code>artifactId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>scope</code><code>&gt;test&lt;/</code><code>scope</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>dependency</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>dependencies</code><code>&gt;</code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>build</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>plugins</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>plugin</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>groupId</code><code>&gt;org.springframework.boot&lt;/</code><code>groupId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>artifactId</code><code>&gt;spring-boot-maven-plugin&lt;/</code><code>artifactId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>plugin</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>plugins</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>build</code><code>&gt;</code> <code>&lt;/</code><code>project</code><code>&gt;</code> </td> 
 </tr> 
 </tbody> 
</table>

其中，

**设置spring-boot-starter-parent为父亲项目**

这种方式可以比较容易的使用父项目中的starters的依赖。 当然也可以不用继承spring-boot-starter-parent为父亲，这种方式在以后我们会介绍。

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 </td> 
 <td> <code>&lt;</code><code>parent</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>groupId</code><code>&gt;org.springframework.boot&lt;/</code><code>groupId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>artifactId</code><code>&gt;spring-boot-starter-parent&lt;/</code><code>artifactId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>version</code><code>&gt;1.5.9.RELEASE&lt;/</code><code>version</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>relativePath</code><code>/&gt;</code> <code>&lt;/</code><code>parent</code><code>&gt;</code> </td> 
 </tr> 
 </tbody> 
</table>

**引入web依赖**

Web starter依赖引入，会增加web容器、springweb、springmvc、jackson-databind等相关的依赖。

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 </td> 
 <td> <code>&lt;</code><code>dependency</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>groupId</code><code>&gt;org.springframework.boot&lt;/</code><code>groupId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>artifactId</code><code>&gt;spring-boot-starter-web&lt;/</code><code>artifactId</code><code>&gt;</code> <code>&lt;/</code><code>dependency</code><code>&gt;</code> </td> 
 </tr> 
 </tbody> 
</table>

依赖层级关系如图

![732517-20171231181322898-1228677609.png][]

**引入测试依赖**

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 </td> 
 <td> <code>&lt;</code><code>dependency</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>groupId</code><code>&gt;org.springframework.boot&lt;/</code><code>groupId</code><code>&gt;&nbsp;&nbsp;&nbsp;&nbsp; </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>artifactId</code><code>&gt;spring-boot-starter-test&lt;/</code><code>artifactId</code><code>&gt;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>scope</code><code>&gt;test&lt;/</code><code>scope</code><code>&gt;</code> <code>&lt;/</code><code>dependency</code><code>&gt;</code> </td> 
 </tr> 
 </tbody> 
</table>

**启动程序SpringBootDemo1Application 说明　**

我们通过此类的main函数来启动spring boot程序。

启动程序SpringBootDemo1Application是自动生成的，代码如下：

![复制代码][copycode.gif]

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

![复制代码][copycode.gif]

其中是@SpringBootApplication组合注解，兼备了@EnableAutoConfiguration和@ComponentScan 注解的功能。

## 增加一个controller ##

在包com.yuny.demo1.controller下面增加类SampleController

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 </td> 
 <td> <code>@RestController</code> <code>public class SampleController { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>@RequestMapping("/")</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>String home() { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>return "Hello World!";</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>}</code> </td> 
 </tr> 
 </tbody> 
</table>

运行启动程序后，访问[http://localhost:8080/][http_localhost_8080]就可以访问这个controller的功能了。

启动很简单，直接选择SpringBootDemo1Application.java文件，使用java application方式运行即可：

![732517-20171231181710038-1280441736.png][]

访问效果：

![732517-20171231181821523-1099884058.png][]

**测试**

增加一个测试类

本文案例代码地址

[https://github.com/junyanghuang/spring-boot-samples/tree/master/springb-01-first][https_github.com_junyanghuang_spring-boot-samples_tree_master_springb-01-first]

[https_www.cnblogs.com_junyang_p_8151802.html]: https://www.cnblogs.com/junyang/p/8151802.html
[732517-20171231004656976-935483811.png]: /images/20220519/f4163867c6194d9096e3173bc5948d01.png
[732517-20171231004729070-2044736475.png]: /images/20220519/7f03ffa9285b4b3eb8bdc0a8cce617c9.png
[732517-20171231004929695-469110124.png]: /images/20220519/ebab4a08553c4c43880f46230dd38e68.png
[732517-20171231004900398-784567163.png]: /images/20220519/b42f2aa6d74e4301b1e3e15fe63beed8.png
[732517-20171231005151413-539853218.png]: /images/20220519/575e33929eff4fe1a8737041aaab8f29.png
[732517-20171231181322898-1228677609.png]: /images/20220519/c056a5017b654ee3a3df9ac2870224a1.png
[copycode.gif]: /images/20220519/76f441ef2bbc4e0aabd3f96ac86209b3.png
[http_localhost_8080]: http://localhost:8080/
[732517-20171231181710038-1280441736.png]: /images/20220519/de583e9085a940c19adac06658676018.png
[732517-20171231181821523-1099884058.png]: /images/20220519/8ff7747cf06e4b6dbb41c6882c1e2f10.png
[https_github.com_junyanghuang_spring-boot-samples_tree_master_springb-01-first]: https://github.com/junyanghuang/spring-boot-samples/tree/master/springb-01-first