package com.example.demo.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @RestController
 * 这是一个组合注解，它本身包含了 @Controller 和 @ResponseBody 两个注解。
 * 它的核心作用是：
 * 1. @Controller：向 Spring IoC 容器声明这是一个控制器（Controller）组件，
 * 使其能够被组件扫描（ComponentScan）机制发现并注册为 Bean。
 * 2. @ResponseBody：告知 Spring MVC 框架，本类中的所有方法返回的都不是视图名，
 * 而是需要直接写入 HTTP 响应体（Response Body）的数据。
 * 这是构建 RESTful API 的关键，意味着我们将直接返回 JSON、XML 或纯文本等数据。
 */
@RestController
public class HelloController {

    /**
     * @GetMapping("/hello")
     * 这是一个请求映射（Request Mapping）注解，用于处理 HTTP GET 请求。
     * 它是 @RequestMapping(method = RequestMethod.GET) 的一个更简洁的缩写形式。
     * 它的作用是将所有访问路径为 "/hello" 的 GET 请求，都路由到这个 sayHello() 方法上来进行处理。
     *
     * @return String
     * 由于类上标注了 @RestController，此方法返回的 String "Hello..." 将被
     * Spring MVC 视为响应体内容，通过 StringHttpMessageConverter 直接写入响应，
     * 最终在浏览器或 API 测试工具中呈现。
     */
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, 这是我的第一个 Spring MVC API!";
    }
}

package com.example.springbootdemo.controller;

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

@RestController
@RequestMapping("/users") // 在类上定义父路径 /users
public class UserController {

    /**
     * 此方法的完整访问路径是类上的 @RequestMapping + 方法上的 @GetMapping
     * 即: /users + /all = /users/all
     */
    @GetMapping("/all")
    public String getAllUsers() {
        return "返回所有用户列表";
    }
}

// ... 省略 import 和类注解 ...
@RestController
@RequestMapping("/users")
public class UserController {

    // ... 已有的 getAllUsers() 方法 ...

    /**
     * {id} 是一个路径占位符。
     * @PathVariable("id") 注解会将 URL 中占位符 {id} 的实际值，
     * 绑定到方法的 Long id 参数上。
     * 例如，当请求 /users/101 时，id 参数的值就是 101。
     */
    @GetMapping("/{id}")
    public String getUserById(@PathVariable("id") Long id) {
        return "正在查询 ID 为: " + id + " 的用户";
    }
}

package com.example.springbootdemo.controller;

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

@RestController
public class AntController {

    // 匹配 /ant/testA, /ant/testB, 但不匹配 /ant/testAB
    @GetMapping("/ant/test?")
    public String testAnt1() {
        return "Ant-style match: ?";
    }

    // 匹配 /ant/test, /ant/testABC, 但不匹配 /ant/test/abc
    @GetMapping("/ant/test*")
    public String testAnt2() {
        return "Ant-style match: *";
    }

    // 匹配 /ant/any/path/can/be/here
    // 这个在 Springboot3 是会报错的！
    @GetMapping("/ant/**/any")
    public String testAnt3() {
        return "Ant-style match: **";
    }
}

package com.example.springbootdemo.controller;

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

@RestController
public class PreciseController {

    /**
     * 只有当请求 URL 中包含名为 "version" 的参数时，此方法才会被调用。
     * 例如: /precise?version = 1
     */
    @GetMapping(value = "/precise", params = "version")
    public String testParams() {
        return "Match with params 'version'";
    }

    /**
     * 只有当请求 URL 中包含名为 "version" 且其值等于 "2" 的参数时，才会被调用。
     * 例如: /precise?version = 2
     */
    @GetMapping(value = "/precise", params = "version=2")
    public String testParamsWithValue() {
        return "Match with params 'version=2'";
    }

    /**
     * 只有当请求头中包含名为 "X-API-VERSION" 的头信息时，此方法才会被调用。
     */
    @GetMapping(value = "/precise", headers = "X-API-VERSION")
    public String testHeaders() {
        return "Match with header 'X-API-VERSION'";
    }
}

package com.example.springbootdemo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/users")
public class UserController {

    // ... 此前已有的方法 ...

    /**
     * @RequestParam 用于获取 URL 查询参数 (Query Parameter)。
     * * @param keyword 绑定 URL 中名为 "keyword" 的参数。如果 URL 是 /users/search?keyword = admin, keyword 的值就是 "admin"。
     * @param page 绑定名为 "page" 的参数。它有两个额外属性：
     * - required = false: 表示这个参数不是必需的。如果请求中不包含 page 参数，程序不会报错。
     * - defaultValue = "1": 如果请求中没有传递 page 参数，则默认为 "1"。
     * @return 响应字符串
     */
    @GetMapping("/search")
    public String searchUsers(
            // 这里一样的，可以省略
            @RequestParam String keyword,
            @RequestParam(value = "page", required = false, defaultValue = "1") Integer page) {

        return "正在搜索用户，关键词: " + keyword + ", 页码: " + page;
    }
}

package com.example.springbootdemo.model;

import lombok.Data;

@Data // Lombok 注解，自动生成 Getter, Setter, toString, equals, hashCode 等方法
public class User {
    private Long id;
    private String username;
    private String email;
}

package com.example.springbootdemo.controller;

import com.example.springbootdemo.model.User;
import org.springframework.web.bind.annotation.*;

// 注意，这里的 RestController 其实就是 @Controller + @ResponseBody
@RestController
@RequestMapping("/users") // 在类上定义父路径 /users
public class UserController {
    
    // ....其余的所有代码
    
    /**
     * @RequestBody 注解告诉 Spring MVC 将请求体中的 JSON 数据
     * 自动转换为一个 User 对象
     * @param user Spring MVC 自动实例化的 User 对象
     * @return 响应字符串
     */
    @PostMapping("/create")
    public String createUser(@RequestBody User user) {
        // 在实际项目中，这里会调用 Service 层将 user 对象存入数据库
        return "成功创建用户: " + user.toString();
    }
}

package com.example.springbootdemo.controller;

import com.example.springbootdemo.model.User;
import org.springframework.web.bind.annotation.GetMapping;
// ... 其他 import ...

@RestController
@RequestMapping("/users")
public class UserController {

    // ... 此前已有的方法 ...

    /**
     * 方法参数是一个 POJO (User user)，且没有 @RequestBody 注解。
     * Spring MVC 会自动将 URL 中的查询参数 ?username =...&email =... 
     * 绑定到 user 对象的 username 和 email 属性上。
     * @param user Spring MVC 自动实例化的 User 对象
     * @return 响应字符串
     */
    @GetMapping("/filter")
    public String filterUsers(User user) {
        return "根据条件筛选用户: " + user.toString();
    }
}