Spring Boot干货系列:(一)优雅的入门篇

Spring Boot 干货系列:(一)优雅的入门篇

2017-02-26 嘟嘟 MD 嘟爷 java 超神学堂

 

前言

Spring 一直是很火的一个开源框架,在过去的一段时间里,Spring Boot 在社区中热度一直很高,所以决定花时间来了解和学习,为自己做技术储备。

 

正文

首先声明,Spring Boot 不是一门新技术,所以不用紧张。从本质上来说,Spring Boot 就是 Spring, 它做了那些没有它你也会去做的 Spring Bean 配置。它使用“习惯优于配置”(项目中存在大量的配置,此外还内置了一个习惯性的配置,让你无需手动进行配置)的理念让你的项目快速运行起来。使用 Spring Boot 很容易创建一个独立运行(运行 jar, 内嵌 Servlet 容器)、准生产级别的基于 Spring 框架的项目,使用 Spring Boot 你可以不用或者只需要很少的 Spring 配置。

 

Spring Boot 精要

Spring 将很多魔法带入了 Spring 应用程序的开发之中,其中最重要的是以下四个核心。

  • 自动配置:针对很多 Spring 应用程序常见的应用功能,Spring Boot 能自动提供相关配置

  • 起步依赖:告诉 Spring Boot 需要什么功能,它就能引入需要的库。

  • 命令行界面:这是 Spring Boot 的可选特性,借此你只需写代码就能完成完整的应用程序,无需传统项目构建。

  • Actuator:让你能够深入运行中的 Spring Boot 应用程序,一套究竟。

详细的我们就不展开,等你爱上后自然会去深入的了解,后续章节我们会一一展开介绍。接下来让我们开搞吧。我已经迫不及待的要尝尝 Spring Boot 的味道了。

 

系统要求

目前 Spring Boot 正式版为 1.5.1.RELEASE 默认情况下,Spring Boot 1.5.1.RELEASE 需要 Java 7 和 Spring Framework 4.3.6.RELEASE 或更高版本, 你也可以使用 Spring Boot with Java 6 和一些额外的配置(不建议), 使用 Maven(3.2+)或 Gradle 2(2.9 或更高版本)和 3 来构建。

虽然你可以使用 Java 6 或 7 的 Spring Boot,但我们通常推荐 Java 8。

所以本博客系列统一使用 Java 1.8,Spring Boot 1.5.1.RELEASE 以及 Maven3.3.9 版本。开发工具使用 IDEA(强烈推荐,可以看我另外一篇介绍 IDEA 入门文章,内有官方中文教程:Java 人员正确使用 IntelliJ IDEA 的方式,点我头像里面有文章)

 

光速入门 - 开发一个 Web 服务

没有比较就没有伤害,让我们先看看传统 Spring MVC 开发一个简单的 Hello World Web 应用程序,你应该做什么,我能想到一些基本的需求。

  • 一个项目结构,其中有一个包含必要依赖的 Maven 或者 Gradle 构建文件,最起码要有 Spring MVC 和 Servlet API 这些依赖。

  • 一个 web.xml 文件(或者一个 WebApplicationInitializer 实现),其中声明了 Spring 的 DispatcherServlet。

  • 一个启动了 Spring MVC 的 Spring 配置

  • 一控制器类,以“hello World”相应 HTTP 请求。

  • 一个用于部署应用程序的 Web 应用服务器,比如 Tomcat。

     

最让人难以接受的是,这份清单里面只有一个东西是和 Hello World 功能相关的,即控制器,剩下的都是 Spring 开发的 Web 应用程序必需的通用模板。

接下来看看 Spring Boot 如何搞定?

很简单,我仅仅只需要非常少的几个配置就可以迅速方便的搭建起来一套 web 项目

 

初始化 Spring Boot 项目

构建一个 Sping Boot 的 Maven 项目,强烈推荐 Spring Initializr, 它从本质上来说就是一个 Web 应用程序,它能为你生成 Spring Boot 项目结构。
Spring Initializr 有几种用法:

  • 通过 Web 界面使用

  1. 访问:http://start.spring.io/

  2. 选择构建工具Maven Project、Spring Boot 版本1.5.1以及一些工程基本信息,可参考下图所示

  3. 点击Generate Project下载项目压缩包

  4. 导入到你的工程,如果是 IDEA,则需要:
    a. 菜单中选择File–>New–>Project from Existing Sources...
    b. 选择解压后的项目文件夹,点击OK
    c. 点击Import project from external model并选择Maven,点击Next到底为止。
    d. 若你的环境有多个版本的 JDK,注意到选择Java SDK的时候请选择Java 7以上的版本

  • 通过 IntelliJ IDEA 使用 (个人推荐)
    IntelliJ IDEA 是非常流行的 IDE,IntelliJ IDEA 14.1 已经支持 Spring Boot 了。
    创建 Spring Boot 操作步骤如下:
    在 File 菜单里面选择 New > Project, 然后选择 Spring Initializr,接着如下图一步步操作即可。

 

项目结构

根据上面的操作已经初始化了一个 Spring Boot 的框架了,项目结构如下:

如你所见,项目里面基本没有代码,除了几个空目录外,还包含如下几样东西。

  • pom.xml:Maven 构建说明文件。

  • Chapter1Application.java:一个带有 main() 方法的类,用于启动应用程序(关键)。

  • Chapter1ApplicationTests.java:一个空的 Junit 测试类,它加载了一个使用 Spring Boot 字典配置功能的 Spring 应用程序上下文。

  • application.properties:一个空的 properties 文件,你可以根据需要添加配置属性。

     

     

