끝까지 가면 다 이겨

[Spring Boot] Spring AOP

1. AOP란?AOP(Aspect-Oriented Programming, 관점 지향 프로그래밍)는 비즈니스 로직과 공통 기능을 분리하여 중복 코드를 줄이고 유지보수성을 높이는 프로그래밍 패러다임이다 AOP의 핵심 개념관점(Aspect): 비즈니스 로직과 관계없이 여러 곳에서 공통적으로 적용되는 기능 (예: 로깅, 트랜잭션 관리 등)핵심 로직(Core Concern): 애플리케이션의 주요 비즈니스 로직공통 관심 사항(Cross-Cutting Concern): 여러 클래스에서 반복적으로 나타나는 부가 기능 AOP의 역할AOP는 비즈니스 로직의 특정 시점을 가로채어 전후 처리를 가능하게 해주는 기술비즈니스 로직과 공통 기능을 분리하여 코드 중복을 줄임애플리케이션의 가독성과 유지보수성을 향상 AOP의 주요 활용..

[Spring Boot] Filter와 Interceptor

Filter와 Interceptor는 비슷한 역할을 수행하지만 동작하는 위치와 실행 순서가 다르다Filter는 HTTP 요청의 전반적인 부분을 처리하는데 사용되고, Interceptor는 컨트롤러 실행 전후의 로직을 처리하는데 사용한다.1. Filter- Filter는 Servlet 기반의 웹 애플리케이션에서 HTTP 요청과 응답을 가로채고, 필터 체인을 통해 처리하는 기능을 제공[주요 특징]Servlet 컨테이너에서 동작하며, HTTP 요청과 응답의 전후로 실행요청의 가공, 인증, 권한 부여, 로깅 등의 작업을 수행javax.servlet.Filter 인터페이스를 구현하여 생성되며, doFilter() 메서드를 통해 요청과 응답을 가로채어 처리Spring Boot에서는 @Component 또는 @Con..

[Spring Boot] Redisson 분산 락

토이 프로젝트에 공간에 대한 예약 기능이 있는데 동시성 문제가 발생할 수 있기 때문에 Lock을 통해 해결해야 했다.나의 경우 사용하고 있던 Redis가 있어서 그대로 Redis를 사용했지만 RDBMS에도 있기 때문에  Lock을 위해 Redis가 추가로 필요할지는 고민해봐야 한다. RedissonRedisson은 Jedis, Lettuce 같은 자바 레디스 클라이언트다.Redisson은 Lock interface를 제공하여 Lettuce와 다르게 분산락을 직접 구현하지 않고 편리하게 사용할 수 있다.스핀락 방식이 아닌 pub/sub 방식의 Lock이다. Redisson 의존성 추가// redisson Lockimplementation 'org.redisson:redisson-spring-boot-sta..

[Spring Boot] OTP 2차 인증

진행 중인 프로젝트의 관리자에 2차 인증 기능이 필요하게 되어 OTP 생성 및 검증을 통해 2차 인증을 구현했다. 해당 프로젝트는 관리자와 사용자가 공통으로 적용된 필터에서 로그인을 처리하고 있기 때문에 OTP 인증 필터를 구현하여 공통 로그인 필터 앞에 추가했다. 공통 로그인 필터AbstractAuthenticationProcessingFilterauthenticationManager를 필요로 하는 필터로, request Endpoint가 requestMatcher와 같으면 요청을 가로채서 인증 수행을 시도한다.attemptAuthentication() 메소드에서 requestBody의 검증과 authenticationManager를 통해 인증을 수행한다.public class CustomUsernam..

[Spring Boot] MapStruct

Java 객체 간의 매핑을 도와주는 라이브러리인 MapStruct에 대해 알아보자. MapStructMapStruct는 Java Bean 유형 간의 매핑 구현을 단순화해주는 라이브러리로써 다음과 같은 장점을 가지고 있다.컴파일 시점에 코드를 생성하여 런타임 안정성 보장다른 매핑 라이브러리보다 빠르다어노테이션을 사용한 선언적 개발로 구현이 쉽다 MapStruct 의존성 추가implementation("org.mapstruct:mapstruct:1.5.3.Final")annotationProcessor("org.mapstruct:mapstruct-processor:1.5.3.Final") Mapper 인터페이스 구성componentModel = "spring"- Spring 컨테이너에 Bean 등록 unma..

[Spring Boot] @AuthenticationPrincipal 사용해서 사용자 정보 조회

