요청 매핑 — @RequestMapping은 URL을 어떻게 메서드에 연결할까

// 서블릿 방식
protected void service(HttpServletRequest request, HttpServletResponse response) {
    String path = request.getRequestURI();
    String method = request.getMethod();

    if ("/users".equals(path) && "GET".equals(method)) {
        listUsers(request, response);
    } else if (path.matches("/users/\\d+") && "GET".equals(method)) {
        getUser(request, response);
    }
    // ... 수십 개의 if-else
}

1. 애플리케이션 시작 시 RequestMappingHandlerMapping 초기화
2. 모든 빈에서 @Controller/@RestController 탐색
3. 각 클래스의 @RequestMapping 메서드 검색
4. URL 패턴, HTTP 메서드, 헤더 등 조건으로 RequestMappingInfo 생성
5. MappingRegistry에 등록 (URL → Handler 매핑 테이블)

1. 정확한 경로: /users/admin
2. 경로 변수: /users/{id}
3. 와일드카드: /users/*
4. 더블 와일드카드: /users/**

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

    @GetMapping                    // GET /api/users
    public List<User> list() { ... }

    @GetMapping("/{id}")           // GET /api/users/123
    public User get(@PathVariable Long id) { ... }

    @PostMapping                   // POST /api/users
    public User create(@RequestBody CreateUserRequest request) { ... }

    @PutMapping("/{id}")           // PUT /api/users/123
    public User update(@PathVariable Long id, @RequestBody UpdateUserRequest request) { ... }

    @PatchMapping("/{id}")         // PATCH /api/users/123
    public User partialUpdate(@PathVariable Long id, @RequestBody Map<String, Object> fields) { ... }

    @DeleteMapping("/{id}")        // DELETE /api/users/123
    public void delete(@PathVariable Long id) { ... }
}

// 기본 사용
@GetMapping("/users/{id}")
public User getUser(@PathVariable Long id) { ... }

// 변수명이 다를 때
@GetMapping("/users/{userId}")
public User getUser(@PathVariable("userId") Long id) { ... }

// 여러 경로 변수
@GetMapping("/users/{userId}/orders/{orderId}")
public Order getOrder(@PathVariable Long userId, @PathVariable Long orderId) { ... }

// 정규식 패턴
@GetMapping("/files/{filename:.+}")  // 확장자 포함 매칭
public Resource getFile(@PathVariable String filename) { ... }

// Optional PathVariable
@GetMapping({"/docs", "/docs/{section}"})
public String getDocs(@PathVariable(required = false) String section) { ... }

// 기본 사용
@GetMapping("/users")
public List<User> search(@RequestParam String name) { ... }
// GET /users?name=홍길동

// 기본값 설정
@GetMapping("/users")
public Page<User> list(
    @RequestParam(defaultValue = "0") int page,
    @RequestParam(defaultValue = "20") int size,
    @RequestParam(defaultValue = "id") String sort
) { ... }
// GET /users?page=0&size=20

// 필수가 아닌 경우
@GetMapping("/users")
public List<User> search(
    @RequestParam(required = false) String name,
    @RequestParam(required = false) String email
) { ... }

// Map으로 모든 파라미터 받기
@GetMapping("/search")
public List<User> search(@RequestParam Map<String, String> params) { ... }

// 리스트 파라미터
@GetMapping("/users")
public List<User> getByIds(@RequestParam List<Long> ids) { ... }
// GET /users?ids=1,2,3 또는 GET /users?ids=1&ids=2&ids=3

// Matrix Variable 활성화 필요
@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        UrlPathHelper urlPathHelper = new UrlPathHelper();
        urlPathHelper.setRemoveSemicolonContent(false); // 세미콜론 유지
        configurer.setUrlPathHelper(urlPathHelper);
    }
}

// GET /users/filter;age=25;city=Seoul
@GetMapping("/users/{filter}")
public List<User> filter(
    @MatrixVariable int age,
    @MatrixVariable String city
) { ... }

@RestController
@RequestMapping("/api/data")
public class DataController {

    // JSON 요청만 받고 JSON으로 응답
    @PostMapping(
        consumes = MediaType.APPLICATION_JSON_VALUE,
        produces = MediaType.APPLICATION_JSON_VALUE
    )
    public DataResponse processJson(@RequestBody DataRequest request) { ... }

    // XML 요청을 받아 XML로 응답
    @PostMapping(
        consumes = MediaType.APPLICATION_XML_VALUE,
        produces = MediaType.APPLICATION_XML_VALUE
    )
    public DataResponse processXml(@RequestBody DataRequest request) { ... }

    // 여러 미디어 타입 지원
    @GetMapping(produces = { MediaType.APPLICATION_JSON_VALUE,
                             MediaType.APPLICATION_XML_VALUE })
    public DataResponse getData() { ... }
}

// 특정 헤더가 있을 때만 매칭
@GetMapping(value = "/api/data", headers = "X-Api-Version=2")
public DataV2 getDataV2() { ... }

// 특정 파라미터가 있을 때만 매칭
@GetMapping(value = "/api/users", params = "type=admin")
public List<User> getAdmins() { ... }

// 파라미터가 없을 때만 매칭
@GetMapping(value = "/api/users", params = "!type")
public List<User> getAllUsers() { ... }

// 정확한 경로
@GetMapping("/users/admin")

// 경로 변수
@GetMapping("/users/{id}")

// 와일드카드 (한 단계)
@GetMapping("/users/*/profile")
// /users/abc/profile ✓
// /users/abc/def/profile ✗

// 더블 와일드카드 (여러 단계)
@GetMapping("/docs/**")
// /docs/a ✓
// /docs/a/b/c ✓

@RestController
@RequestMapping(
    value = "/api/v1/orders",
    produces = MediaType.APPLICATION_JSON_VALUE
)
public class OrderController {

    // GET /api/v1/orders
    @GetMapping
    public List<Order> list() { ... }

    // GET /api/v1/orders/123
    @GetMapping("/{id}")
    public Order get(@PathVariable Long id) { ... }

    // POST /api/v1/orders
    @PostMapping(consumes = MediaType.APPLICATION_JSON_VALUE)
    public Order create(@RequestBody OrderRequest request) { ... }
}