보초 개발자

Codex 와 Claude CLI 명령어 비교

안녕 하리 — Sun, 21 Dec 2025 23:12:35 +0900

터미널에서 AI 코딩 에이전트를 쓸 때,
프롬프트를 길게 쓰는 것보다 필요한 순간에 /review 한 번, 길어지면 /compact 한 번, 위험해 보이면 권한 제어 한 번이 더 큰 차이를 만든다.

아래는 현업에서 가장 자주 쓰이는 커맨드 중심으로 Codex와 Claude Code를 “기능 단위”로 비교한 글이다.

목적(실무에서 자주)	Codex (OpenAI)	Claude Code (Anthropic)	차이 포인트
세션/대화 초기화	/new	/clear	Codex는 “새 대화” 개념 Claude는 “기록 삭제” 개념
대화 압축(토큰 절약)	/compact	/compact [instructions]	Claude는 압축 시 “포커스 지시” 인자를 공식 지원
모델 변경	/model	/model
상태/토큰 확인	/status	/status	Codex는 “세션 설정+토큰” 요약 Claude는 “Settings(Status 탭)” 성격
코드 리뷰 요청	/review	/review
변경사항(diff) 확인	/diff		Codex는 git diff를 바로 보여줌 Claude는 보통 review로 처리
되돌리기	/undo	/rewind	둘 다 롤백 계열이지만 명령/범위 표현이 다름
“이 파일 봐” 컨텍스트 고정	/mention	(명령 대신 @파일 참조가 핵심)	Codex는 slash로 파일 attach Claude는 @ 파일 참조
실행 권한/안전 설정	/approvals	/permissions, /sandbox	Codex는 “승인 정책” 중심 Claude는 “권한/샌드박스” 메뉴가 분리
MCP 도구 관리/확인	/mcp	/mcp	Codex는 “연결된 MCP 목록 확인” 성격 Claude는 “연결+OAuth 관리”까지 포함
프로젝트 가이드 파일 생성	/init → AGENTS.md	/init → CLAUDE.md	“프로젝트 메모리 파일” 이름/철학이 다름
종료	/exit or /quit	/exit

Gatling을 활용한 부하 테스트

안녕 하리 — Wed, 19 Nov 2025 17:03:27 +0900

프로젝트 점검을 위한 성능 테스트를 준비하면서 여러 도구를 검토해봤다.

고민했던 도구들

도구	장점	단점	선택
JMeter	• GUI 지원 • 다양한 플러그인 확장	• XML 파일로 Git 관리 어려움 • 무겁고 리소스를 많이 소모함 • CI/CD 통합 복잡	❌
nGrinder	• 웹 UI 제공 • 리포트 기능 • 분산테스트 지원	• 별도 서버 구축 필요 • Controller + Agent 관리 부담 • 로컬 실행 불편	❌
Gatling	• 코드 기반 (Java/Kotlin) • Git으로 버전 관리 • 리포팅 및 분석 기능 • 로컬 실행 간편 • CI/CD 통합 쉬움 • 비동기 방식으로 고성능	• 초기 학습 곡선	✅

프로젝트 시작하기

Gatling 공식 GitHub에서 제공하는 샘플 프로젝트 클론

git clone https://github.com/gatling/gatling-gradle-plugin-demo-java.git
cd gatling-gradle-plugin-demo-java

### 프로젝트 구조 확인
gatling-gradle-plugin-demo-java/
├── build.gradle.kts              # Gradle 설정
├── src/
│   └── gatling/
│       ├── java/                 # 시뮬레이션 코드
│       │   └── example/
│       │       └── BasicSimulation.java
│       └── resources/            # 데이터 파일, 설정
│           └── gatling.conf
└── gradle/

초기 설정 파헤치기

package computerdatabase;

import static io.gatling.javaapi.core.CoreDsl.*;
import static io.gatling.javaapi.http.HttpDsl.*;
import io.gatling.javaapi.core.*;
import io.gatling.javaapi.http.*;

public class BasicSimulation extends Simulation {

  // 1️⃣ 가상 사용자 수를 시스템 프로퍼티로 받기
  // Reference: https://docs.gatling.io/guides/passing-parameters/
  private static final int vu = Integer.getInteger("vu", 1);

