이게 왜 되지?

ExecutorService와 BlockingQueue

404NotFoundMe — Wed, 9 Jul 2025 11:19:17 +0900

ExecutorService와 BlockingQueue는 Java에서 동시성(Concurrency) 문제를 해결하고, 비동기 작업 처리를 효율적으로 하기 위해 자주 함께 사용되는 핵심 구성 요소입니다. 이 둘을 조합하면 멀티스레드 환경에서 작업을 안전하고 효율적으로 분산 처리할 수 있습니다.

✅ 1. ExecutorService란?

ExecutorService는 Java의 스레드 풀(Thread Pool) 기반 작업 실행기입니다. Thread를 직접 생성하고 관리하는 대신, ExecutorService가 스레드를 재사용하면서 효율적으로 작업을 실행합니다.

주요 특징

작업 제출(Submit): Runnable 또는 Callable을 넘기면 백그라운드에서 비동기로 실행
스레드 재사용: 매번 새 스레드를 만들지 않고 풀에서 재사용
스레드 수 제한: 동시 처리 개수 제한 가능 (예: 고정 5개)
종료 제어: .shutdown(), .awaitTermination() 등으로 graceful shutdown 가능

✅ 2. BlockingQueue란?

BlockingQueue는 스레드 간 안전한 큐입니다. 생산자-소비자 패턴에서 주로 사용되며, 큐가 비어 있으면 소비자는 대기하고, 가득 차면 생산자는 대기합니다.

주요 특징

동기화 자동 처리: 여러 스레드에서 동시에 접근해도 안전
take(): 큐에 항목이 없으면 블로킹됨 (기다림)
put(): 큐가 가득 차 있으면 블로킹됨
비동기 메시지 전달에 적합

✅ 3. 함께 사용하는 구조: 생산자-소비자 패턴

메시지를 생산자 스레드가 큐에 넣고, 소비자 스레드가 꺼내서 처리하는 구조

구조 설명

[WebSocket 수신 스레드] → BlockingQueue → [ExecutorService가 처리]

코드 예시

BlockingQueue<String> messageQueue = new LinkedBlockingQueue<>();
ExecutorService consumerPool = Executors.newFixedThreadPool(5);

