springboot 学习第1期 - 创建工程

congvee2025-07-13 18:16

创建项目

创建Controller

java 复制代码

// controller/HelloController.java
package com.congvee.springboot_hello.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/hello")
public class HelloController {

    @GetMapping
    public String hello() {
        return "Hello, World!";
    }

}

接口调用

直接启动项目，默认运行在端口 8080 上，使用 postman 进行接口调试

响应统一结构

响应体的一般结构是：

plain 复制代码

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

code 0 表示成功，非 0 表示异常，可以自定义一些异常码。

可以这样定义统一类型：

java 复制代码

// common/ApiResponse.java
package com.congvee.springboot_hello.common;

import lombok.AllArgsConstructor;
import lombok.Getter;

@Getter
@AllArgsConstructor
public class ApiResponse<T> {

    private int code;
    private String message;
    private T data;

    public static <T> ApiResponse<T> success(T data) {
        return new ApiResponse<>(0, "success", data);
    }

    public static <T> ApiResponse<T> error(int code, String message) {
        return new ApiResponse<>(code, message, null);
    }

}

使用lombok注解需要额外引入依赖：

xml 复制代码

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <scope>provided</scope>
    <optional>true</optional>
</dependency>

使用：

java 复制代码

@GetMapping
public ApiResponse<String> hello() {
    return ApiResponse.success("Hello World!");
}

接口调用：