  // 2️⃣ HTTP 프로토콜 설정
  // Reference: https://docs.gatling.io/reference/script/protocols/http/protocol/
  private static final HttpProtocolBuilder httpProtocol = http
      .baseUrl("https://api-ecomm.gatling.io")
      .acceptHeader("application/json")
      .userAgentHeader(
          "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36");

  // 3️⃣ 시나리오 정의
  // Reference: https://docs.gatling.io/reference/script/core/scenario/
  private static final ScenarioBuilder scenario = scenario("Scenario")
      .exec(http("Session").get("/session"));

  // 4️⃣ 테스트 성공 기준 (Assertion)
  // Reference: https://docs.gatling.io/reference/script/core/assertions/
  private static final Assertion assertion = global().failedRequests().count().lt(1L);

  // 5️⃣ 부하 주입 프로파일 설정 및 실행
  // Reference: https://docs.gatling.io/reference/script/core/injection/
  {
    setUp(scenario.injectOpen(atOnceUsers(vu)))
        .assertions(assertion)
        .protocols(httpProtocol);
  }
}

1️⃣ 동적 사용자 수 설정

private static final int vu = Integer.getInteger("vu", 1);

vu: Virtual Users (가상 사용자 수)
커맨드라인에서 -Dvu=100 처럼 값을 전달하지 않으면 기본값 1 사용

2️⃣ HTTP 프로토콜 설정

private static final HttpProtocolBuilder httpProtocol = http
    .baseUrl("https://api-ecomm.gatling.io")      // 기본 URL
    .acceptHeader("application/json")              // JSON 응답 허용
    .userAgentHeader("Mozilla/5.0 ...");          // User-Agent 설정

이 설정은 모든 HTTP 요청에 공통으로 적용

3️⃣ 시나리오 정의

private static final ScenarioBuilder scenario = scenario("Scenario")
    .exec(http("Session").get("/session"));

scenario("Scenario"): 시나리오 이름
.exec(): 실행할 액션 정의
http("Session"): 요청 이름 (리포트에 표시)
.get("/session"): GET 요청

4️⃣ 성공 기준 정의 (Assertion)

private static final Assertion assertion = global().failedRequests().count().lt(1L);

전체 실패한 요청 수가 1개 미만이어야 테스트 성공

5️⃣ 부하 주입 및 실행

{
  setUp(scenario.injectOpen(atOnceUsers(vu)))
      .assertions(assertion)
      .protocols(httpProtocol);
}

atOnceUsers(vu): 모든 사용자를 동시에 시작

테스트 실행하기

기본 실행

./gradlew gatlingRun

사용자 수 조정해서 실행

./gradlew gatlingRun -Dvu=50

더 나아가기

1. 환경별 설정

public class ApiLoadTest extends Simulation {
  
  // 커맨드라인으로 모든 설정 제어
  private static final int VU = Integer.getInteger("vu", 10);
  private static final int DURATION = Integer.getInteger("duration", 60);
  private static final String ENV = System.getProperty("env", "dev");
  
  private static final HttpProtocolBuilder httpProtocol = http
      .baseUrl(getBaseUrl(ENV))
      .acceptHeader("application/json");
  
  private static String getBaseUrl(String env) {
    return switch(env) {
      case "prod" -> "https://api.prod.com";
      case "cbt" -> "https://api.cbt.com";
      default -> "https://api.dev.com";
    };
  }
}

실행:

./gradlew gatlingRun -Dvu=100 -Dduration=300 -Denv=prod

2. Injection Profile

//   가장 많이 쓰는 패턴
setUp(
  scenario.injectOpen(
    nothingFor(5),                    // 워밍업
    rampUsers(VU).during(60),         // 점진적 증가
    constantUsersPerSec(10).during(DURATION - 120)  // 일정 부하 유지
  )
).protocols(httpProtocol);

// 피크 트래픽 테스트
setUp(
  scenario.injectOpen(
    rampUsersPerSec(10).to(100).during(180),  // 3분간 증가
    constantUsersPerSec(100).during(600)      // 10분간 피크 유지
  )
).protocols(httpProtocol);

// 스트레스 테스트
setUp(
  scenario.injectOpen(
    incrementUsersPerSec(10)
      .times(5)
      .eachLevelLasting(60)
      .separatedByRampsLasting(30)
      .startingFrom(10)
  )
).protocols(httpProtocol);

3. 인증 토큰 재사용

