SpringBoot 入门篇（一） Hello World

迈不过友情╰ 2022-05-23 13:54 300阅读 0赞

### 一、SpringBoot简介 ###

### 二、跟着官方文档学习SpringBoot ###

####   1、SpringBoot入门Demo ####

####   2、SpringBoot运行方式 ####

####   3、构建SpringBoot项目注意事项 ####

--------------------

### 一、SpringBoot简介 ###

SpringBoot简化了Spring框架开发中各种复杂配置，使开发者快速、敏捷的开发基于Spring框架的应用程序。  
  SpringBoot使用 “约定优于配置” 的思想来摆脱Spring对XML配置文件的依赖，同时又集成了大量的常用第三方库配置（如Redis，Mongo，Mail），在Spring Boot应用中这些第三方库几乎可以零配置的开箱即用，使开发者能够从繁杂的配置中解脱出来，更加专注于项目的业务逻辑。  
  如下是官网（[https://spring.io/projects/spring-boot\#overview][https_spring.io_projects_spring-boot_overview]）给出的SpringBoot的特性

![1240][]

SpringBoot提供了大量的“Starters”（我们也可以自定义“Starters”，官方文档也给出了说明），这些“Starters”集成了常用第三方库，如最长用的spring-boot-starter-web为我们集成了Spring MVC，spring-boot-starter-data-mongodb为我们集成了mongodb等，SpringBoot集成的常用第三方库见官方文档的13.5小结。  
  SpringBoot目前已经到2.X版本，但是由于目前项目中使用的还是1.X版本，因此这里选用SpringBoot的1.5.13GA（正式发布）版本。对应的官方文档链接[https://docs.spring.io/spring-boot/docs/1.5.13.RELEASE/reference/htmlsingle/\#boot-documentation][https_docs.spring.io_spring-boot_docs_1.5.13.RELEASE_reference_htmlsingle_boot-documentation]。  
  文档中的前10个小结是在使用SpringBoot之前的一些说明，其中需要注意的就是Servlet容器的版本和构建工具。官方文档中强烈推荐使用 Maven或者Gradle来构建SpringBoot项目，因此这里选择Maven 3.5.2。

![1240 1][]

--------------------

### 二、跟着官方文档学习SpringBoot ###

#### 1、SpringBoot入门Demo ####

跟着官方文档构建第一个SpringBoot的Hello World。  
  （1）打开命令窗口，执行如下命令，一路回车即可  
mvn archetype:generate -DgroupId=com.qzc -DartifactId=springboot\_demo -DarchetypeArtifactId=maven-archetype-quickstart

![1240 2][]

（2）将Maven项目导入IDEA

![1240 3][]

（3）修改Maven项目的pom.xml文件。官方文档中推荐我们继承官方的一个父工程spring-boot-starter-parent（当然也可以不继承，官方文档也给出了方案），如果进入spring-boot-starter-parent的pom文件中，可以看到，其中提供了一些可配置文件的扫描路径、大量的插件以及常用的UTF-8编码，这些可以算是一个最佳实践。我们需要搭建一个web项目，因此在pom文件中，添加spring-boot-starter-web的依赖。

![1240 4][]

（4）编写代码。将文档中的如下代码写入（Ctrl C+Ctrl V）。  
  这里需要注意其中的几个注解，@RestController和@RequestMapping是SpringMVC中的注解，在此不做说明。@EnableAutoConfiguration是SpringBoot提供的一个注解，SpringBoot根据这个注解和我们在pom文件中添加的依赖（spring-boot-starter-\*），智能的对我们的Spring环境进行配置，例如我们在pom中添加了spring-boot-starter-web的依赖，SpringBoot则会自动为我们进行web环境的配置（如添加内置Tomcat、配置SpringMVC等）。  
  另外，我们使用运行main方法的方式来启动工程，这也就意味着我们可以在main方法中添加一些自己的逻辑，来扩展项目的启动流程，具体扩展点在官方文档也进行了指明，我会在后续的文章中进行分享。

@RestController
    @EnableAutoConfiguration
    public class Example { 
    
        @RequestMapping("/")
        String home() {
            return "Hello World!";
        }
    
        public static void main(String[] args) throws Exception {
            SpringApplication.run(Example.class, args);
        }
    }

（5）直接运行main方法，控制台打印如下信息

![1240 5][]

（6）在浏览器输入[http://localhost:8080/][http_localhost_8080]，即可看到Hello World

![1240 6][]

--------------------

#### 2、SpringBoot运行方式 ####

通常我们在做JavaWeb项目时，是将项目打包成war包，然后丢到容器中运行，容器会将war包解压成对应的文件夹。SpringBoot由于可以自带Servlet容器，因此可以将我们的项目打成可执行的jar包运行。  
  我们知道jar包通常分为可执行的jar包和普通的jar包。可执行的jar包可以一次打包到处运行（只要有JVM），因为它已经把所有依赖都包含进去了；普通的jar包则没法运行，因为它只有自己的原始逻辑，因此通常是作为提供功能的第三方。  
  为了将项目打包成可执行的jar，SpringBoot提供了一个maven插件（当然，我们也可以通过IDE来打出可执行的jar，但当我们的代码要上生产环境时，需要通过自动化构建来打包，这时IDE的打包方式就不行了）。在pom文件中添加如下

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

![1240 7][]

再代开命令行窗口到项目路径下，执行 mvn package 命令。

![1240 8][]

此时在项目路径下的target文件夹就生成了一个可执行的jar

![1240 9][]

到该jar所在路径下，执行java -jar命令即可将项目运行起来

![1240 10][]

#### 3、构建SpringBoot项目注意事项 ####

（1）通常新建的SpringBoot项目会继承spring-boot-starter-parent，进入到spring-boot-starter-parent的pom文件看下

![1240 11][]

spring-boot-starter-parent的pom文件中指定默认的JDK版本是1.6，如果我们想要使用其他版本的jdk,例如JDK1.8，需要在我们自己的pom中添加如下

此外，在spring-boot-starter-parent的pom文件中为我们指定了一些配置文件的路径，这些在我们真实项目中配置一些必要的信息（如数据库）有很大的作用。  
  （2）有时我们的新建项目由于一些原因，不想继承spring-boot-starter-parent，这时就需要我们自己去添加配置项以继续使用Spring Boot 提供的依赖管理，添加如下

<dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-dependencies</artifactId>
                    <version>1.5.13.RELEASE</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>

![1240 12][]

我们也可以自己制定某些依赖包的版本，例如我们可以自己制定SpringMVC的版本

![1240 13][]

--------------------

下一篇：[SpringBoot 入门篇（二） SpringBoot常用注解以及自动配置][SpringBoot _ SpringBoot]

[https_spring.io_projects_spring-boot_overview]: https://spring.io/projects/spring-boot#overview
[1240]: /images/20220523/c5dc3bcd82c7485baace2a9b3e98b46a.png
[https_docs.spring.io_spring-boot_docs_1.5.13.RELEASE_reference_htmlsingle_boot-documentation]: https://docs.spring.io/spring-boot/docs/1.5.13.RELEASE/reference/htmlsingle/#boot-documentation
[1240 1]: /images/20220523/10e5e53ae5604c96bcbb3437b5880709.png
[1240 2]: /images/20220523/8be635733ad44123b77518a6b6bbc9e6.png
[1240 3]: /images/20220523/76af7a639066452c864a800fbf7ec4f3.png
[1240 4]: /images/20220523/10090b2a1cd44b91a579756b6dfe12f3.png
[1240 5]: /images/20220523/0ec2cc99f12741308eede876a5601619.png
[http_localhost_8080]: http://localhost:8080/
[1240 6]: /images/20220523/25045dd48d5c4eeeaf01e38dbb81451e.png
[1240 7]: /images/20220523/49ece5a9ade6492da9f6f77daa574cc3.png
[1240 8]: /images/20220523/37830499486d4f308093bcdc304960d2.png
[1240 9]: /images/20220523/0a6422b314624205bf23195993f0428f.png
[1240 10]: /images/20220523/5dd0e50aac5342bca46435fcac8f3505.png
[1240 11]: /images/20220523/0eb3cbcd6acf444e94a010139fbdf79e.png
[1240 12]: /images/20220523/f7a4e88fcf384ed79e5209dbbd7eec2c.png
[1240 13]: /images/20220523/75091b167d4a46cf8d830500d1815f06.png
[SpringBoot _ SpringBoot]: https://blog.csdn.net/zhichao_qzc/article/details/80658592