메소드의 파라미터로 VO(Value Object)를 넘겨줄 때, 해당 VO의 **특정 필드(속성)**를 Swagger (Springfox 2.x 기준)에서 **필수 입력(Required)**으로 표시하는 방법

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

@ApiModel(value = "사용자 정보 VO", description = "사용자의 필수 및 선택 정보를 포함")
public class UserRequestVO {

    // 1. 필수 입력 필드 (Required = true)
    @ApiModelProperty(
        value = "사용자 ID",
        example = "user123",
        required = true // ⭐️ 이 속성이 필수 입력을 설정합니다.
    )
    private String userId;

    // 2. 선택 입력 필드 (기본값: required = false)
    @ApiModelProperty(
        value = "사용자 이름",
        example = "홍길동",
        notes = "미입력 시 '익명'으로 처리됨"
    )
    private String userName;

    // Getter and Setter...
}

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @PostMapping("/api/users")
    @ApiOperation(value = "새 사용자 등록", notes = "필수 항목(userId)을 포함하여 사용자를 등록한다.")
    public String registerUser(@RequestBody UserRequestVO vo) {
        // ... 로직 처리
        return "Success";
    }
}

import io.swagger.annotations.ApiModelProperty;

public class SearchRequestVO {

    // required = true를 설정해도 query parameter에서는 Swagger UI에서 기본적으로 required로 표시되지 않을 수 있습니다.
    @ApiModelProperty(
        value = "검색 키워드",
        required = true // Request Body와 동일하게 설정
    )
    private String keyword;

    @ApiModelProperty(value = "페이지 번호")
    private Integer page;

    // Getter and Setter...
}

import io.swagger.annotations.ApiParam;

@RestController
public class SearchController {

    @GetMapping("/api/search")
    public String search(
        // ⭐️ 필수 파라미터
        @ApiParam(value = "검색 키워드", required = true) 
        @RequestParam String keyword,
        
        // 선택 파라미터
        @ApiParam(value = "페이지 번호", required = false) 
        @RequestParam(required = false) Integer page) {
        
        // ... 로직 처리
        return "Search results";
    }
}