private static final ScenarioBuilder scenario = scenario("Auth Flow")
  // 로그인해서 토큰 저장
  .exec(http("Login")
    .post("/api/login")
    .body(StringBody("{\"username\":\"#{username}\",\"password\":\"#{password}\"}"))
    .asJson()
    .check(jsonPath("$.token").saveAs("token")))  // 세션에 저장
  
  .pause(1, 3)
  
  // 저장한 토큰 재사용
  .exec(http("Get Data")
    .get("/api/data")
    .header("Authorization", "Bearer #{token}")
    .check(status().is(200)));

4.현실적인 사용자 행동

private static final ScenarioBuilder scenario = scenario("E-Commerce")
  .exec(http("Homepage").get("/"))
  .pause(2, 5)  // 사람처럼 랜덤 대기
  
  .exec(http("Search").get("/search?q=laptop"))
  .pause(3, 7)
  
  .feed(productFeeder)
  .exec(http("View Product").get("/products/#{productId}"))
  .pause(5, 10)  // 상품 등을 살펴보는 시간
  
  .exec(http("Add to Cart").post("/cart")
    .body(StringBody("{\"productId\": \"#{productId}\"}"))
    .asJson())
  .pause(1, 2);

5. Assertions

setUp(scenario.injectOpen(injection))
  .assertions(
    global().responseTime().max().lt(5000),           // 최대 응답시간 5초 미만
    global().responseTime().percentile(95).lt(3000),  // 95% 요청이 3초 미만
    global().successfulRequests().percent().gt(99)    // 성공률 99% 이상
  )
  .protocols(httpProtocol);

결과화면

마무리

Gatling을 쓰기로 한 이유는 간단하다.
JMeter의 XML 지옥에서 벗어나고 싶었고, nGrinder는 서버 구축하는 것부터 부담스러웠다. 반면 Gatling은 코드로 관리되니까 Git으로 버전 관리도 되고, 로컬에서 바로 돌려볼 수 있어서 좋았다. 팀원들이랑 코드 리뷰하면서 시나리오를 함께 개선할 수 있다는 점도 마음에 들었다.
특히 우리 프로젝트가 Java/Kotlin 기반이라 코드 스타일을 통일할 수 있고, 시나리오를 객체지향적으로 깔끔하게 짤 수 있다는 게 큰 장점이었다.
리포팅 기능도 생각보다 훌륭해서 별도로 모니터링 툴을 붙이지 않아도 충분히 분석할 수 있었다.
앞으로는 Gatling을 주로 사용할 것 같다. 이제까지 이런 좋은 도구를 몰랐다니 좀 허탈하긴 한데... 그래도 이제라도 알게 돼서 다행이다!

이미지와 데이터 동시 처리 시 발생하는 Multipart 문제 해결

안녕 하리 — Tue, 29 Apr 2025 11:20:50 +0900

문제

진행 중인 프로젝트에서
이미지 파일(MultipartFile) 과 일반 데이터(JSON) 를 동시에 전송받는 API를 개발해야 했다.

하지만 다음과 같은 오류가 발생했다...

Resolved [org.springframework.web.bind.MissingServletRequestPartException: Required request part 'file' is not present]

/* 또는 */

Content type 'application/json' not supported

원인

Spring Boot에서는 요청을 처리할 때, 요청의 Content-Type에 따라 동작 방식이 달라진다.

@RequestBody 는 요청 전체가 application/json 타입일 때만 사용된다.
즉, 파일과 JSON을 함께 받을 수 없다.
@RequestPart 는 요청이 multipart/form-data 타입일 때, 요청 파트별로 파일이나 JSON을 따로 처리할 수 있다.

해결

요청을 MediaType.MULTIPART_FORM_DATA_VALUE 로 설정하고, @RequestPart 를 사용

/* 예시 코드 */
@PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<String> upload(
    @RequestPart("file", required = false) MultipartFile file,
    @RequestPart("data") MyRequestDto data
) {
    // 파일(선택)과 JSON 데이터(필수)를 정상적으로 받음
    return ResponseEntity.ok("업로드 성공");
}

+ 추가 문제 발생

포스트맨으로 API 테스트를 할 경우, form-data 형식으로 Content-Type을 application/json 을 명시해준다면 정상적으로 동작합니다!!

하지만... Swagger에서는 "Content-Type 'application/octet-stream' is not supported"라고 예외가 발생합니다.

