10.1 Installation Instructions for the Java Developer

你可以使用Spring Boot, 以任何标准的Java库的使用方式. 如果打算这么做的话,只需在你的类路径下包含合适的spring-boot-*.jar文件即可. Spring Boot不需要任何特别的工具集成,所有你可以使用任一IDE或者文本编辑器. 再者,Spring Boot应用也不存在特别之处,因此你可以运行和调试 Spring Boot程序，像你运行和调试其他Java程序一样.

尽管你可以拷贝Spring Boot Jar包，但是我们还是强烈要求你使用支持依赖管理的构建工具(例如Maven或者Gradle).

Maven Installation

Spring Boot兼容Apache Maven 3.2及以上版本. 如果你还未安装Maven,请参照maven.apache.org官方网站上的指令进行安装.

tips

在大多数操作系统上，Maven可以使用包管理器进行安装.如果你使用OSX Homebrew系统,请尝试brew install maven命令.Unbuntu用户可使用sudo apt-get install maven命令. 带Chocolatey包管理器的Windows用户请以管理员权限使用choco install命令.

Spring Boot依赖使用org.springframework.boot groupId. 通常,你的Maven POM文件需要继承spring-boot-starter-parent项目并且至少需声明一个或者 多个“Starter”依赖. Spring Boot还提供一个可选的Maven插件用于创建可运行的jar包.

典型的POM.xml文件如下图所示: 

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4.   <modelVersion>4.0.0</modelVersion>
  5.   <groupId>com.example</groupId>
  6.   <artifactId>myproject</artifactId>
  7.   <version>0.0.1-SNAPSHOT</version>
  9.   <!-- Inherit defaults from Spring Boot -->
  10.   <parent>
  11.     <groupId>org.springframework.boot</groupId>
  12.     <artifactId>spring-boot-starter-parent</artifactId>
  13.     <version>2.0.2.RELEASE</version>
  14.   </parent>
  16.   <!-- Add typical dependencies for a web application -->
  17.   <dependencies>
  18.     <dependency>
  19.       <groupId>org.springframework.boot</groupId>
  20.       <artifactId>spring-boot-starter-web</artifactId>
  21.     </dependency>
  22.   </dependencies>
  24.    <!-- Package as an executable jar -->
  25.    <build>
  26.      <plugins>
  27.        <plugin>
  28.          <groupId>org.springframework.boot</groupId>
  29.          <artifactId>spring-boot-maven-plugin</artifactId>
  30.        </plugin>
  31.      </plugins>
  32.    </build>
  33. </project>

tips

Spring Boot通过继承spring-boot-starter-parent项目是一个非常不错的方法,但不是每次都合适.有时你需要从自己项目的父POM继承,或者你不打算使用默认配置.在这种情况下,请参照章节寻求替代方案，该方案使用import域.

Gradle Installation

Spring Boot兼容Gradle 4. 如果你还未安装Gradle,请参照gradle.org官方网站上的指令进行安装.

Spring Boot依赖使用org.springframework.boot group. 通常,你的项目声明依赖一个或者多个“Starter”. Spring Boot还提供一个可选的Gradle插件用于简化依赖声明和创建可运行的jar包.

  1. Gradle Wrapper 
  3. Gradle Wrapper为你构建项目时提供了一种优雅的方式获取Gradle. 它是一段脚本库,能随你的代码一起提交从而引导构建过程.具体详情请参考[https://docs.gradle.org/4.2.1/userguide/gradle_wrapper.html]

典型的build.gradle文件如下图所示: 

  1. plugins {
  2.  id 'org.springframework.boot' version '2.0.2.RELEASE'
  3.  id 'java'
  4. }
  6. jar {
  7.  baseName = 'myproject'
  8.  version = '0.0.1-SNAPSHOT'
  9. }
  11. repositories {
  12.  jcenter()
  13. }
  15. dependencies {
  16.  compile("org.springframework.boot:spring-boot-starter-web")
  17.  testCompile("org.springframework.boot:spring-boot-starter-test")
  18. }