简介
Spring Boot 让创建独立的产品级应用变得更简单,Spring Boot 可以用于创建用Java -jar 启动的 Java 应用,以及一些传统的war布署,还提供了一些命令行工具运行Spring 脚本。
环境需要:
- Java 7 以上,最好 Java 8,Java 6 需要额外配置
- Maven (3.2+)或 Gradle(2.9+,3不支持)
支持的Servlet 容器
- Tomcat 8,Java 7+
- Tomcat 7,Java 6+
- Jetty 9.3,Java 8+
- Jetty 9.2,Java 7+
- Jetty 8,Java 6+
- Undertow 1.3,Java 7+
安装Spring Boot
- 安装Java,确保
java -version
是1.7+ - 安装Maven:
brew install maven
或yum install maven
- 安装Spring Boot CLI,Linux可以用 sdkman.io 的sdk安装:
sdk install springboot
,macOS可以用brew install springboot
Hello World
新建一个文件名为:app.groovy
。
@RestController
class ThisWillActuallyRun {
@RequestMapping("/")
String home() {
"Hello World!"
}
}
运行:spring run app.groovy
在浏览器打开:http://localhost:8080 即可访问:
Hello World!
创建第一个应用程序
首先创建一个Mavens要用的pom.xml文件,文件中包含了用于构建工程的清单:
<?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>com.example</groupId>
<artifactId>myproject</artifactId>
<version>0.0.1-SNAPSHOT</version>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.0.BUILD-SNAPSHOT</version>
</parent>
<!-- Additional lines to be added here... -->
<!-- (you don't need this if you are using a .RELEASE version) -->
<repositories>
<repository>
<id>spring-snapshots</id>
<url>http://repo.spring.io/snapshot</url>
<snapshots><enabled>true</enabled></snapshots>
</repository>
<repository>
<id>spring-milestones</id>
<url>http://repo.spring.io/milestone</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>spring-snapshots</id>
<url>http://repo.spring.io/snapshot</url>
</pluginRepository>
<pluginRepository>
<id>spring-milestones</id>
<url>http://repo.spring.io/milestone</url>
</pluginRepository>
</pluginRepositories>
</project>
添加classpath依赖
可以用 mvn package
来构建工程。
然后添加依赖,Spring Boot 提供了很多starter(启动程序),可以很方便地把jar添加到classpath中,上面这个示例是在POM的 parent
字段中用的 spring-boot-starter-parent
,spring-boot-starter-parent
是一个特殊的starter,它提供了一些有用的Maven默认配置项,还提供了dependency-management
字段,让你可以对依赖触发 version
标签。
其他的 starter 简单地提供了你需要的依赖,当我们开发web应用时,我们将添加spring-boot-starter-web
依赖,在这之前,我们先看一下现有都有什么:
$mvn dependency:tree
这个命令输出本工程的树形依赖表,你会发现spring-boot-starter-parent
没有提供自身的依赖,我们编辑一下pom.xml
,把spring-boot-starter-web
依赖加进parent
字段:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
再次运行mvn dependency:tree
就会发现,多了一些依赖,其中包括Tomcat web server 和 Spring Boot 自己。
写具体代码,我们需要创建一个单独的 Java 文件,Maven将默认从src/main/java
编译源代码,所以需要创建文件夹,让路径为:src/main/java/Example.java
。
import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.stereotype.*;
import org.springframework.web.bind.annotation.*;
@RestController
@EnableAutoConfiguration
public class Example {
@RequestMapping("/")
String home() {
return "Hello World!";
}
public static void main(String[] args) throws Exception {
SpringApplication.run(Example.class, args);
}
}
虽然代码不多,但是背后的东西其实挺多了。看一下@RestController
和 @RequestMapping("/")
注解。
@RestController
是第一个注解,它被叫做“固定注解”,用于提示人们读代码,对于Spring,它的角色很特别,这个类是一个 web的 @Controller
,所以Spring 认为它是用来接收 http 请求的。
@RequestMapping("/")
注解提供了一个“路由”信息。它告诉 Spring 任何 带 "/"
的 http 请求都应该被映射到 home 方法。@RestController
注解则告诉 Spring 去把渲染结果字符串返回给调用者。
这两个注解是 Spring MVC 的注解,而不是Spring Boot特有的。
第二个类级别的注解是@EnableAutoConfiguration
,它告诉 Spring Boot 去“猜测”你将如何基于刚才添加的jar依赖去配置Spring。因为 spring-boot-starter-web
添加了 Tomcat
和 Spring MVC
,自动配置将假设你正在开发web应用,并且将安装Spring。
主函数main,即程序入口。它通过调用SpringApplication.run
代表 Spring Boot 的 SpringApplication 类,SpringApplication.run
将启动应用程序,随之启动自动配置的Tomcat web server,我们传入了一个 Example.class
参数,告诉 SpringApplication 它是主要的 Spring 组件,args
数组包括一些命令行参数。
运行程序,在应用的根目录输入命令:
$ mvn spring-boot:run
在浏览器打开 http://localhost:8080 即可访问,ctrl + c
可以优雅地退出。
创建一个可执行的jar
可执行的jar也叫做 “fat jar”,其中包含编译过的classes以及所有运行所需要的jar依赖。
Java 没有提供任何加载内嵌jar文件(比如jar文件中包含jar文件)的标准方式,如果你在发布自包含的应用时会有问题。
要解决这个问题,很多开发者使用“uber” jar,“uber” jar 简单地把所有classes打包成一个包。这种方式的问题是很难发现哪个lib是你的应用中实际使用的,还有一个问题是在多个jar中有同名文件而内容不同。
Spring Boot 用另一种方式解决内嵌jar的问题。
我们需要把spring-boot-maven-plugin
添加到pom.xml
中才能创建可执行jar,把下面这一段添加到dependencies
字段的后面:
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
spring-boot-starter-parent
POM 包含的 < executions >配置的目标是绑定到 repackage
,如果你没用 parent
POM,则需要自己声明这个配置。
保存 pom.xml
,运行 mvn package
:
$ mvn package
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building myproject 0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] .... ..
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ myproject ---
[INFO] Building jar: /Users/developer/example/spring-boot-example/target/myproject-0.0.1-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:2.0.0.BUILD-SNAPSHOT:repackage (default) @ myproject ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
你会发现在 target
目录中,有myproject-0.0.1-SNAPSHOT.jar
,这个文件大概有10m,如果你想看里面的东西,可以用 jar tvf
:
$ jar tvf target/myproject-0.0.1-SNAPSHOT.jar
你还会在 parent
中发现一个更小的文件,叫做myproject-0.0.1-SNAPSHOT.jar.original
,它是Spring Boot重新打包之前 Maven 创建的最原始的文件。
要运行这个应用,使用 java -jar 命令:
$ java -jar target/myproject-0.0.1-SNAPSHOT.jar
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.0.0.BUILD-SNAPSHOT)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.536 seconds (JVM running for 2.864)
可以用 ctrl + c 优雅地退出。