[RELEASE] 백엔드 배포 v1.0.4

build.gradle

@@ -22,6 +22,10 @@ configurations {
     compileOnly {
         extendsFrom annotationProcessor
     }
+
+    configureEach {
+        exclude group: 'org.springframework.boot', module: 'spring-boot-starter-logging'
+    }
 }
 
 repositories {
@@ -32,11 +36,25 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
     implementation 'org.springframework.boot:spring-boot-starter-validation'
     implementation 'org.springframework.boot:spring-boot-starter-web'
+    implementation 'org.springframework.boot:spring-boot-starter-aop'
     compileOnly 'org.projectlombok:lombok'
     runtimeOnly 'com.h2database:h2'
     runtimeOnly 'com.mysql:mysql-connector-j'
     annotationProcessor 'org.projectlombok:lombok'
 
+    // JWT
+    implementation 'io.jsonwebtoken:jjwt-api:0.11.5'
+    implementation 'io.jsonwebtoken:jjwt-impl:0.11.5'
+    implementation 'io.jsonwebtoken:jjwt-gson:0.11.5'
+
+    // Excel Export
+    implementation 'org.apache.poi:poi-ooxml:5.2.3'
+    implementation 'org.apache.poi:poi:5.2.3'
+
+    // DB schema manager
+    implementation 'org.flywaydb:flyway-mysql'
+
+    // Test
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
 
@@ -47,14 +65,9 @@ dependencies {
     testImplementation 'com.epages:restdocs-api-spec-mockmvc:0.18.2'
     testImplementation 'com.epages:restdocs-api-spec-restassured:0.18.2'
 
-    // Excel Export
-    implementation 'org.apache.poi:poi-ooxml:5.2.3'
-    implementation 'org.apache.poi:poi:5.2.3'
-
-    // JWT
-    implementation 'io.jsonwebtoken:jjwt-api:0.11.5'
-    implementation 'io.jsonwebtoken:jjwt-impl:0.11.5'
-    implementation 'io.jsonwebtoken:jjwt-gson:0.11.5'
+    // Logging
+    implementation 'org.springframework.boot:spring-boot-starter-log4j2'
+    implementation "com.fasterxml.jackson.dataformat:jackson-dataformat-yaml"
 }
 
 bootJar {

src/main/java/com/debatetimer/DebateTimerApplication.java

@@ -9,5 +9,4 @@ public class DebateTimerApplication {
     public static void main(String[] args) {
         SpringApplication.run(DebateTimerApplication.class, args);
     }
-
 }

src/main/java/com/debatetimer/aop/logging/ClientLoggingAspect.java

@@ -0,0 +1,47 @@
+package com.debatetimer.aop.logging;
+
+import lombok.extern.slf4j.Slf4j;
+import org.aspectj.lang.ProceedingJoinPoint;
+import org.aspectj.lang.annotation.Around;
+import org.aspectj.lang.annotation.Aspect;
+import org.aspectj.lang.annotation.Pointcut;
+import org.springframework.stereotype.Component;
+
+@Slf4j
+@Aspect
+@Component
+public class ClientLoggingAspect extends LoggingAspect {
+
+    private static final String CLIENT_REQUEST_TIME_KEY = "clientRequestTime";
+
+    @Pointcut("@within(com.debatetimer.aop.logging.LoggingClient)")
+    public void loggingClients() {
+    }
+
+    @Around("loggingClients()")
+    public Object loggingControllerMethod(ProceedingJoinPoint proceedingJoinPoint) throws Throwable {
+        setMdc(CLIENT_REQUEST_TIME_KEY, System.currentTimeMillis());
+        logClientRequest(proceedingJoinPoint);
+
+        Object responseBody = proceedingJoinPoint.proceed();
+
+        logClientResponse(proceedingJoinPoint);
+        removeMdc(CLIENT_REQUEST_TIME_KEY);
+        return responseBody;
+    }
+
+    private void logClientRequest(ProceedingJoinPoint joinPoint) {
+        String clientName = joinPoint.getSignature().getDeclaringType().getSimpleName();
+        String methodName = joinPoint.getSignature().getName();
+        log.info("Client Request Logging - Client Name: {} | MethodName: {}", clientName, methodName);
+    }
+
+    private void logClientResponse(ProceedingJoinPoint joinPoint) {
+        String clientName = joinPoint.getSignature().getDeclaringType().getSimpleName();
+        String methodName = joinPoint.getSignature().getName();
+        long latency = getLatency(CLIENT_REQUEST_TIME_KEY);
+        log.info("Client Response Logging - Client Name: {} | MethodName: {} | Latency: {}ms",
+                clientName, methodName, latency);
+    }
+}
+

src/main/java/com/debatetimer/aop/logging/ControllerLoggingAspect.java

@@ -0,0 +1,75 @@
+package com.debatetimer.aop.logging;
+
+
+import jakarta.servlet.http.HttpServletRequest;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import lombok.extern.slf4j.Slf4j;
+import org.aspectj.lang.JoinPoint;
+import org.aspectj.lang.ProceedingJoinPoint;
+import org.aspectj.lang.annotation.Around;
+import org.aspectj.lang.annotation.Aspect;
+import org.aspectj.lang.annotation.Pointcut;
+import org.aspectj.lang.reflect.CodeSignature;
+import org.springframework.stereotype.Component;
+import org.springframework.web.context.request.RequestContextHolder;
+import org.springframework.web.context.request.ServletRequestAttributes;
+
+@Slf4j
+@Aspect
+@Component
+public class ControllerLoggingAspect extends LoggingAspect {
+
+    private static final String REQUEST_ID_KEY = "requestId";
+    private static final String START_TIME_KEY = "startTime";
+
+    @Pointcut("@within(org.springframework.web.bind.annotation.RestController)")
+    public void allController() {
+    }
+
+    @Around("allController()")
+    public Object loggingControllerMethod(ProceedingJoinPoint proceedingJoinPoint) throws Throwable {
+        setMdc(REQUEST_ID_KEY, UUID.randomUUID().toString());
+        setMdc(START_TIME_KEY, System.currentTimeMillis());
+        logControllerRequest(proceedingJoinPoint);
+
+        Object responseBody = proceedingJoinPoint.proceed();
+
+        logControllerResponse(responseBody);
+        removeMdc(START_TIME_KEY);
+        return responseBody;
+    }
+
+    private void logControllerRequest(ProceedingJoinPoint proceedingJoinPoint) {
+        HttpServletRequest request = getHttpServletRequest();
+        String requestParameters = getRequestParameters(proceedingJoinPoint);
+        String uri = request.getRequestURI();
+        String httpMethod = request.getMethod();
+        log.info("Request Logging: {} {} parameters - {}", httpMethod, uri, requestParameters);
+    }
+
+    private void logControllerResponse(Object responseBody) {
+        HttpServletRequest request = getHttpServletRequest();
+        String uri = request.getRequestURI();
+        String httpMethod = request.getMethod();
+        long latency = getLatency(START_TIME_KEY);
+        log.info("Response Logging: {} {} Body: {} latency - {}ms", httpMethod, uri, responseBody, latency);
+    }
+
+    private HttpServletRequest getHttpServletRequest() {
+        ServletRequestAttributes requestAttributes = (ServletRequestAttributes) RequestContextHolder.currentRequestAttributes();
+        return requestAttributes.getRequest();
+    }
+
+    private String getRequestParameters(JoinPoint joinPoint) {
+        CodeSignature codeSignature = (CodeSignature) joinPoint.getSignature();
+        String[] parameterNames = codeSignature.getParameterNames();
+        Object[] args = joinPoint.getArgs();
+        Map<String, Object> params = new HashMap<>();
+        for (int i = 0; i < parameterNames.length; i++) {
+            params.put(parameterNames[i], args[i]);
+        }
+        return params.toString();
+    }
+}

src/main/java/com/debatetimer/aop/logging/LoggingAspect.java

@@ -0,0 +1,21 @@
+package com.debatetimer.aop.logging;
+
+import lombok.extern.slf4j.Slf4j;
+import org.slf4j.MDC;
+
+@Slf4j
+public abstract class LoggingAspect {
+
+    protected final void setMdc(String key, Object value) {
+        MDC.put(key, String.valueOf(value));
+    }
+
+    protected final void removeMdc(String key) {
+        MDC.remove(key);
+    }
+
+    protected final long getLatency(String startTimeKey) {
+        long startTime = Long.parseLong(MDC.get(startTimeKey));
+        return System.currentTimeMillis() - startTime;
+    }
+}

src/main/java/com/debatetimer/aop/logging/LoggingClient.java

@@ -0,0 +1,11 @@
+package com.debatetimer.aop.logging;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface LoggingClient {
+}

src/main/java/com/debatetimer/client/OAuthClient.java

@@ -1,5 +1,6 @@
 package com.debatetimer.client;
 
+import com.debatetimer.aop.logging.LoggingClient;
 import com.debatetimer.dto.member.MemberCreateRequest;
 import com.debatetimer.dto.member.MemberInfo;
 import com.debatetimer.dto.member.OAuthToken;
@@ -9,6 +10,7 @@
 import org.springframework.web.client.RestClient;
 
 @Component
+@LoggingClient
 @EnableConfigurationProperties(OAuthProperties.class)
 public class OAuthClient {
 

src/main/java/com/debatetimer/client/OAuthProperties.java

@@ -1,6 +1,8 @@
 package com.debatetimer.client;
 
 import com.debatetimer.dto.member.MemberCreateRequest;
+import com.debatetimer.exception.custom.DTInitializationException;
+import com.debatetimer.exception.errorcode.InitializationErrorCode;
 import java.net.URLDecoder;
 import java.nio.charset.StandardCharsets;
 import lombok.Getter;
@@ -20,11 +22,21 @@ public OAuthProperties(
             String clientId,
             String clientSecret,
             String grantType) {
+        validate(clientId);
+        validate(clientSecret);
+        validate(grantType);
+
         this.clientId = clientId;
         this.clientSecret = clientSecret;
         this.grantType = grantType;
     }
 
+    private void validate(String element) {
+        if (element == null || element.isBlank()) {
+            throw new DTInitializationException(InitializationErrorCode.OAUTH_PROPERTIES_EMPTY);
+        }
+    }
+
     public MultiValueMap<String, String> createTokenRequestBody(MemberCreateRequest request) {
         String code = request.code();
         String decodedVerificationCode = URLDecoder.decode(code, StandardCharsets.UTF_8);

src/main/java/com/debatetimer/config/CorsConfig.java

@@ -1,5 +1,7 @@
 package com.debatetimer.config;
 
+import com.debatetimer.exception.custom.DTInitializationException;
+import com.debatetimer.exception.errorcode.InitializationErrorCode;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.http.HttpHeaders;
@@ -13,9 +15,21 @@ public class CorsConfig implements WebMvcConfigurer {
     private final String[] corsOrigin;
 
     public CorsConfig(@Value("${cors.origin}") String[] corsOrigin) {
+        validate(corsOrigin);
         this.corsOrigin = corsOrigin;
     }
 
+    private void validate(String[] corsOrigin) {
+        if (corsOrigin == null || corsOrigin.length == 0) {
+            throw new DTInitializationException(InitializationErrorCode.CORS_ORIGIN_EMPTY);
+        }
+        for (String origin : corsOrigin) {
+            if (origin == null || origin.isBlank()) {
+                throw new DTInitializationException(InitializationErrorCode.CORS_ORIGIN_STRING_BLANK);
+            }
+        }
+    }
+
     @Override
     public void addCorsMappings(CorsRegistry registry) {
         registry.addMapping("/**")
@@ -30,7 +44,7 @@ public void addCorsMappings(CorsRegistry registry) {
                 )
                 .allowCredentials(true)
                 .allowedHeaders("*")
-                .exposedHeaders(HttpHeaders.AUTHORIZATION);
+                .exposedHeaders(HttpHeaders.AUTHORIZATION, HttpHeaders.CONTENT_DISPOSITION);
     }
 }
 

src/main/java/com/debatetimer/config/JpaAuditingConfig.java

@@ -0,0 +1,10 @@
+package com.debatetimer.config;
+
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
+
+@Configuration
+@EnableJpaAuditing
+public class JpaAuditingConfig {
+
+}

src/main/java/com/debatetimer/config/WebConfig.java

@@ -1,11 +1,13 @@
 package com.debatetimer.config;
 
+import com.debatetimer.controller.tool.export.ExcelExportInterceptor;
 import com.debatetimer.controller.tool.jwt.AuthManager;
 import com.debatetimer.service.auth.AuthService;
 import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.web.method.support.HandlerMethodArgumentResolver;
+import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
 @Configuration
@@ -19,4 +21,9 @@ public class WebConfig implements WebMvcConfigurer {
     public void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers) {
         argumentResolvers.add(new AuthMemberArgumentResolver(authManager, authService));
     }
+
+    @Override
+    public void addInterceptors(InterceptorRegistry registry) {
+        registry.addInterceptor(new ExcelExportInterceptor());
+    }
 }