Spring Boot 开发环境搭建和项目启动

本节课主要对 JDK 的配置、Spring Boot 工程的构建和项目的启动、Spring Boot 项目工程的结构进行讲解和分析，核心内容有：

• 配置 JDK
• 构建 Spring Boot 工程
• Spring Boot 项目的工程结构

1.1 配置 JDK

本课程使用 IDEA 进行开发，在 IDEA 中配置 JDK 很简单，打开 File，选择 Project Structure，如下图所示：

IDEA中配置jdk

接下来按以下步骤操作即可：

选择 SDKs；
在 JDK home path 中选择本地 JDK 的安装目录；
在 Name 中为 JDK 自定义名字。
通过以上步骤，即可导入本地安装的 JDK。使用 STS 或 Eclipse 的朋友，可以通过以下两步完成添加：

依次选择 Window -> Preference -> Java -> Instralled JRES，添加本地 JDK；

依次选择 Window -> Preference -> Java -> Compiler，选择 JRE，和 JDK 保持一致。

1.2 构建 Spring Boot 工程

1.2.1 IDEA 快速构建

在 IDEA 中，我们可以依次选择 File -> New -> Project 快速构建 Spring Boot 工程。

接着，选择 Spring Initializr，在 Project SDK 中选择我们刚刚导入的 JDK，点击 Next，跳至项目的配置信息页，按下面提示填写即可。

Group：填入企业域名，本课程使用 com.itcodai。
Artifact：填入项目名称，本课程中每一课的工程名以“course+课号”命名，本文使用 course01。
Dependencies：可以添加项目中所需要的依赖信息，大家可根据实际情况添加，本课程只需要选择 Web 即可。

1.2.2 官方构建

我们可采用的第二种构建方式是官方构建，步骤如下。

访问 http://start.spring.io/。
在页面上输入相应的 Spring Boot 版本、Group 和 Artifact 信息及项目依赖，然后创建项目。

创建Spring Boot工程

• 解压后，使用 IDEA 导入该 Maven 工程。操作步骤为：依次单击 File -> New -> Model from Existing Source，然后选择解压后的项目文件夹。使用 Eclipse 的朋友，可以依次单击 Import -> Existing Maven Projects -> Next，同样选择解压后的项目文件夹。

1.2.3 Maven 配置

Spring Boot 项目创建完成之后，接下来需要进行 Maven 配置。

依次选择 File -> Settings，搜索“Maven”，配置本地的 Maven 信息，如下图所示：

maven配置

• 在 Maven home directory 中选择本地 Maven 的安装路径；
• 在 User settings file 中选择本地 Maven 的配置文件所在路径。
  我们在配置文件中配置一下国内阿里的镜像，这样在下载 Maven 依赖时，速度会很快。

    <mirror>
        <id>nexus-aliyun</id>
        <mirrorOf>*</mirrorOf>
        <name>Nexus aliyun</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public</url>
    </mirror>

使用 Eclipse 的朋友，可以依次选择 Window -> Preference -> Maven -> User Settings 进行配置，配置方式和上面一致。

1.2.4 编码配置

同样地，新建项目后，我们一般都需要配置编码，这点非常重要，很多初学者都会忘记这一步，所以要养成良好的习惯。

IDEA 中，仍然依次打开 File -> Settings，搜索“Encoding”，配置本地的编码信息，如下图所示：

编码配置

使用 Eclipse 的朋友，有两个地方需要设置一下编码，设置过程如下。

• 选择 Window -> Perferences -> General -> Workspace，将 Text File Encoding 改成 UTF-8。
• 选择 Window -> Perferences -> General -> Content Types，选中 Text，在 Default Encoding 处填入 UTF-8。
  OK，编码设置完成后即可启动项目工程了。

1.3 Spring Boot 项目的工程结构

Spring Boot 项目总共有三个模块。

• src/main/java 路径：主要编写业务程序。
• src/main/resources 路径：存放静态文件和配置文件。
• src/test/java 路径：主要编写测试程序。

Spring Boot项目工程结构

默认情况下，如上图所示，会创建一个启动类 Course01Application，该类上面有个 @SpringBootApplication 注解，该启动类中有个 main 方法。没错，Spring Boot 启动只要运行该 main 方法即可，非常方便。另外，Spring Boot 内部集成了 Tomcat，不需要我们人为手动去配置 Tomcat，开发者只需要关注具体的业务逻辑即可。

到此为止，Spring Boot 就启动成功了，为了比较清楚地看到效果，我们写个 Controller 来测试一下，代码如下：

package com.itcodai.course01.controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/start")
public class StartController {

    @RequestMapping("/springboot")
    public String startSpringBoot() {
        return "Welcome to the world of Spring Boot!";
    }
}

重新运行 main 方法启动项目，在浏览器中输入：localhost:8080/start/springboot。如果看到 “Welcome to the world of Spring Boot!”提示，那么恭喜你，项目启动成功！

Spring Boot 就是这么简单方便，端口号默认是 8080，如果想要修改，可以在 application.yml 文件中使用 server.port 人为指定端口，如 8001 端口：

server:
  port: 8001