배운것들을 정리합니다.
三昧境

전체 글 93

[Spring Boot] 최종 회고

기존 Community REST API와 Booking Calendar API에서는 HTTP 요청을 받아 사용자를 인증하고, 데이터를 처리한 뒤 응답하는 구조를 주로 다루었습니다.이번에는 이러한 요청·응답 방식에서 벗어나 WebSocket을 통한 실시간 양방향 통신과 HTTPS 환경에서의 연결 과정을 직접 구현하고 검증하고자 했습니다.WebSocket은 HTTP와 달리 연결이 유지되기 때문에 사용자 인증, 메시지 전달, 연결 종료 등을 별도로 고려해야 합니다.또한 HTTPS/WSS 환경에서는 TCP 연결과 TLS Handshake, WebSocket Upgrade, STOMP 인증이 각각 어떤 역할을 하는지도 구분할 필요가 있었습니다.이를 확인하기 위해 JWT 인증 기반의 실시간 채팅과 SSE 알림을 구..

[Spring Boot] Chapter 4 : HTTPS·TLS·WSS 적용과 프로젝트 최종 검증

지난 챕터까지 JWT 기반 인증, WebSocket(STOMP)을 이용한 실시간 채팅, SSE 알림과 재연결 이후 이력 복구 기능을 구현했습니다.이번에는 기존 Spring Boot 서버 앞에 Nginx를 배치하고 HTTPS·WSS 통신을 적용했습니다.기존에 구현한 기능들이 암호화된 연결에서도 정상적으로 동작하는지 확인하고, Nginx의 Reverse Proxy 설정이 WebSocket과 SSE 통신에 어떤 영향을 주는지도 검증했습니다.또한 기존 기능의 회귀 테스트와 전체 검증 결과를 함께 정리했습니다. Nginx를 이용한 HTTPS·WSS 구성 기존에는 클라이언트가 Spring Boot 서버에 HTTP·WS 방식으로 직접 연결했습니다.이번에는 Nginx를 앞에 두고 외부 요청을 HTTPS·WSS로 처리하..

[Spring Boot] Chapter 3 : SSE 알림과 재연결·이력 복구

지난번에는 WebSocket과 STOMP를 활용한 실시간 채팅을 구현하고, JWT 만료와 로그아웃에 따른 연결 종료를 처리했습니다.하지만 실시간 통신을 구현하면서 한 가지 의문이 생겼습니다.사용자가 연결이 끊긴 동안 전달받지 못한 메시지는 어떻게 처리해야 하는가?WebSocket은 연결된 사용자에게 실시간으로 데이터를 전달할 수 있지만, 연결이 종료된 동안 발생한 메시지까지 자동으로 복구해 주지는 않습니다.이번 단계에서는 이러한 문제를 보완하기 위해 SSE(Server-Sent Events)를 활용한 실시간 알림과, 연결이 끊긴 동안의 데이터 복구 기능을 구현했습니다.주요 구현 목표는 다음과 같습니다.SSE를 활용한 채팅방 초대 알림방 생성 트랜잭션과 알림 저장의 정합성 유지SSE 연결의 JWT 만료 및..

[Spring Boot] Chapter 2 : WebSocket·STOMP 실시간 채팅과 연결 관리

지난번에는 REST API와 JWT를 기반으로 회원 인증, Refresh Token Rotation, 로그아웃, 채팅방 생성 및 접근 권한 검증을 구현했습니다.이번 Chapter 2에서는 준비한 인증 구조를 바탕으로 WebSocket과 STOMP를 이용한 실시간 채팅 기능을 구현했습니다.처음에는 두 사용자가 같은 채팅방에 연결해서 메시지를 주고받는 기능만 생각했습니다.하지만 구현을 진행하면서 단순히 메시지를 전달하는 것 외에도 고려해야 할 부분이 있다는 것을 알게 되었습니다.예를 들어 다음과 같은 상황입니다.WebSocket 연결만 성공했다면 인증된 사용자라고 볼 수 있을까?로그인한 사용자라면 모든 채팅방을 구독할 수 있을까?메시지가 DB에 저장되기 전에 상대방에게 전달되면 어떻게 될까?Access To..

[Spring Boot] Chapter 1 : REST API와 JWT 인증 기반 구현

일반적인 REST API는 클라이언트가 요청하고 서버가 응답하는 구조입니다. 반면 실시간 채팅에서는 서버와 클라이언트가 연결을 유지하면서 메시지를 주고받아야 합니다.하지만 바로 WebSocket을 구현하기보다는, 먼저 사용자 인증과 채팅방 접근 권한을 처리하는 기반을 준비하기로 했습니다.이번 단에서 구현한 기능은 다음과 같습니다.회원가입 및 로그인JWT Access Token / Refresh Token 발급Refresh Token Rotation(RTR)로그아웃 시 JWT 무효화Refresh Token 쿠키 및 CSRF 보호채팅방 생성 및 참여자별 목록 조회채팅방 참여자 전용 메시지 이력 조회MySQL 기반 통합 테스트WebSocket, STOMP, SSE, Redis는 아직 구현하지 않았습니다. 이번..