Spring Security가 적용된 프로젝트에서 사용자가 API를 호출했을 때 사용자의 정보가 필요한 때가 있다. 한 가지 예로 데이터 수정 시 테이블 updateBy 필드에 들어갈 사용자 ID 같은 것들? 그래서 @AuthenticationPrincipal 어노테이션을 사용해서 사용자 정보 조회하는 것을 알아보게 되었다. 인증 객체 Spring Security를 적용하면 인증 객체(Authentication)을 SecurityContextHolder 내부의 SecurityContext에 저장하고 있다. 그렇기 때문에 컨트롤러에서 @AuthenticationPrincipal을 사용해 인증 객체의 정보를 조회할 수 있는 것이다. MemberInfo @Getter public class MemberInfo..

[Spring Boot] Redis 적용해서 토큰 정보 저장 후 자동 갱신하기

이전 [Docker] 도커를 사용해서 로컬에 mysql, redis 구성 게시글에서 도커에 Redis 컨테이너를 띄우는 것을 알아봤다. 그래서 이 Redis에 accessToken과 refreshToken을 저장하여 accessToken 만료, refreshToken 유효한 상태인 경우 Redis에서 refreshToken을 조회해서 자동 갱신해 주는 것을 해보려고 한다. Redis 의존성 추가 implementation 'org.springframework.boot:spring-boot-starter-data-redis' build.gradle 파일에 Redis 의존성을 추가한다. RedisConfig 작성 # application.yml redis: url: localhost port: 6379 ap..

[Spring Boot] 로그인 성공 시 쿠키에 accessToken 넣기

Spring Boot 프로젝트를 진행하며 JWT토큰으로 로그인 기능을 구현했다. 내 프로젝트 기준으로 액세스토큰의 만료시간은 1시간, 리프레시 토큰의 만료시간은 3시간으로 설정했는데, API를 개발하고 테스트할 때마다 헤더에 토큰을 넣어주고, 만료되었을 경우 갱신해줘야 한다. 이 과정을 쿠키 관련 유틸 클래스를 만들어 자동으로 설정해 보도록 하자. CookieUtil 구현 public class CookieUtil { private static final int COOKIE_EXPIRATION_TIME = 3 * 60 * 60; // JWT 필터에서 쿠키에 저장된 액세스토큰을 조회하는 메소드 public static String getAccessToken(HttpServletRequest request)..

[Spring Boot] @Valid 어노테이션 사용하기

개발 중 컨트롤러에서 @RequestBody 객체를 검증할 때 @Valid 어노테이션을 사용해서 요청 객체에 대한 유효성 검증을 할 수 있다. 요청 객체에 대한 유효성 검증을 어떻게 하는지 차근차근 알아보도록 하자. validation 의존성 추가 implementation 'org.springframework.boot:spring-boot-starter-validation' build.gradle에 먼저 spring-boot-starter-validation 의존성을 추가한다. @Valid 적용 (컨트롤러, 요청 DTO) @PostMapping("/join") public ResponseEntity joinMember(@Valid @RequestBody MemberJoinDto memberJoinDto..

[SpringBoot] @Secured, @PreAuthorize, @PostAuthorize

SpringBoot 프로젝트에 Security를 적용하고 권한 관리할 때 사용할 수 있는 어노테이션인 @Secured, @PreAuthorize, @PostAuthorize를 알아보자. Spring Security의 API 권한 관리 방식은 SecurityConfig에 설정하는 방법과 메소드 수준의 권한 관리 방법이 있다. SecurityConfig 권한 관리 @Configuration public class WebSecurityConfig { @Bean public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { return http .authorizeHttpRequests( authorize -> authori..

[Spring Boot] 공통 에러 처리

백엔드에서 개발 중 발생하는 에러들을 특정 코드로 정리하여 공통으로 에러 응답을 내려주는 것을 적용해보려고 한다. ErrorResponse @Data public class ErrorResponse { private boolean result; private String code; private String message; public ErrorResponse(String code, String message) { this.setResult(false); this.setCode(code); this.setMessage(message); } } 예외가 발생했을 때 응답할 DTO를 생성하고 code와 message를 받는 생성자를 추가했다. ErrorCode @Getter @AllArgsConstructor..

[Spring Boot] @RestControllerAdvice를 사용한 공통 응답 처리

@RestControllerAdvice 어노테이션을 사용해서 이전에 포스팅했던 [SpringBoot] 공통 응답 DTO를 더 편리하게 사용할 수 있게 업그레이드하려고 한다. @RestControllerAdvice AOP를 적용하여 Controller 동작 이후에 공통된 처리를 적용할 수 있다. 기존의 공통 응답 처리 방식은 Controller단에서 Service 반환 데이터를 SuccessResponse DTO data필드에 넣어주는 방식이었다. @PostMapping public ResponseEntity joinMember(@RequestBody MemberJoinDto memberJoinDto) { return ResponseEntity.ok( SuccessResponse.builder() .res..