Spring Boot 后端入门

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

1. 创建 Spring Boot 项目：

   使用 Spring Initializr 来生成一个 Spring Boot 项目。选择需要的依赖，比如 Spring Web。

   

   • Project 选择 Maven
   • Language 选择 Java
   • Spring Boot 选择最新的非 SNAPSHOT 版本
   • Packaging 选择 Jar，这样可以内嵌 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
   # 创建 controller 包
   mkdir 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. 使用 Maven 构建项目：

   在项目根目录下执行下面的命令来编译和打包程序。

   mvn clean install
   

5. 运行程序：

   可以通过命令行运行程序：

   mvn spring-boot:run
   

   也可以直接运行生成的 JAR 文件：

   java -jar target/your-app-name.jar
   

6. 访问后端服务：

   默认情况下，Spring Boot 应用程序会在本地的 8080 端口启动。我们可以尝试访问一下刚刚创建的 API：

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

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

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

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