SpringBoot 入门篇（一） Hello World

一、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）给出的SpringBoot的特性

  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。
  文档中的前10个小结是在使用SpringBoot之前的一些说明，其中需要注意的就是Servlet容器的版本和构建工具。官方文档中强烈推荐使用 Maven或者Gradle来构建SpringBoot项目，因此这里选择Maven 3.5.2。

---

二、跟着官方文档学习SpringBoot

1、SpringBoot入门Demo

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

  （2）将Maven项目导入IDEA

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

  （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方法，控制台打印如下信息

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

---

2、SpringBoot运行方式

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

   
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

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

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

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

3、构建SpringBoot项目注意事项

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

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

        1.8
    

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

        
            
                org.springframework.boot
                spring-boot-dependencies
                1.5.13.RELEASE
                pom
                import
            
        
    

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

---

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