跟着官方文档学 SpringBoot 一：准备 -

getthrough

浏览: 9490 次
性别:
来自: 杭州

最近访客更多访客>>

Peak_

ling_iori

永夜-极光

hzh_it

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

跟着官方文档学 SpringBoot 一：准备

博客分类：

SpringBoot

spring-boot spirngboot

Chapter 1

【去哪儿找】

spring boot 官网地址：https://projects.spring.io/spring-boot/
spring boot 2.0文档地址：https://docs.spring.io/spring-boot/docs/2.0.0.RELEASE/reference/htmlsingle/#boot-documentation

【获得帮助】

查看 How-to documents 文档，这里提供了一些最普遍问题的解决方案。
spring boot 是构建在众多 spring 工程之上的。在 spring.io 站点中有大量的技术指南的文档，如果是刚接触 spring，可以尝试跟着引导案例学习（guides）。
去 stackoverflow.com 上提问，官方会关注带着【spring-boot】标签的问题。
或者去 github.com/spring-projects/spring-boot/issues 上提交 bug。

【系统要求】

spring boot 2.0.0.RELEASE 要求：

Java 8 及以上
spring framework 5.0.4.RELEASE 及以上
明确支持使用 Maven 3.2+ 及 Gradle 4构建

servlet 容器支持（基于 servlet 3.1版本）

Tomcat 8.5
Jetty 9.4
Undertow 1.4

除此以外，也可以将 spring boot 项目部署在任何兼容 servlet 3.0+ 的容器上。

【安装 spring boot】

既可以通过 Java 开发工具来使用 spring boot，也可以将其作为一种命令行工具安装和使用，当然，这都需要基于 JDK 1.8 及以上的开发环境。

在 cmd 输入 "java -version" 查看当前系统 Java 版本。

请注意，本文及之后的 spring boot 文章代码均基于 Maven 演示。

spring boot 的依赖 groupId 均使用 org.springframework.boot。项目的 POM 文件会典型的继承于 spring-boot-starter-parent 项目，并且在后面声明其他依赖时，会使用到多个包含”Starters“的依赖。spring boot 也提供了一个用于生成可执行 jar 文件的 maven 插件。

以下是一个典型的 spring boot 项目 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>

	<!-- Inherit defaults from Spring Boot -->
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.0.0.RELEASE</version>
	</parent>

	<!-- Add typical dependencies for a web application -->
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
	</dependencies>

	<!-- Package as an executable jar -->
	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

注意：继承 spring-boot-starter-parent 是一种使用 spring boot 很好的方式，但是这种方式并不是任何时候都适用的。当你不想使用默认的设置时，可以点击这里查看可调整的解决方式。

【Hello World】

开发之前检查环境，在 cmd 中

// 检查 JDK 版本
java -verson
// 检查 Maven 版本
mvn -v

一切就绪后，准备开始。

最原始的方式创建 spring boot 项目

首先，创建 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.RELEASE</version>
	</parent>

	<!-- Additional lines to be added here... -->

</project>

进入该 pom 文件所在位置，shift + 右键，选择“在此处打开命令窗口(win 10 是 PowerShell)”，输入“mvn package”，如果提示 mvn 命令不可用，则需要配置 maven 环境变量。执行成功后会在当前文件夹中生成一个 target 文件。以上步骤为测试 pom 文件的正确性及 maven 环境的检测。

第二步，添加依赖：

<dependencies>
	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-web</artifactId>
	</dependency>
</dependencies>

可以使用“mvn dependency:tree”查看当前项目依赖。

第三步，编写代码：

默认情况下，Maven 会编译 src/main/java 目录下的资源，因此需要创建这个目录结构，然后在 java 目录下创建名为 Example.java 的文件，内容如下：

import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.web.bind.annotation.*;

@RestController
@EnableAutoConfiguration
public class Example {

	@RequestMapping("/")
	String home() {
		return "Hello World!";
	}

        // 这是 spring boot 程序的启动方式
	public static void main(String[] args) throws Exception {
		SpringApplication.run(Example.class, args);
	}

}

在这个 java 文件中有几个稍显不同的注解：

@RestController：这个注解并不是 spring boot 特有的，它属于 spring mvc，它的作用相当于@Controller 和 @ResponseBody，即：将该 bean 纳入 spring 管理，并在请求返回时，将内容序列化为 json。

@EnableAutoConfiguration：使用这个注解，spring boot 会根据添加的依赖去“猜测”如何配置 spring，由于 spring-boot-starter-web 这个依赖已经添加了 Tomcat 和 Spring MVC，auto-comfiguration 会假设你正在开发 web 应用，并自动设置 spring。

main 方法也值得注意，可以看到，main 方法将启动程序的任务委托给了 SpringApplication 类的 run 方法。run 方法启动应用，开启 spring 和 Tomcat。通过传递 Example.class 参数告诉 SpringApplication （它是 spring 主要的组件之一）。main 方法中的 args 数组（命令行参数）也被传递。

第四步，运行示例。

在 pom 文件所在目录下，输入命令：

$ mvn spring-boot:run

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::  (v2.0.0.RELEASE)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.222 seconds (JVM running for 6.514)

打开浏览器，访问 localhost:8080，会有如下输出：

Hello World!

按 Ctrl + c，选择“Y” 退出程序。

【创建可执行 Jar】

可执行 Jar （有时候被称为胖 Jar（“fat jar”））是包含了编译的类和代码运行所需要的所有依赖的 jar 包的归档文件（可简单理解为压缩包...）。

创建的方式有许多种，比较常见的是使用 Maven 插件生成。这需要在 pom.xml 中添加以下内容：

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

注意：spring-boot-starter-parent 父项目的 pom.xml 文件中已经排除了 repackage goal，如果没有使用父 pom 文件，需要自行声明这个配置，点击查看详情。

保存后，在命令行运行如下命令：

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.RELEASE:repackage (default) @ myproject ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

完成后，查看 target 目录，会看到有名为 myproject-0.0.1-SNAPSHOT.jar 和 myproject-0.0.1-SNAPSHOT.jar.original 文件。后缀为 original 的文件是 maven 打包的原文件（在 spring boot 重新打包之前）。

此时，以下方式也可以启动项目：

java -jar target/myproject-0.0.1-SNAPSHOT.jar

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::  (v2.0.0.RELEASE)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.536 seconds (JVM running for 2.864)

OK，准备工作完成，热身结束了。

下一篇，使用 spring boot ！

分享到：

跟着官方文档学 SpringBoot 二：使用 sprin ... | Spring 整合 ActiveMq

2018-03-26 21:23
浏览 997
评论(0)
分类:行业应用
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

跟着官方文档学 SpringBoot 一：准备

【去哪儿找】

【获得帮助】

【系统要求】

【安装 spring boot】

【Hello World】

【创建可执行 Jar】

评论

发表评论

相关推荐

最近访客 更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

跟着官方文档学 SpringBoot 一：准备

【去哪儿找】

【获得帮助】

【系统要求】

【安装 spring boot】

【Hello World】

【创建可执行 Jar】

评论

发表评论

相关推荐

spring boot 特性之 YAML

spring boot 特性之 Logging

跟着官方文档学 SpringBoot 三：spring boot 特性

跟着官方文档学 SpringBoot 二：使用 spring boot

最近访客更多访客>>