application/octet-stream은 MIME 타입 중 하나로, 알 수 없는 이진 파일을 의미합니다.
즉 전달하고자 하는 리소스의 유형이 명시되지 않아 인식할 수 없는 리소스인 경우에 해당 타입이 사용됩니다.

분명 swagger에서 분명히 multipart/form-data로 설정해서 보내고 있는데, 어째서 application/octet-stream 라는걸까..

확인 결과, 전체 Content-Type은 multipart/form-data이지만,
각 파트의 Content-Type은 null과 image/png였습니다.
이를 통해 파트 중 타입이 누락된 부분이 null로 들어가게 되면서 어떤 타입인지 알 수가 없어 타입이 octet-stream으로 처리되고 있었다는 것을 알 수 있었습니다.

따라서 이 문제를 해결하기 위해서는 application/octet-stream 타입을 처리할 수 있는 메시지 컨버터를 추가해야 합니다!

@Component
public class MultipartJackson2HttpMessageConverter extends AbstractJackson2HttpMessageConverter {
    public MultipartJackson2HttpMessageConverter(ObjectMapper objectMapper) {
        super(objectMapper, MediaType.APPLICATION_OCTET_STREAM);
    }

	// 해당 컨버터가 읽기 과정에서만 작동하도록 쓰기 과정은 false

    @Override
    public boolean canWrite(Class<?> clazz, MediaType mediaType) {
        return false;
    }

    @Override
    public boolean canWrite(Type type, Class<?> clazz, MediaType mediaType) {
        return false;
    }

    @Override
    protected boolean canWrite(MediaType mediaType) {
        return false;
    }
}

참고

https://seondays.tistory.com/79

코딩테스트에서 자주 등장하는 확장 함수

안녕 하리 — Fri, 25 Apr 2025 16:00:01 +0900

숫자 관련 함수

ROUND(x, d)	숫자를 d 자리까지 반올림 (default 0)	ROUND(3.1415, 2)	3.14
CEIL(x)	x보다 크거나 같은 최소 정수	CEIL(3.2)	4
FLOOR(x)	x보다 작거나 같은 최대 정수	FLOOR(3.9)	3
TRUNCATE(x, d)	소수점 d 자리까지만 표시	TRUNCATE(3.1415, 2)	3.14

문자열 관련 함수

SUBSTRING(str, start, len)	문자열 일부 추출	SUBSTRING('Hello', 1, 2)	'He'
LEFT(str, n)	왼쪽부터 n글자 추출	LEFT('Hello', 3)	'Hel'
RIGHT(str, n)	오른쪽부터 n글자 추출	RIGHT('Hello', 2)	'lo'
CONCAT(str1, str2, ...)	문자열 연결	CONCAT('A', 'B')	'AB'
REPLACE(str, from, to)	문자열 치환	REPLACE('banana', 'na', 'oo')	'baooo'
INSTR(str, substr)	부분 문자열 위치 반환	INSTR('hello', 'e')	2
SUBSTRING_INDEX(str, delim, count)	구분자 기준으로 자름	SUBSTRING_INDEX('서울 강남구 역삼동', ' ', 2)	'서울 강남구'

날짜 관련 함수

NOW()	현재 날짜와 시간 반환	NOW()	2025-04-25 14:32:00
CURDATE()	현재 날짜 반환	CURDATE()	2025-04-25
DATE_FORMAT(date, format)	날짜 포맷 지정	DATE_FORMAT(NOW(), '%Y-%m-%d')	2025-04-25
DATEDIFF(date1, date2)	날짜 차이 (일 단위)	DATEDIFF('2025-05-01', '2025-04-25')	6
YEAR(date) / MONTH(date) / DAY(date)	연도 / 월 / 일 추출	YEAR('2025-04-25')	2025

⚙️ 조건 & NULL 처리 함수

IF(expr, true_val, false_val)	조건문 처리	IF(score > 60, 'Pass', 'Fail')	'Pass'
IFNULL(expr, value)	NULL이면 대체 값 반환	IFNULL(NULL, 0)	0
COALESCE(val1, val2, ...)	가장 먼저 NULL이 아닌 값 반환	COALESCE(NULL, NULL, 'A')	'A'
CASE	복수 조건 처리	CASE WHEN x > 0 THEN '양수' ELSE '음수' END	'양수'

윈도우 함수 (Window Functions)

