Spring Boot 后端入门

我们将使用 Spring Boot 构建一个简单的后端项目，Spring Boot 是一个流行的 Java 后端框架。

1. 创建 Spring Boot 项目：

   使用 Spring Initializr 生成一个 Spring Boot 项目。

   

   • Project：Maven
   • Language：Java
   • Spring Boot：最新的非 SNAPSHOT 非 RC 版本
   • Packaging：Jar（Jar 可以内嵌 Web 服务器，简化部署流程）
   • Java：任意 LTS 版本
   • Dependencies：Spring Web

   下载生成的压缩包，解压。

2. 认识项目结构：

   .
   ├── HELP.md
   ├── mvnw
   ├── mvnw.cmd
   ├── pom.xml
   └── src
       └── main
           ├── java
           │   └── com
           │       └── example
           │           └── demo
           │               └── DemoApplication.java
           └── resources
               ├── application.properties
               ├── static
               └── templates
   

   • pom.xml：配置项目的依赖项。需要添加依赖时编写这个文件。
   • src/main/java/：项目源代码。我们的根包名为 com.example.demo，因此代码的根目录为 src/main/java/com/example/demo/。
   • src/main/resources/：存放项目配置，项目资源等。

3. 编写代码：

   接下来将创建一个简单的 API 接口，功能是访问接口时，返回一个 Hello, world! 字符串。

   cd src/main/java/com/example/demo  # 进入根包
   mkdir controller  # 创建 controller 包
   vim controller/HelloController.java  # 创建控制器类
   

   这里我们创建了一个控制器类。在 MVC 设计模式中，控制器负责处理 HTTP 请求，并返回 HTTP 响应。下面编写控制器代码：

   package com.example.demo.controller;
   
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   @RequestMapping("/api")
   public class HelloController {
   
       @GetMapping("/hello")
       public String sayHello() {
           return "Hello, world!";
       }
   }
   

   • @RequestMapping("/api")：指定控制器类的基础路径为 /api，这意味着所有在这个类中定义的请求路径都将以 /api 开头。
   • @GetMapping("/hello")：定义了一个处理 GET 请求的方法，路径为 /api/hello。当用户访问这个 URL 时，sayHello 方法会被调用，方法的返回值即为 HTTP 响应体。

4. 构建项目：

   ./mvnw clean install
   

5. 运行程序：

   ./mvnw spring-boot:run     # 编译并运行
   java -jar target/demo-*.jar  # 或者直接运行 JAR 包
   

6. 访问服务：

   $ curl http://localhost:8080/api/hello
   Hello, world!
   

   可以看到，/api/hello 接口返回了字符串 Hello, world!，我们的后端项目成功了。

接下来，我们学习如何在 API 中接收参数。

下一篇：Spring Boot 后端接收参数