🚀 [기능개선][리팩토링] Primitive/Wrapper 타입 및 Boolean 필드명 네이밍 컨벤션

[Chuseok22]

📝 현재 문제점

• 숫자 타입 필드를 Integer, Long 등 래퍼(wrapper)로 선언해 불필요한 오토박싱 및 null 체크 로직이 발생하고 있습니다.
• boolean 필드명에 is 접두어를 붙여 선언하면 JavaBeans Introspector와 Lombok 사용 시 getter 이름이 getIsXxx() 형태로 생성되어 혼란을 초래합니다.
• 일관되지 않은 네이밍 컨벤션으로 코드 가독성과 유지보수성이 저하되고 있습니다.

🛠️ 해결 방안 / 제안 기능

• 숫자 타입은 null 허용이 불필요한 경우 primitive(int, long 등)로 선언하고, null 표현이 필요한 경우에만 래퍼(Integer, Long)를 사용합니다.
• Boolean 타입은 primitive boolean을 기본으로 사용하고, true/false 외 null 상태가 필요할 때만 Boolean을 사용합니다.
• 필드명 네이밍은 JavaBeans 컨벤션에 맞춰 is 접두어 없이 camelCase로 작성합니다.(isFirstLogin → firstLogin)
• Lombok 사용 시에도 위 방침에 따라 필드 선언만 수정하면, isXxx() / getXxx() getter가 자동 생성되도록 적용합니다.

예시: HopeAreaRequest.java 리팩토링 전/후

리팩토링 전

@ToString
@NoArgsConstructor
@AllArgsConstructor
@Getter
@Setter
@Builder
public class HopeAreaRequest {

  @NotNull(message = "우선순위를 입력하세요. 1 ~ 10 정수")
  @Min(value = 1, message = "순위는 1부터 10 사이의 정수만 입력 가능합니다.")
  @Max(value = 10, message = "순위는 1부터 10 사이의 정수만 입력 가능합니다.")
  @Schema(defaultValue = "1")
  private Integer priority; // 순위

  @NotNull(message = "희망 구역을 입력하세요.")
  @Schema(defaultValue = "A구역")
  private String location; // 구역

  @NotNull(message = "희망 가격을 입력하세요.(원 단위)")
  @Min(value = 0, message = "희망 가격은 0원 이상이어야 합니다.")
  @Schema(defaultValue = "150000")
  private Long price; // 가격
}

리팩토링 후

@ToString
@NoArgsConstructor
@AllArgsConstructor
@Getter
@Setter
@Builder
public class HopeAreaRequest {

  // primitive int 사용, null 체크(@NotNull) 제거
  // 값 누락 시 기본값 0이 @Min(1) 검증에 걸리므로 충분
  @Min(value = 1, message = "순위는 1부터 10 사이의 정수만 입력 가능합니다.")
  @Max(value = 10, message = "순위는 1부터 10 사이의 정수만 입력 가능합니다.")
  @Schema(defaultValue = "1")
  private int priority; // 순위

  @NotBlank(message = "희망 구역을 입력하세요.")
  @Schema(defaultValue = "A구역")
  private String location; // 구역

  // primitive long 사용, null 체크 제거
  @Min(value = 0, message = "희망 가격은 0원 이상이어야 합니다.")
  @Schema(defaultValue = "150000")
  private long price; // 가격
}

🙋‍♂️ 담당자

• 백엔드: @Chuseok22
• 프론트엔드:
• 디자인:

[github-actions]

Chuseok22 Issue Helper

브랜치명

20250917_#366_Primitive_Wrapper_타입_및_Boolean_필드명_네이밍_컨벤션

커밋 메시지

Primitive_Wrapper_타입_및_Boolean_필드명_네이밍_컨벤션 : feat : {변경 사항에 대한 설명} https://github.com/Team-TicketMate/ticketmate-server/issues/366