// 소비자: 메시지 처리
for (int i = 0; i < 5; i++) {
    consumerPool.submit(() -> {
        while (true) {
            try {
                String msg = messageQueue.take(); // 메시지가 올 때까지 대기
                handleMessage(msg); // 메시지 처리 로직
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    });
}

// 생산자: 메시지 수신
public void onMessage(String msg) {
    try {
        messageQueue.put(msg); // 큐에 넣기 (가득 차 있으면 대기)
    } catch (InterruptedException e) {
        e.printStackTrace();
    }
}

장점 설명

✔ 스레드 재사용	성능 효율 향상, 오버헤드 감소
✔ 작업 분리	수신/처리를 역할별로 나눠 안정적
✔ 큐 기반 흐름 제어	메시지 폭주 시 자연스럽게 처리 속도 조절
✔ 예외 관리 용이	작업 단위로 try-catch 가능

✅ 5. 실서비스에서의 활용 예시

실시간 주식 시세 수신 후 처리
WebSocket 수신 메시지를 멀티스레드로 병렬 처리
RabbitMQ, Kafka 메시지 소비
백그라운드 작업 큐

웹소켓

404NotFoundMe — Fri, 20 Jun 2025 10:43:45 +0900

1. 웹소켓이란?

웹소켓(WebSocket)은 클라이언트와 서버가 지속적으로 연결을 유지하면서 양방향 통신(Full-Duplex)을 할 수 있도록 해주는 네트워크 프로토콜입니다.

기존 HTTP 통신과는 달리 "요청-응답"이 아니라 "지속 연결"을 기반으로 동작해요.

2. 기존 HTTP와의 차이

항목 HTTP WebSocket

연결 방식	요청-응답 후 끊김 (비연결 지향)	연결을 맺고 계속 유지 (연결 지향)
통신 방향	단방향 (클라이언트 → 서버)	양방향 (서버 ↔ 클라이언트)
사용 목적	문서 전송, API 통신	실시간 데이터 통신 (채팅, 주식 시세 등)
오버헤드	매 요청마다 헤더 포함	연결 이후엔 오버헤드 없음

3. 웹소켓의 동작 방식

HTTP 연결 요청
클라이언트가 일반적인 HTTP 요청을 보내되, Upgrade: websocket 헤더를 포함시킴 → 업그레이드 요청
프로토콜 업그레이드
서버가 WebSocket 요청을 수락하면, 프로토콜이 HTTP → WebSocket으로 전환됨
지속적인 통신
연결이 유지되며 서버와 클라이언트가 서로 실시간으로 메시지를 주고받을 수 있음
연결 종료
명시적으로 연결을 닫기 전까지는 계속 연결이 유지됨

4. 웹소켓의 장점

실시간 데이터 전송 (지연 최소화)
서버 → 클라이언트 푸시 가능
REST 방식 대비 네트워크 트래픽 감소 (헤더 반복 없음)
연결 유지로 성능 향상

5. 웹소켓의 단점

연결 상태 관리가 필요 (끊김 감지 등)
일반적인 HTTP 서버와 다르게 별도 설정 필요
브라우저/네트워크 환경에 따라 방화벽 등 제약 가능

6. 언제 사용하나?

실시간 채팅
실시간 주식/코인 시세
실시간 알림/푸시 시스템
온라인 게임, 협업 앱 등

요약

WebSocket은 실시간 양방향 통신을 위한 프로토콜
연결을 유지하면서 지속적인 데이터 주고받기 가능
실시간 서비스 구현에 적합 (채팅, 시세, 게임 등)

RestTemplate란?

404NotFoundMe — Fri, 30 May 2025 18:54:58 +0900

✅ RestTemplate란?

**RestTemplate은 자바(Spring)**에서
다른 서버의 API를 호출해서 데이터를 주고받을 수 있게 해주는 HTTP 클라이언트 도구입니다.

쉽게 말하면?

"RestTemplate은 자바에서 HTTP 요청을 보내는 전화기다."

전화번호 = 요청할 URL
️ 내가 말할 내용 = 요청 헤더/본문
전화를 건다 = API 호출 (GET/POST 등)
상대방의 대답 = 응답 데이터(JSON 등)

✅ RestTemplate이 필요한 이유

예: 다른 서버에서 주식 가격 조회 API를 제공할 때

자바 애플리케이션에서 한국투자증권 API에 요청하려면
RestTemplate을 써서 요청을 보내고 응답을 받아야 함

기본 사용 흐름

️ POST나 헤더가 필요한 경우

✅ 자주 쓰는 메서드

메서드설명

getForObject()	GET 요청, 결과만 바로 가져오기
getForEntity()	GET 요청, 결과 + 상태코드 같이 받기
postForObject()	POST 요청 보내기
exchange()	GET/POST/PUT/DELETE 전부 가능, 가장 유연함

정리

항목설명

정체	다른 서버에 HTTP 요청을 보내는 도구
용도	REST API 요청/응답 주고받기
대안	더 복잡한 경우엔 WebClient 사용
한줄요약	자바에서 API를 호출하고 응답을 받는 전화기 같은 도구

최종 프로젝트 오픈API 연동(5)

404NotFoundMe — Fri, 30 May 2025 18:30:49 +0900

✅ 한국투자증권 오픈API 연동 - 5단계: 응답 받은 JSON 데이터를 파싱하고 필요한 값 추출하기

1. 개요

오픈API를 호출한 결과로 JSON 형식의 응답을 받게 됩니다.
이 단계에서는 그 JSON 응답에서 **필요한 데이터(예: 일자별 시세, 거래량 등)**를 추출합니다.
Spring에서는 일반적으로 **Jackson의 ObjectMapper**를 사용해 JSON을 파싱합니다.

2. 응답 JSON 예시

한국투자증권의 일별 시세 조회 응답은 다음과 같은 구조입니다.

✅ 우리가 필요한 데이터는 output2 배열 안에 있습니다.

3. 사용 도구: Jackson의 ObjectMapper

JsonNode는 Jackson이 제공하는 JSON 탐색 객체입니다.
readTree()는 문자열(JSON)을 트리 구조로 파싱해줍니다.

4. 반복문으로 원하는 데이터 꺼내기

5. 실수하기 쉬운 부분

문제설명해결 방법

NullPointerException	필드가 없는 경우	.has("필드명") 체크
날짜 파싱 오류	"yyyyMMdd" → LocalDate	DateTimeFormatter 사용
숫자처럼 보여도 문자열	"83000" → 문자열로 처리됨	.asText() 후 변환 (Integer.parseInt() 등)

✅ 6. 정리

JSON 응답은 대부분 문자열이므로 .asText()로 꺼낸 후 변환해야 합니다.
필요한 필드만 골라서 꺼낼 수 있으며, DTO나 Entity에 담아 사용할 수 있습니다.
이 데이터를 DB에 저장하거나, API 응답으로 보내거나, 시각화 등에 활용할 수 있습니다.

최종 프로젝트 오픈API 연동(4)

404NotFoundMe — Fri, 30 May 2025 18:29:26 +0900

✅ 한국투자증권 오픈API 연동 - 4단계: URL + 헤더를 사용하여 실제로 요청 보내기

1. 개요

앞에서 준비한 URL과 헤더를 이용해서
이제 실제로 오픈API 서버에 요청을 보냅니다.
Spring에서는 RestTemplate이라는 클래스를 이용해 쉽게 HTTP 요청을 보낼 수 있습니다.

⚙️ 2. 사용할 도구: RestTemplate

Spring 프레임워크에서 HTTP 요청을 보내기 위한 기본 도구입니다.

3. 요청 구성 요소 요약

구성 요소설명

URL	2단계에서 만든 API 요청 주소
Headers	3단계에서 만든 인증 헤더
Method	HttpMethod.GET
Body	(GET 요청이므로 없음)
응답타입	일반적으로 String.class 사용

✍️ 4. 요청 코드 예시

흐름 시각화

⚠️ 5. 오류가 나는 경우 (예시)

상태코드의미원인 예시

401 Unauthorized	인증 실패	토큰 누락, 만료
403 Forbidden	권한 없음	appkey/appsecret 틀림
500 Internal Server Error	서버 내부 오류	잘못된 파라미터, tr_id 오류

✅ 6. 정리

RestTemplate.exchange()는 Spring에서 가장 직관적인 HTTP 호출 방식입니다.
요청 시에는 반드시 올바른 헤더와 URL을 함께 전달해야 합니다.
응답은 일반적으로 JSON 문자열이므로, 다음 단계에서 JSON을 파싱해서 필요한 데이터를 추출하게 됩니다.

최종 프로젝트 오픈API 연동(3)

404NotFoundMe — Fri, 30 May 2025 18:27:21 +0900

✅ 한국투자증권 오픈API 연동 - 3단계: 요청에 필요한 인증 헤더 구성

1. 개요

오픈API 서버는 요청을 보낸 사람이 유효한 사용자이며 권한이 있는지 확인하기 위해
HTTP 헤더에 인증 정보를 요구합니다.
이 단계에서는 필요한 헤더들을 정리하고 자바 코드로 구성합니다.

2. 필수 헤더 목록

헤더 이름설명예시 값

authorization	인증 토큰 (Bearer 토큰 형식)	Bearer eyJhbGciOiJIUzI1NiIs...
appkey	한국투자증권에서 발급한 App Key	6a0c1f13-xxxx-xxxx-xxxx-abcdef
appsecret	App Secret Key	1f04c311-xxxx-xxxx-xxxx-abcd...
tr_id	사용하는 API 고유 식별자 (API 문서에 명시됨)	FHKST03010100 (일별 시세 조회용)
Content-Type	요청 본문의 형식 (일반적으로 JSON 사용)	application/json

tr_id는 사용하는 API마다 다르며, 반드시 해당 API에 맞는 값을 사용해야 합니다.

3. 헤더를 구성하는 자바 코드 예시

accessToken은 별도 인증 API를 통해 발급받은 값입니다.
"Bearer " 문자열을 앞에 붙여야 합니다 (Bearer + 공백 + 토큰값).
HttpHeaders는 Spring의 요청 헤더 전용 클래스입니다.

4. 헤더 구성 흐름

1. accessToken 발급 (별도 API)

2. 설정 파일에서 appkey, appsecret 읽기

3. tr_id는 API 문서에서 확인

4. 위 정보들을 HttpHeaders에 담기

✅ 5. 정리

한국투자증권 오픈API는 단순한 토큰 외에도 앱 키와 시크릿 키가 함께 필요합니다.
요청하려는 API마다 고유한 tr_id를 지정해야 하므로 문서를 반드시 확인해야 합니다.
헤더를 올바르게 설정하지 않으면 401 Unauthorized, 403 Forbidden 오류가 발생합니다.

최종 프로젝트 오픈API 연동(2)

404NotFoundMe — Fri, 30 May 2025 18:26:09 +0900

✅ 한국투자증권 오픈API 연동 - 2단계: 요청 URL과 파라미터 구성

1. 개요

오픈API에 요청을 보낼 때는 정확한 요청 URL과 쿼리 파라미터를 구성해야 합니다.
한국투자증권의 REST API는 대부분 GET 방식이며, 쿼리스트링을 통해 종목코드, 날짜, 주기 등 다양한 값을 전달해야 합니다.

2. 사용할 API: 국내주식 일별 시세 조회

API 설명: 지정한 종목의 일정 기간 동안의 주가(시가/종가/고가/저가/거래량)를 조회합니다.
HTTP Method: GET
요청 URL: https://openapi.koreainvestment.com:9443/uapi/domestic-stock/v1/quotations/inquire-daily-itemchartprice

3. 주요 쿼리 파라미터

파라미터명설명예시값

FID_COND_MRKT_DIV_CODE	시장 구분 코드 (J: 주식)	J
FID_INPUT_ISCD	종목코드	005930 (삼성전자)
FID_INPUT_DATE_1	조회 시작일 (yyyyMMdd)	20240501
FID_INPUT_DATE_2	조회 종료일 (yyyyMMdd)	20240530
FID_PERIOD_DIV_CODE	조회 주기 (D: 일별, W: 주간)	D
FID_ORG_ADJ_PRC	수정주가 여부 (0: 미적용)	0

4. 자바 코드로 URL과 파라미터 구성하기

UriComponentsBuilder를 사용하면 쿼리 파라미터를 안전하게 붙일 수 있습니다.
위 코드는 다음과 같은 URL을 생성합니다:

✅ 5. 정리

쿼리 파라미터는 API 문서에서 요구하는 필수값을 빠짐없이 넣어야 합니다.
UriComponentsBuilder를 사용하면 URL 조합 실수를 줄이고 가독성을 높일 수 있습니다.
이 URL은 다음 단계에서 헤더와 함께 실제 요청에 사용됩니다.

최종 프로젝트 오픈API 연동(1)

404NotFoundMe — Fri, 30 May 2025 18:21:24 +0900

✅ 한국투자증권 오픈API 연동 - 1단계: 준비물

1. 개요

한국투자증권에서 제공하는 OpenAPI를 사용하려면 **인증 키(appkey/appsecret)**와 **기본 서버 주소(base-url)**가 필요합니다.
이 정보들은 보안상 코드에 직접 작성하지 않고, Spring의 설정파일(application.yml)을 통해 관리합니다.

️ 2. 필요한 정보

설정 항목설명예시

appkey	한국투자증권 API에서 발급받은 App Key	6a0c1f13-xxxx-xxxx-xxxx-abcdef
appsecret	위 App Key와 쌍을 이루는 Secret	1f04c311-xxxx-xxxx-xxxx-abcd...
base-url	요청을 보낼 OpenAPI 서버 주소	https://openapi.koreainvestment.com:9443

3. application.yml 설정 예시

Tip:

이 정보들은 깃허브에 올리지 않도록 주의하세요!
운영 환경과 개발 환경에서 분리 관리하는 것이 좋습니다.

4. 자바 코드에서 설정값 불러오기

이처럼 @Value 애너테이션을 사용하면 application.yml에 있는 값을 자동으로 읽어와서 필드에 주입해줍니다.

✅ 5. 정리

민감한 API 설정 값은 .yml에 정의하고 @Value로 주입받는 방식이 가장 안전하고 유지보수가 좋습니다.
이 설정은 이후 RestTemplate 등으로 오픈API 호출할 때 반복적으로 사용됩니다.

아웃소싱 프로젝트 내가 맡았던 부분 기능 간략 설명(User CURD, JWT토큰,시큐리티 필터)

404NotFoundMe — Mon, 28 Apr 2025 21:48:19 +0900

1. 프로젝트 개요 (중요도 및 어려움 표시 ★)

회원 가입, 로그인, 회원 정보 조회/수정/삭제 기능을 제공.
JWT 토큰을 활용해 인증 및 인가를 처리하고, Spring Security 필터를 커스텀하여 보안을 강화.
상태 기반 세션이 아닌 Stateless(무상태) 방식으로 구현.
메서드 단에서는 @PreAuthorize를 사용하여 사용자의 권한(Role)을 세밀하게 제어.

2. JWT 인증/인가 흐름

2-1. 로그인/회원가입

/auth/signup : 회원가입 API (비밀번호 암호화 후 저장)
/auth/login : 로그인 시 이메일+비밀번호 검증 후 Access Token 발급.

2-2. 발급된 JWT 토큰 구조

Payload : userId, userName, email, role 저장
Header : Authorization: Bearer <AccessToken>

3. 시큐리티 필터 기능 ★★★★★

3-1. JwtAuthenticationFilter (인증 필터)

모든 요청에 대해 Authorization 헤더에서 토큰을 추출.
토큰 검증 → 유저 정보 조회 → SecurityContextHolder에 인증 객체 저장.
인증 실패 시 다음 필터로 넘김.

String token = request.getHeader("Authorization");

if (token == null || !jwtUtil.validateToken(token)) {

filterChain.doFilter(request, response); return;

}

3-2. JwtAuthenticationEntryPoint (인증 실패 핸들러)

로그인하지 않은 사용자가 인증이 필요한 요청을 할 경우 401 에러 발생.
커스텀 메시지로 "로그인이 필요합니다." 반환.

3-3. JwtAccessDeniedHandler (권한 거부 핸들러)

인증은 되었지만 권한이 부족한 경우 403 에러 발생.
커스텀 메시지로 "권한이 없습니다. 관리자에게 문의하세요." 반환.

3-4. @AuthenticationPrincipal ★★★★★

Spring Security가 인증한 사용자 정보를 컨트롤러 메서드 매개변수에 바로 주입해주는 어노테이션입니다.
SecurityContextHolder에 저장된 인증 객체(Authentication)의 Principal을 자동으로 꺼내서 넣어줍니다.

쉽게 말하면 "로그인한 사용자의 정보를 별도 조회 없이 바로 받아서 사용할 수 있도록 해주는 어노테이션"

3-4. @PreAuthorize("hasRole('사장님')") ★★★★★

메서드 실행 전에 특정 권한(Role) 이 있는지 검사하는 어노테이션입니다.
보통 컨트롤러 또는 서비스 메서드 위에 붙입니다.
권한이 없으면 아예 메서드 실행을 막고 403 Forbidden 에러를 발생시킵니다.
AOP(관점 지향 프로그래밍) 방식으로 동작합니다.

쉽게 말하면 "이 메서드는 '사장님' 권한을 가진 사람만 사용할 수 있다."는 뜻

4. CustomUserDetails (유저 인증 객체)

UserDetails를 구현해서 User 엔티티를 그대로 들고 있음.
인증된 사용자의 ID, Email, Role, Password 등을 관리.

5. SecurityConfig 설정 ★★★★★

csrf 비활성화(이 부분에 대해서 조금 많이 알게되었음)
- CSRF(Cross-Site Request Forgery)란?
  "로그인된 사용자의 세션/쿠키 정보를 이용해서,
  그 사용자가 원하지 않는 요청을 다른 웹사이트가 대신 보내는 공격"
- 보통 csrf와 세션을 같이 사용한다고 함
session 비활성화 (STATELESS)
/auth/** 경로는 인증 없이 접근 가능
그 외 모든 경로는 JWT 인증 필요
jwtAuthenticationFilter를 UsernamePasswordAuthenticationFilter 앞에 등록

6. 유저 CRUD 기능

6-1. 유저 조회

GET /user/{userId} : 특정 유저 조회
GET /user/checkLogin : 로그인한 본인 정보 조회

6-2. 유저 수정 ★★★

쿠키(delete_auth) 인증 후 수정 가능 (비밀번호로 인증된 3분 쿠키)
이름, 이메일, 전화번호, 주소, 비밀번호 변경 가능.

6-3. 유저 삭제 (소프트 삭제)

실제 데이터베이스 삭제가 아닌, deletedAt 필드에 삭제 시간 기록 및 상태변경.

7. 보안 강화 요소

비밀번호는 BCrypt로 암호화 저장.
삭제/수정 요청 전 비밀번호 재확인 쿠키 인증.
JWT 토큰 검증 및 예외 처리 세분화.
유저 탈퇴/잠금/삭제 상태 체크 후 API 접근 차단.

Spring 심화 3주차 정리(1) (Bean 생명주기, API 예외처리)

404NotFoundMe — Fri, 18 Apr 2025 10:41:16 +0900

Bean 생명주기

생명주기와 콜백이란?

스프링은 객체(빈)를 생성하고 관리합니다 이 과정에서 초기화하거나 소멸할 때 자동으로 호출되는 메서드들을 지정할 수 있습니다 이게 바로 콜백(callback) 개념

✅ InitializingBean, DisposableBean 인터페이스

InitializingBean
- 빈이 생성되고 의존성 주입까지 끝나면 호출됨
- 초기 설정 코드 넣을 수 있음
DisposableBean
- 스프링 컨테이너가 종료되기 전에 호출됨
- 정리 작업(예: 연결 닫기 등)에 사용

@Component

public class MyBean implements InitializingBean, DisposableBean {

@Override

public void afterPropertiesSet() throws Exception {

System.out.println("빈 초기화: afterPropertiesSet()");

}

@Override

public void destroy() throws Exception {

System.out.println("빈 소멸: destroy()");

}

✅ @Bean 속성으로 초기화/소멸 메서드 지정

@Bean(initMethod = "init", destroyMethod = "cleanup")

public MyService myService() {

return new MyService();

}

init()은 빈이 생성된 후 실행
cleanup()은 컨테이너 종료 시 실행

✅ @PostConstruct, @PreDestroy 애너테이션

더 간단하고 표준적인 방식!
클래스 안에 메서드를 정의해두면, 스프링이 알아서 호출해줍니다.

@Component

public class MyBean {

@PostConstruct

public void init() {

System.out.println("초기화: @PostConstruct");

}

@PreDestroy

public void destroy() {

System.out.println("소멸: @PreDestroy");

}

✅ Bean Scope (빈의 범위)

스프링 빈이 언제 생성되고 얼마나 오래 살아있는지 설정하는 것
가장 자주 쓰는 것만 정리하면:

스코프 설명

singleton	스프링 컨테이너에 딱 하나만 존재 (기본값)
prototype	요청할 때마다 새 객체 생성
request	HTTP 요청마다 새 빈 생성 (웹 전용)
session	HTTP 세션마다 하나의 빈 사용 (웹 전용)

@Component

@Scope("prototype")

public class MyBean {

public MyBean() {

System.out.println("MyBean 인스턴스 생성!");

}

API 예외처리

✅ @ExceptionHandler

컨트롤러에서 예외가 발생했을 때 처리할 메서드 지정
예외 유형별로 다양한 처리가 가능

@RestController

public class MyController {

@GetMapping("/test")

public String test() {

throw new IllegalArgumentException("잘못된 입력!");

}

@ExceptionHandler(IllegalArgumentException.class)

public ResponseEntity<String> handleIllegalArgument(Exception e) {

return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(e.getMessage());

}

✅ @ControllerAdvice

예외 처리를 공통으로 모아서 작성 가능
여러 컨트롤러에서 예외가 발생했을 때 한 곳에서 처리 가능!

@ControllerAdvice

public class GlobalExceptionHandler {

@ExceptionHandler(Exception.class)

public ResponseEntity<String> handleException(Exception e) {

return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("오류 발생: " + e.getMessage());

}

⚠️ @RestControllerAdvice란?

✅ 정의

@ControllerAdvice + @ResponseBody의 조합힙니다
주로 REST API에서 전역 예외 처리를 할 때 사용합니다.
반환값이 JSON 형태로 자동 변환되기 때문에, 프론트엔드와의 통신 시에 유용합니다

✅ 차이점: @ControllerAdvice vs @RestControllerAdvice

항목 @ControllerAdvice @RestControllerAdvice

반환 타입	뷰(View) or JSON (선택)	항상 JSON (자동으로 @ResponseBody 적용)
사용 환경	웹 페이지 기반 MVC 앱	REST API 기반 앱

✅ 예제: 전역 예외 처리기

@RestControllerAdvice

public class GlobalExceptionHandler {

@ExceptionHandler(IllegalArgumentException.class)

public ResponseEntity<Map<String, String>> handleIllegalArgument(IllegalArgumentException ex) {

Map<String, String> error = new HashMap<>();

error.put("error", "잘못된 요청입니다.");

error.put("message", ex.getMessage());

return ResponseEntity.badRequest().body(error);

}

@ExceptionHandler(Exception.class)

public ResponseEntity<Map<String, String>> handleAll(Exception ex) {

Map<String, String> error = new HashMap<>();

error.put("error", "서버 오류 발생");

error.put("message", ex.getMessage());

return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);

}

예외가 발생하면 JSON 형태로 에러 메시지를 반환해줍니다.
Map으로 커스터마이징된 에러 메시지를 구성할 수 있습니다

✅ 실전 팁

프론트엔드와 협업할 때, 에러 메시지를 통일된 형식으로 전달하기 위해 @RestControllerAdvice 사용을 추천합니다.
실제 서비스에서는 예외 응답 형식을 별도의 클래스(ErrorResponse)로 만들어서 사용하기도 합니다.