ROW_NUMBER()	파티션 내 순위 (중복 순위 없음)	ROW_NUMBER() OVER (PARTITION BY dept ORDER BY salary DESC)	1, 2, 3, ...
RANK()	동일 순위 허용, 다음 순위 건너뜀	RANK() OVER (ORDER BY score DESC)	1, 1, 3, ...
DENSE_RANK()	동일 순위 허용, 다음 순위 안 건너뜀	DENSE_RANK() OVER (ORDER BY score DESC)	1, 1, 2, ...
NTILE(n)	n등분한 그룹 번호 부여	NTILE(4) OVER (ORDER BY salary)	1~4 그룹
LAG(expr, n)	이전 n행의 값 참조	LAG(score, 1) OVER (ORDER BY date)	이전 점수
LEAD(expr, n)	다음 n행의 값 참조	LEAD(score, 1) OVER (ORDER BY date)	다음 점수

활용 팁

SUBSTRING_INDEX 는 주소 데이터에서 읍/면/동 단위로 자를 때 정말 자주 나와요!
DATE_FORMAT은 날짜를 출력 포맷으로 맞춰야 하는 문제에서 필수!
ROUND, TRUNCATE는 평균 계산, 점수 조정에서 자주 등장합니다.
문자열 전처리 문제에서는 LEFT / RIGHT / REPLACE는 거의 고정 단골이에요.

손쉽게 Swagger JSON 으로 Postman Collection 만들기

안녕 하리 — Thu, 24 Apr 2025 16:21:27 +0900

개요

Postman에서 제공하는 OpenAPI 문서를 활용하면, API 엔드포인트를 일일이 추가하지 않고도 자동으로 Postman Collection을 생성할 수 있음
Spring Boot 프로젝트에서 OpenAPI 문서를 기반으로 Postman Collection을 생성하는 방법을 작성
- 스웨거 설정이 되어있다고 가정
  
  Spring Boot 버전 사용해야 할 springdoc-openapi 버전
  
  Spring Boot 2.7.x springdoc-openapi-ui:1.7.0
  
  Spring Boot 3.x springdoc-openapi-starter-webmvc-ui:2.0.2

OpenAPI 문서 다운로드

Swagger UI 접속 > /api/v3/api-docs/approval 클릭
http://localhost:8080/v3/api-docs/approval 오른쪽 마우스 클릭 후, 다른 이름으로 저장

포스트맨 호출로도 JSON 파일을 다운받을 수 있습니다!

curl --location 'http://localhost:8080/api/v3/api-docs/approval'

Postman API를 사용하여 컬렉션 자동 생성

Postman API Key 발급하기
- https://web.postman.co/settings/me/api-keys 접속 후, Generate API Key 클릭

생성된 API Key 클립보드에 복사

Postman API를 사용하여 OpenAPI 문서를 가져와 컬렉션 생성
- cURL을 사용한 컬렉션 자동 생성

curl --location 'https://api.getpostman.com/import/openapi' \
--header 'X-Api-Key: ${발급받은 Postman API Key}' \
--header 'Content-Type: application/json' \
--form 'type="file"' \
--form 'input=@"${파일 경로 위치}"'

Postman Collection 장점

장점	설명
API 문서 자동화	OpenAPI 문서를 기반으로 Postman Collection을 생성하여 API 문서를 최신 상태로 유지 가능
테스트 자동화	Postman에서 컬렉션을 활용하면 API 테스트를 반복 수행할 수 있어 생산성 향상
손쉬운 협업	컬렉션을 팀과 공유하여 테스트 및 개발 진행 가능

참고

만약, 스프링 부트 3.x 버전이 아닌 2.7.x 버전을 사용하고 있다면 DTO의 @Schema(example = "...") 값이 Swagger UI 및 OpenAPI JSON에 반영되지 않고 기본 데이터 타입("<string>", "<integer>")으로만 표시되는 문제가 발생
이를 해결하기 위해서 application.yml 설정 추가

springdoc:
  api-docs:
    enabled: true
    resolve-schema-properties: true // 해당 부분 추가

Unable to load io.netty.resolver.dns.macos 오류 해결 (Mac DNS 문제)

안녕 하리 — Thu, 24 Apr 2025 15:52:08 +0900

문제

어플리케이션 실행 시, ERROR 로그 발생