解析 pom.xml

大家跟我一起移步 pom.xml, 看看 Spring Boot 的跟普通 Spring MVC 工程的 Maven 配置有啥不一样。

可以看出,有几个配置是不大一样的, 我们挑几个重要的说说,要是客观不想过早的了解这些,自行跳过这一知识点即可。

 

解析 Spring Boot 父级依赖

这块配置就是 Spring Boot 父级依赖,有了这个,当前的项目就是 Spring Boot 项目了,spring-boot-starter-parent 是一个特殊的 starter, 它用来提供相关的 Maven 默认依赖,使用它之后,常用的包依赖可以省去 version 标签。关于 Spring Boot 提供了哪些 jar 包的依赖,可查看 C:\Users\ 用户.m2\repository\org\springframework\boot\spring-boot-dependencies\1.5.1.RELEASE\spring-boot-dependencies-1.5.1.RELEASE.pom

这里我就贴一点点意思意思,如下:

如果你不想使用某个依赖默认的版本,您还可以通过覆盖自己的项目中的属性来覆盖各个依赖项,例如,要升级到另一个 Spring Data 版本系列,您可以将以下内容添加到 pom.xml 中。

原本默认版本是 Ingalls-RELEASE 的(看上面最后一行有说明 Ingalls-RELEASE),现在就使用 Fowler-SR2 版本了,简单吧。

并不是每个人都喜欢继承自 spring-boot-starter-parent POM。您可能有您需要使用的自己的公司标准 parent,或者您可能更喜欢显式声明所有的 Maven 配置。

如果你不想使用 spring-boot-starter-parent,您仍然可以通过使用 scope = import 依赖关系来保持依赖关系管理:

该设置不允许您使用如上所述的属性 (properties) 覆盖各个依赖项,要实现相同的结果,您需要在 spring-boot-dependencies 项之前的项目的 dependencyManagement 中添加一个配置,例如,要升级到另一个 Spring Data 版本系列,您可以将以下内容添加到 pom.xml 中。


起步依赖 spring-boot-starter-xx

Spring Boot 提供了很多”开箱即用“的依赖模块,都是以 spring-boot-starter-xx 作为命名的。举个例子来说明一下这个起步依赖的好处,比如组装台式机和品牌机,自己组装的话需要自己去选择不同的零件,最后还要组装起来,期间有可能会遇到零件不匹配的问题。耗时又消力,而品牌机就好一点,买来就能直接用的,后续想换零件也是可以的。相比较之下,后者带来的效果更好点(这里就不讨论价格问题哈),起步依赖就像这里的品牌机,自动给你封装好了你想要实现的功能的依赖。就比如我们之前要实现 web 功能,引入了 spring-boot-starter-web 这个起步依赖。我们来看看 spring-boot-starter-web 到底依赖了哪些, 如下图:

嘿嘿嘿,看来依赖了好多呢,如果让我自己弄估计要调半天,所以 Spring Boot 通过提供众多起步依赖降低项目依赖的复杂度。起步依赖本质上是一个 Maven 项目对象模型(Project Object Model,POM),定义了对其他库的传递依赖,这些东西加在一起即支持某项功能。很多起步依赖的命名都暗示了它们提供的某种或者某类功能。

 

Spring Boot Maven 插件

上面的配置就是 Spring Boot Maven 插件,Spring Boot Maven 插件提供了许多方便的功能:

  • 把项目打包成一个可执行的超级 JAR(uber-JAR), 包括把应用程序的所有依赖打入 JAR 文件内,并为 JAR 添加一个描述文件,其中的内容能让你用 java -jar 来运行应用程序。

  • 搜索 public static void main() 方法来标记为可运行类。

 

应用入口类

Chapter1Application 是一个很关键的启动类,程序的入口就是这里, 为了演示简单,我们不再新

建控制类,而是直接在这个入口类中编写,添加 @RestController 以及 index 方法,如下:

  1. @SpringBootApplication 是 Sprnig Boot 项目的核心注解,主要目的是开启自动配置。后续讲解原理的时候再深入介绍。

  2. main 方法这是一个标准的 Java 应用的 main 的方法,主要作用是作为项目启动的入口。

  3. @RestController 注解等价于 @Controller+@ResponseBody 的结合,使用这个注解的类里面的方法都以 json 格式输出。

最后,启动项目有三种方式:

  • Chapter1Application 的 main 方法

  • 使用命令 mvn spring-boot:run”在命令行启动该应用,IDEA 中该命令在如下位置:

  • 运行“mvn package”进行打包时,会打包成一个可以直接运行的 JAR 文件,使用“java -jar”命令就可以直接运行。

打开浏览器访问 http://localhost:8080, 你就能看到页面显示 Hello Spring Boot 效果了,一个简单的 Web 的项目就是如此简单。

 

结束

虽然我上面讲解了那么多,但是实际开发步骤就是那么简单暴力,初始化一个 Spring Boot,添加一个控制类,启动就能看到效果了。

本章作为入门 Spring Boot 的入门介绍,相关的需要理解的概念就只有这几点:

  • Spring Boot 父级依赖的概念

  • 起步依赖 spring-boot-starter-xx 的概念

  • 应用入口类的作用

最后希望你玩的开心 ~