本节课主要对 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