Unable to load io.netty.resolver.dns.macos.MacOSDnsServerAddressStreamProvider, fallback to system defaults. This may result in incorrect DNS resolutions on MacOS. Check whether you have a dependency on 'io.netty:netty-resolver-dns-native-macos'. Use DEBUG level to see the full stack: java.lang.UnsatisfiedLinkError: failed to load the required native library

원인

Netty에서 macOS 전용 DNS 네이티브 라이브러리를 불러오지 못해서 발생하는 문제
- 특히 macOS 환경에서 DNS 리졸빙 이슈가 주로 발생함

해결

build.gradle 에 의존성 추가

// Netty의 macOS용 네이티브 DNS 리졸버로 macOS 시스템에 최적화된 DNS 해석 기능을 제공하여, Java 기반의 DNS 리졸버보다 더 빠르고 효율적으로 DNS 해석을 처리
implementation "io.netty:netty-resolver-dns-native-macos:4.1.107.Final:osx-aarch_64"

만약 개발서버와 운영서버는 크라우드 환경인데 혹시 영향이 있지않을까❓

이 의존성은 macOS 시스템에서만 동작하는 네이티브 라이브러리이므로
클라우드 환경이나 다른 운영체제(Linux, Windows)에서는 영향을 미치지 않고, 클라우드 환경에서는 Java의 기본 DNS 리졸버가 사용되므로 문제가 발생하지 않습니다.

Spring JPA Open-in-View 경고 해결

안녕 하리 — Thu, 24 Apr 2025 15:49:05 +0900

문제

어플리케이션 실행 시, WARN 로그 발생

spring.jpa.open-in-view is enabled by default. Therefore, database queries may be performed during view rendering. Explicitly configure spring.jpa.open-in-view to disable this warning

원인

spring.jpa.open-in-view=true(기본값) 설정 시, View 렌더링까지 영속성 컨텍스트(세션)가 열려 있음
View에서 Lazy-loading을 사용하면 View 자체가 DB 접근 주체가 됨
- 이는 MVC 패턴 위배하며 예측 불가능한 쿼리 실행과 N+1 문제 발생 가능

해결

application.yml 에 다음과 같이 설정

spring
  jpa:
    open-in-view: false  // DB 커넥션을 트랜잭션 끝나면 바로 반환!

항목	open-in-view: true	open-in-view: false
View에서 Lazy 사용	가능	불가
N+1 발생 위험	높음	낮음
구조적 안정성	낮음	높음
코드 테스트 용이성	낮음	높음
유지보수 효율	낮음	높음

Spring Data Redis: Repository store assignment 문제 해결

안녕 하리 — Thu, 24 Apr 2025 15:32:44 +0900

문제

어플리케이션 실행 시, 수많은 Spring Data Redis - Could not safely identify store assignment for repository candidate interface 로그 발생

원인

Spring Boot가 Repository 인터페이스를 찾았는데 해당 인터페이스가 Redis용인지 JPA용인지 판단을 못할 경우 경고 발생
- 특히 여러 DataStore(JPA + Redis 등)를 동시에 쓸 때 흔하게 발생함

해결

Redis Entity에 선언되어 있는지 확인
@RedisHash("bannerClick")
Repository 인터페이스가 명확하게 Redis 전용인지 확인
public interface BannerClickRedisRepository extends CrudRepository<BannerClickRedisEntity, String> {
설정 클래스에 @EnableRedisRepositories 어노테이션 추가
@EnableRedisRepositories(basePackages = "com.kakao.bs.restapi.display.repository")

basePackages를 명확하게 하기 위해 Repository package 구조를 명확히 분리하는 것이 가장 좋음

[Kotlin] 제네릭의 out과 in 쉽게 이해하기

안녕 하리 — Mon, 14 Apr 2025 09:28:21 +0900

공변과 반공변

자바 개발자라면 제네릭 타입의 와일드카드 ? extends T, ? super T를 다뤄본 적 있을 거예요.
코틀린에서는 이 개념을 out과 in 키워드로 표현합니다.
이번 글에서는 공변성(Covariance)과 반공변성(Contravariance)에 대해 쉽고 간결하게 설명하겠습니다.

공변성 (Covariance) - `out`

공변이란, 타입 파라미터의 상속 관계가 제네릭 클래스까지 이어지는 것을 의미합니다.
out T는 읽기 전용(Generic Producer)입니다.
T 타입의 값을 반환(return)할 수는 있지만, 넣을 수는 없습니다.

class Cage<T> {
	private val animals: MutableList<T> = mutableListOf()

