搭建 SpringBoot 项目

从零搭建 SpringBoot 项目的方式有很多中,如在 https://start.spring.io/ 网站上初始化一个模板,或者在 IDEA 中新建 SpringBoot 项目(以前只有付费版本才支持),本文以 https://start.spring.io/ 为例,从零搭建 SpringBoot 项目。

1. 从零搭建 SpringBoot 项目

打开 https://start.spring.io/ 网站,如下:

  • Project:构建工具
  • Language:编程语言
  • Spring Boot:版本
  • Project Metadata:项目的元信息
    • Group:组织标记
    • Artifact:项目名称
    • Name:通常用于标识项目在开发环境、文档或构建工具中的‌展示名称,通常与 Artifact 一致
    • Description:描述细腻下
    • Package Name:Java 项目的默认根包路径,所有自动生成的组件(如控制器、服务、实体类等)都会默认放置在这个包及其子包下。通常由 ‌Group‌ 和 ‌Artifact‌ 自动拼接而成,格式为:<Group>.<Artifact>(以小写、无特殊字符的形式)。
    • Packaging:打包方式
    • Configuration:配置文件的格式
    • Java:Java 版本
  • Dependencies:项目的依赖,想要搭建 Web 项目,必须选择的依赖是 “Spring Web”

最后,点击 “GENERATE” 生成项目。

2. 导入 IDEA

点击 “GENERATE” 后,会下载一个 Spring Boot 的项目,现在用 IDEA 打开这个项目,当 MAVEN 加载了所有依赖后,我们可以看到如下的界面:

至此,Spring Boot 的项目已经搭建完成,主要的几个文件包括:

  • pom.xml 为 maven 项目配置依赖的文件
  • DemoApplication.java 为 SpringBoot 启动类
  • resources 文件夹下 application.properties 为配置文件

3. 建立可以访问的 api 接口

新建一个 DemoController 的类(暂且不考虑代码的分层)

package com.example.demo;

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

@RestController
public class DemoController {
    @GetMapping("/demo")
    public String demo() {
        return "Hello World";
    }
}

点击运行,出现下面的启动界面说明已经正常启动了

现在在浏览器输入:http://localhost:8080/demo,就能看到正常的输出了。至此,基本的 Spring Boot 项目已经搭建起来。

4. 配置文件

Spring Boot 提供了大量的自动配置,极大地简化了 Spring 应用的开发过程。然而,在 Spring Boot 中还有两种全局的配置文件:

  • application.properties
  • application.yml

其中,application.yml 是一种使用 YAML 语言编写的文件,它与 application.properties 一样,可以在 Spring Boot 启动时被自动读取,修改 Spring Boot 自动配置的默认值。