[Spring Boot] Prologue : WebSocket과 SSE, 그리고 네트워크 통신 이해하기

앞서 Community REST API와 Booking Calendar API라는 두 개의 프로젝트를 진행했습니다.Community REST API에서는 JWT 인증과 Refresh Token Rotation, JPA, Redis 등을 사용하며 회원 인증과 데이터 처리에 대해 공부했습니다. 또한 동시성 문제와 JPA N+1 문제를 해결하는 과정에서 단순히 기능을 구현하는 것뿐 아니라, 여러 요청이 동시에 들어오는 상황도 고려해야 한다는 것을 배웠습니다.그리고 AWS EC2에 Spring Boot 애플리케이션을 배포하고, Nginx를 이용해 HTTPS를 적용하는 경험도 했습니다.이후 진행한 Booking Calendar API에서는 Google OAuth2/OIDC 인증과 Google Calendar AP..

[Spring Boot] Booking Calendar API 최종 회고 : 예약부터 Google Calendar 연동과 장애 복구까지

Google OIDC 로그인부터 시작했던 Booking Calendar API 미니 프로젝트를 마무리했습니다.이번 프로젝트는 총 4개의 Chapter로 진행했으며, 회원 관리와 예약 기능을 시작으로 Google Calendar 연동, 그리고 동기화 실패 시 복구하는 기능까지 구현했습니다.개발을 마친 뒤에는 실제 Google 계정으로 로그인하여 예약을 생성하고, Google Calendar에 일정이 정상적으로 등록되는 과정도 확인했습니다.이번 글에서는 앞서 작성했던 기술적인 내용을 반복하기보다는, 프로젝트를 시작한 이유와 구현하면서 고민했던 부분, 그리고 이번 프로젝트를 통해 배운 점을 정리해 보려고 합니다. 프로젝트를 시작한 이유 이전에 진행했던 Community REST API 프로젝트에서는 JWT 인..

[Spring Boot] Google Calendar 동기화 복구 : 영속적 재시도와 멱등성 설계

지난 작업에서는 예약을 Google Calendar 일정으로 등록하고, 예약 취소 시 해당 일정을 삭제하는 기능을 구현했습니다. 또한 예약 트랜잭션과 외부 API 호출을 분리하고, 예약 상태와 캘린더 동기화 상태를 별도로 관리하도록 구성했습니다.하지만 동기화 실패 상태를 DB에 저장하는 것만으로는 실패한 작업이 자동으로 복구되지는 않았습니다.예를 들어 예약이 커밋된 직후 서버가 종료되면 Google Calendar API 호출 자체가 누락될 수 있습니다. 반대로 Google에서 일정 생성에 성공했더라도 응답을 받지 못했다면, 서버에서는 실제 일정이 생성되었는지 확인하기 어렵다는 문제가 있었습니다.따라서 이번에는 이러한 상황을 테스트로 재현하고, DB에 남아 있는 작업을 다시 찾아 처리할 수 있는 복구 구..

[Spring Boot] Google Calendar 연동과 동기화 상태 설계

지난 Chapter 2에서는 비관적 락과 DB 제약 조건을 활용해 중복 예약을 방지하는 기능을 구현했습니다.이번 Chapter 3에서는 Google Calendar API를 연동하여 예약 생성 및 취소 내역이 사용자의 캘린더에도 반영되도록 구현했습니다.이 과정에서 단순히 외부 API를 호출하는 것보다 중요하게 생각한 부분은 DB 트랜잭션과 외부 API의 처리 결과를 어떻게 관리할 것인가였습니다. MySQL의 예약 저장은 성공했더라도 Google Calendar의 일정 생성은 실패할 수 있기 때문입니다.따라서 이러한 상황을 고려해 OAuth 추가 권한 동의, 토큰 관리, 트랜잭션 분리, 동기화 상태 관리를 중심으로 설계했습니다. Google OAuth 권한 분리 기존 Chapter 1에서는 Google O..

@Transactional 전파와 예외 처리: 코드로 비교하기

@Transactional의 결과는 프록시를 거쳤는지, 어떤 트랜잭션을 사용하는지, 예외를 어디서 처리했는지에 따라 달라집니다.예제는 다음 조건을 기준으로 합니다.Spring의 기본 프록시 방식이며, 같은 스레드와 트랜잭션 매니저를 사용합니다.외부 호출 전에는 트랜잭션이 없고, outer()는 Spring Bean의 프록시를 통해 호출합니다.saveOrder()와 saveHistory()는 현재 트랜잭션에서 DB 작업을 수행합니다.의도적으로 던지는 예외 외에 DB 오류는 없으며, 롤백 규칙과 트랜잭션 매니저 설정은 기본값입니다.코드는 비교에 필요한 메서드만 표시했습니다. 클래스 선언, 의존성 주입, import는 생략했습니다. @Transactional은 Spring의 어노테이션입니다. REQUIRED와..

Java/Spring Boot 2026.11.03