	fun getFirst(): T {
		return animals.first()    
    }

	fun moveFrom(otherCage: Cage<out T>) {
		this.anumals.addAll(otherCage.animals)
	}
}


fun main() {
    val goldFishCage = Cage<GoldFish>()
    goldFishCage.put(GoldFish("금붕어"))
    
    val cage = Cage<Fish>()
    cage.moveFrom(goldFishCage)
    
    val fish: Fish = cage.getFirst() // 읽기 가능
}

반공변성 (Contravariance) - in

반공변이란, 타입 파라미터의 상속 관계가 제네릭 클래스까지 반대로 이어지는 것을 의미합니다.
in T는 쓰기 전용(Generic Consumer)입니다.
T 타입의 값을 넣을 수는 있지만, 꺼낼 수는 없습니다.

class Cage<T> {
	private val animals: MutableList<T> = mutableListOf()

	fun getFirst(): T {
		return animals.first()    
    }
    
    fun put(animal: T) {
    	this.animals.add(animal)
    }

	fun moveFrom(otherCage: Cage<out T>) {
		this.anumals.addAll(otherCage.animals)
	}

	fun moveTo(otherCage: Cage<in T>) {
		otherCage.anumals.addAll(this.animals)
	}
}


fun main() {
    val fishCage = Cage<Fish>()
    
	val goldFishCage = Cage<GoldFish>()
    goldFishCage.put(GoldFish("금붕어"))

    goldFishCage.moveTo(fishCage) // goldFishCage를 모두 fishCage로 옮겨라!
}

✅ 공변과 반공변, 이렇게 기억하세요!

구분	키워드	타입 변환 방향	역할	특징
공변성	out	자식 → 부모로 변환	Producer	읽기 전용 ✅
반공변성	in	부모 → 자식로 변환	Consumer	쓰기 전용 ✅

참고로 코틀린에서는 변성을 주는 위치를 클라스 자체에 붙일 수 있고, 함수 또는 변수에만 붙일 수도 있습니다.

GraphQL 살펴보기

안녕 하리 — Tue, 18 Mar 2025 10:47:39 +0900

개요

GraphQL이란 Facebook이 개발한 API 쿼리 언어(Query Language)

REST API와 달리, 클라이언트가 원하는 데이터만 선택해서 가져올 수 있음

REST API vs GraphQL 차이점비교 항목REST APIGraphQL

데이터 요청 방식	여러 개의 엔드포인트를 호출	단일 엔드포인트(/graphql)에서 모든 요청을 처리
Over-fetching	필요 없는 데이터까지 반환됨	원하는 데이터만 선택 가능
Under-fetching	추가 요청이 필요할 수 있음	한 번의 요청으로 필요한 모든 데이터 조회 가능
성능	여러 요청을 보내야 할 수도 있음	최적화된 요청 가능
문서화	별도 API 문서 필요	자체 문서화 (GraphiQL 등 지원)

GraphQL 의존성 추가

dependencies {
	...
    implementation 'org.springframework.boot:spring-boot-starter-graphql'
}

application.yml 파일 추가

spring:
  graphql:
    graphiql:
      enabled: true   # '/graphiql' 경로로 접근하면 웹 브라우저에서 GraphQL API 테스트 가능
    schema:
      printer:
        enabled: true  # 수행한 쿼리를 콘솔에 출력

GraphQL 스키마 정의

GraphQL은 스키마 기반으로 동작하므로, schema.graphqls 파일을 생성하여 API 구조를 정의
src/main/resources/graphql/schema.graphqls

GraphQL Resolver 구현 (Controller 역할)

GraphQL에서는 데이터 조회(Query), 데이터 변경(Mutation)을 담당하는 리졸버(Resolver)가 필요

역할설명어노테이션

데이터 조회	클라이언트의 Query 요청을 처리하여 데이터를 반환	@QueryMapping
데이터 생성/수정	Mutation 요청을 처리하여 데이터를 추가/수정	@MutationMapping

GraphQL 테스트

http://localhost:8080/graphiql 접속 후 query 테스트 진행
Postman을 활용해서 API 호출

Spring Boot 버전	사용해야 할 springdoc-openapi 버전
Spring Boot 2.7.x	springdoc-openapi-ui:1.7.0
Spring Boot 3.x	springdoc-openapi-starter-webmvc-ui:2.0.2