import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import org.springframework.http.MediaType;

@Controller
@RequestMapping("/users") // 類級別映射，所有方法都在 /users 路徑下
public class UserController {

    // 映射 GET /users/{id}
    @RequestMapping(value = "/{id}", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_VALUE)
    @ResponseBody // 如果用 @Controller 需要加這個(gè)來返回?cái)?shù)據(jù)
    public User getUser(@PathVariable Long id) {
        // ... 獲取用戶邏輯 ...
        return new User(id, "Example User");
    }

    // 映射 POST /users
    @RequestMapping(method = RequestMethod.POST, consumes = MediaType.APPLICATION_JSON_VALUE)
    @ResponseBody
    public String createUser(@RequestBody User newUser) {
        // ... 創(chuàng)建用戶邏輯 ...
        return "User created";
    }

    // 映射 GET /users?admin=true (需要 admin 參數(shù))
    @RequestMapping(method = RequestMethod.GET, params = "admin=true")
    @ResponseBody
    public String getAdminUsers() {
        // ... 獲取管理員用戶列表 ...
        return "List of Admin Users";
    }

    // 映射 GET /users (只接受 JSON 請求)
    @RequestMapping(method = RequestMethod.GET, headers = "Accept=application/json")
    @ResponseBody
    public String getUsersAcceptingJson() {
        // ... 獲取用戶列表 ...
        return "List of Users (JSON requested)";
    }
}

import org.springframework.web.bind.annotation.*;
import org.springframework.http.MediaType;

@RestController // 使用 @RestController，無需在每個(gè)方法上加 @ResponseBody
@RequestMapping("/api/items") // 類級別映射
public class ItemController {

    // 映射 GET /api/items/{itemId}
    // produces 也可直接寫字符串
    @GetMapping(value = "/{itemId}", produces = MediaType.APPLICATION_JSON_VALUE)
    public Item getItem(@PathVariable String itemId) {
        // ... 獲取物品邏輯 ...
        return new Item(itemId, "Sample Item");
    }

    // 映射 POST /api/items
    // consumes 可以指定多個(gè)
    @PostMapping(consumes = {MediaType.APPLICATION_JSON_VALUE, MediaType.APPLICATION_XML_VALUE})
    public String createItem(@RequestBody Item newItem) {
        // ... 創(chuàng)建物品邏輯 ...
        return "Item created: " + newItem.getName();
    }

    // 映射 PUT /api/items/{itemId}
    @PutMapping("/{itemId}")
    public Item updateItem(@PathVariable String itemId, @RequestBody Item updatedItem) {
        // ... 更新物品邏輯 ...
        updatedItem.setId(itemId); // 假設(shè)更新成功
        return updatedItem;
    }

    // 映射 DELETE /api/items/{itemId}
    @DeleteMapping("/{itemId}")
    public String deleteItem(@PathVariable String itemId) {
        // ... 刪除物品邏輯 ...
        return "Item deleted: " + itemId;
    }

    // 映射 GET /api/items?type=gadget
    @GetMapping(params = "type=gadget")
    public String getGadgets() {
        return "List of Gadgets";
    }

    // 映射 GET /api/items (需要特定 Header)
    @GetMapping(headers = "X-API-Version=2")
    public String getItemsV2() {
        return "List of Items (API V2)";
    }
}

// 示例 Pojo
class Item {
    private String id;
    private String name;
    // constructors, getters, setters...
    public Item(String id, String name) { this.id = id; this.name = name; }
    public String getId() { return id; }
    public void setId(String id) { this.id = id; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
}

class User {
    private Long id;
    private String username;
    // constructors, getters, setters...
    public User(Long id, String username) { this.id = id; this.username = username; }
    public Long getId() { return id; }
    public String getUsername() { return username; }
}