[BE] refactor: 예외 메시지 포맷 수정

backend/src/main/java/org/donggle/backend/application/service/AuthService.java

@@ -6,7 +6,7 @@
 import org.donggle.backend.application.service.oauth.kakao.dto.KakaoProfileResponse;
 import org.donggle.backend.auth.JwtTokenProvider;
 import org.donggle.backend.auth.JwtTokenService;
-import org.donggle.backend.auth.exception.NoSuchTokenException;
+import org.donggle.backend.auth.exception.RefreshTokenNotFoundException;
 import org.donggle.backend.domain.member.Member;
 import org.donggle.backend.domain.member.MemberName;
 import org.donggle.backend.ui.response.TokenResponse;
@@ -19,7 +19,7 @@ public class AuthService {
     private final MemberRepository memberRepository;
     private final JwtTokenProvider jwtTokenProvider;
     private final JwtTokenService jwtTokenService;
-
+    
     public TokenResponse loginByKakao(final KakaoProfileResponse kakaoProfileResponse) {
         final Member loginMember = memberRepository.findByKakaoId(kakaoProfileResponse.id())
                 .orElseGet(() -> memberRepository.save(Member.createByKakao(
@@ -28,20 +28,20 @@ public TokenResponse loginByKakao(final KakaoProfileResponse kakaoProfileRespons
                 ));
         return createTokens(loginMember);
     }
-
+    
     public TokenResponse reissueAccessTokenAndRefreshToken(final Long memberId) {
         final Member member = memberRepository.findById(memberId).
-                orElseThrow(NoSuchTokenException::new);
-
+                orElseThrow(RefreshTokenNotFoundException::new);
+        
         return createTokens(member);
     }
-
+    
     private TokenResponse createTokens(final Member loginMember) {
         final String accessToken = jwtTokenProvider.createAccessToken(loginMember.getId());
         final String refreshToken = jwtTokenProvider.createRefreshToken(loginMember.getId());
-
+        
         jwtTokenService.synchronizeRefreshToken(loginMember, refreshToken);
-
+        
         return new TokenResponse(accessToken, refreshToken);
     }
 }

backend/src/main/java/org/donggle/backend/application/service/CategoryService.java

@@ -184,7 +184,7 @@ private void addCategoryOrder(final Long nextCategoryId, final Category category
 
     private void validateBasicCategory(final Category category) {
         if (category.isBasic()) {
-            throw new InvalidBasicCategoryException();
+            throw new InvalidBasicCategoryException(category.getId());
         }
     }
 

backend/src/main/java/org/donggle/backend/application/service/WritingService.java

@@ -63,7 +63,7 @@ public Long uploadMarkDownFile(final Long memberId, final MarkdownUploadRequest
         //TODO: member checking
         final String originalFilename = request.file().getOriginalFilename();
         if (!Objects.requireNonNull(originalFilename).endsWith(MD_FORMAT)) {
-            throw new InvalidFileFormatException();
+            throw new InvalidFileFormatException(originalFilename);
         }
         final String originalFileText = new String(request.file().getBytes(), StandardCharsets.UTF_8);
 

backend/src/main/java/org/donggle/backend/auth/JwtTokenProvider.java

@@ -7,7 +7,7 @@
 import io.jsonwebtoken.Jwts;
 import io.jsonwebtoken.SignatureAlgorithm;
 import io.jsonwebtoken.security.Keys;
-import org.donggle.backend.auth.exception.NoSuchTokenException;
+import org.donggle.backend.auth.exception.ExpiredTokenException;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Component;
 
@@ -52,21 +52,26 @@ private String createToken(final Long payload, final long validityInMilliseconds
     }
 
     public Long getPayload(final String token) {
-        return getClaims(token).getBody().get(MEMBER_ID_KEY, Long.class);
+        return getClaims(token)
+                .getBody()
+                .get(MEMBER_ID_KEY, Long.class);
     }
 
     public boolean inValidTokenUsage(final String token) {
         try {
             final Jws<Claims> claims = getClaims(token);
             return claims.getBody().getExpiration().before(new Date());
         } catch (final ExpiredJwtException e) {
-            throw new NoSuchTokenException();
+            throw new ExpiredTokenException();
         } catch (final JwtException | IllegalArgumentException e) {
             return true;
         }
     }
 
     private Jws<Claims> getClaims(final String token) {
-        return Jwts.parserBuilder().setSigningKey(key).build().parseClaimsJws(token);
+        return Jwts.parserBuilder()
+                .setSigningKey(key)
+                .build()
+                .parseClaimsJws(token);
     }
 }

backend/src/main/java/org/donggle/backend/auth/exception/AuthorizationHeaderNotFoundException.java

@@ -0,0 +1,18 @@
+package org.donggle.backend.auth.exception;
+
+import org.donggle.backend.exception.authentication.AuthenticationException;
+
+public class AuthorizationHeaderNotFoundException extends AuthenticationException {
+    public AuthorizationHeaderNotFoundException() {
+        super(null);
+    }
+
+    public AuthorizationHeaderNotFoundException(final Throwable cause) {
+        super(null, cause);
+    }
+
+    @Override
+    public String getHint() {
+        return "Authorization 해더값이 존재하지 않습니다.";
+    }
+}

backend/src/main/java/org/donggle/backend/auth/exception/ExpiredTokenException.java

@@ -0,0 +1,20 @@
+package org.donggle.backend.auth.exception;
+
+import org.donggle.backend.exception.authentication.AuthenticationException;
+
+public class ExpiredTokenException extends AuthenticationException {
+    private static final String MESSAGE = "유효하지 않은 토큰입니다.";
+
+    public ExpiredTokenException() {
+        super(MESSAGE);
+    }
+
+    public ExpiredTokenException(final Throwable cause) {
+        super(MESSAGE, cause);
+    }
+
+    @Override
+    public String getHint() {
+        return "AccessToken이 만료되었습니다. RefreshToken값을 요청하세요.";
+    }
+}

backend/src/main/java/org/donggle/backend/auth/exception/InvalidAuthorizationHeaderTypeException.java

@@ -0,0 +1,22 @@
+package org.donggle.backend.auth.exception;
+
+import org.donggle.backend.exception.authentication.AuthenticationException;
+
+public class InvalidAuthorizationHeaderTypeException extends AuthenticationException {
+    private final String authorizationHeader;
+
+    public InvalidAuthorizationHeaderTypeException(final String authorizationHeader) {
+        super(null);
+        this.authorizationHeader = authorizationHeader;
+    }
+
+    public InvalidAuthorizationHeaderTypeException(final String authorizationHeader, final Throwable cause) {
+        super(null, cause);
+        this.authorizationHeader = authorizationHeader;
+    }
+
+    @Override
+    public String getHint() {
+        return "Authorization 헤더의 타입이 올바르지 않습니다. 입력한 헤더: " + authorizationHeader;
+    }
+}

backend/src/main/java/org/donggle/backend/auth/exception/InvalidRefreshTokenException.java

@@ -0,0 +1,18 @@
+package org.donggle.backend.auth.exception;
+
+import org.donggle.backend.exception.authentication.AuthenticationException;
+
+public class InvalidRefreshTokenException extends AuthenticationException {
+    public InvalidRefreshTokenException() {
+        super(null);
+    }
+
+    public InvalidRefreshTokenException(final Throwable cause) {
+        super(null, cause);
+    }
+
+    @Override
+    public String getHint() {
+        return "유효하지 않은 RefreshToken입니다. 다시 로그인을 진행하세요.";
+    }
+}

backend/src/main/java/org/donggle/backend/auth/exception/NoRefreshTokenInCookieException.java

@@ -0,0 +1,18 @@
+package org.donggle.backend.auth.exception;
+
+import org.donggle.backend.exception.authentication.AuthenticationException;
+
+public class NoRefreshTokenInCookieException extends AuthenticationException {
+    public NoRefreshTokenInCookieException() {
+        super(null);
+    }
+
+    public NoRefreshTokenInCookieException(final Throwable cause) {
+        super(null, cause);
+    }
+
+    @Override
+    public String getHint() {
+        return "쿠키에 RefreshToken이 존재하지 않습니다.";
+    }
+}

backend/src/main/java/org/donggle/backend/auth/exception/RefreshTokenNotFoundException.java

@@ -0,0 +1,18 @@
+package org.donggle.backend.auth.exception;
+
+import org.donggle.backend.exception.authentication.AuthenticationException;
+
+public class RefreshTokenNotFoundException extends AuthenticationException {
+    public RefreshTokenNotFoundException() {
+        super(null);
+    }
+
+    public RefreshTokenNotFoundException(final Throwable cause) {
+        super(null, cause);
+    }
+
+    @Override
+    public String getHint() {
+        return "존재하지 않는 토큰입니다. 다시 로그인을 진행하세요.";
+    }
+}

backend/src/main/java/org/donggle/backend/auth/presentation/AuthInterceptor.java

@@ -4,7 +4,7 @@
 import jakarta.servlet.http.HttpServletResponse;
 import lombok.RequiredArgsConstructor;
 import org.donggle.backend.auth.JwtTokenProvider;
-import org.donggle.backend.auth.exception.InvalidAccessTokenException;
+import org.donggle.backend.auth.exception.ExpiredTokenException;
 import org.donggle.backend.auth.support.AuthorizationExtractor;
 import org.springframework.web.cors.CorsUtils;
 import org.springframework.web.servlet.HandlerInterceptor;
@@ -26,7 +26,7 @@ public boolean preHandle(final HttpServletRequest request, final HttpServletResp
     private void validateToken(final HttpServletRequest request) {
         final String token = AuthorizationExtractor.extract(request);
         if (jwtTokenProvider.inValidTokenUsage(token)) {
-            throw new InvalidAccessTokenException();
+            throw new ExpiredTokenException();
         }
     }
-}
+}

backend/src/main/java/org/donggle/backend/auth/presentation/RefreshTokenAuthInterceptor.java

@@ -6,7 +6,9 @@
 import org.donggle.backend.application.repository.TokenRepository;
 import org.donggle.backend.auth.JwtToken;
 import org.donggle.backend.auth.JwtTokenProvider;
-import org.donggle.backend.auth.exception.NoSuchTokenException;
+import org.donggle.backend.auth.exception.InvalidRefreshTokenException;
+import org.donggle.backend.auth.exception.NoRefreshTokenInCookieException;
+import org.donggle.backend.auth.exception.RefreshTokenNotFoundException;
 import org.springframework.web.servlet.HandlerInterceptor;
 
 import java.util.Arrays;
@@ -22,11 +24,11 @@ public boolean preHandle(final HttpServletRequest request,
                              final Object handler) {
         final String refreshToken = extract(request);
         final Long memberId = jwtTokenProvider.getPayload(refreshToken);
-        final JwtToken jwtToken = tokenRepository.findByMemberId(memberId)
-                .orElseThrow(NoSuchTokenException::new);
+        final JwtToken findRefreshToken = tokenRepository.findByMemberId(memberId)
+                .orElseThrow(RefreshTokenNotFoundException::new);
 
-        if (jwtToken.isDifferentRefreshToken(refreshToken) || jwtTokenProvider.inValidTokenUsage(refreshToken)) {
-            throw new NoSuchTokenException();
+        if (findRefreshToken.isDifferentRefreshToken(refreshToken) || jwtTokenProvider.inValidTokenUsage(refreshToken)) {
+            throw new InvalidRefreshTokenException();
         }
 
         return true;
@@ -36,7 +38,7 @@ private String extract(final HttpServletRequest request) {
         return Arrays.stream(request.getCookies())
                 .filter(cookie -> "refreshToken".equals(cookie.getName()))
                 .findFirst()
-                .orElseThrow(NoSuchTokenException::new)
+                .orElseThrow(NoRefreshTokenInCookieException::new)
                 .getValue();
     }
 }

backend/src/main/java/org/donggle/backend/auth/support/AuthorizationExtractor.java

@@ -3,8 +3,8 @@
 import jakarta.servlet.http.HttpServletRequest;
 import lombok.AccessLevel;
 import lombok.NoArgsConstructor;
-import org.donggle.backend.auth.exception.EmptyAuthorizationHeaderException;
-import org.donggle.backend.auth.exception.NoSuchTokenException;
+import org.donggle.backend.auth.exception.AuthorizationHeaderNotFoundException;
+import org.donggle.backend.auth.exception.InvalidAuthorizationHeaderTypeException;
 import org.springframework.http.HttpHeaders;
 
 import java.util.Objects;
@@ -16,7 +16,7 @@ public class AuthorizationExtractor {
     public static String extract(final HttpServletRequest request) {
         final String authorizationHeader = request.getHeader(HttpHeaders.AUTHORIZATION);
         if (Objects.isNull(authorizationHeader)) {
-            throw new EmptyAuthorizationHeaderException();
+            throw new AuthorizationHeaderNotFoundException();
         }
 
         validateAuthorizationFormat(authorizationHeader);
@@ -25,7 +25,7 @@ public static String extract(final HttpServletRequest request) {
 
     private static void validateAuthorizationFormat(final String authorizationHeader) {
         if (!authorizationHeader.toLowerCase().startsWith(BEARER_TYPE.toLowerCase())) {
-            throw new NoSuchTokenException();
+            throw new InvalidAuthorizationHeaderTypeException(authorizationHeader);
         }
     }
-}
+}

backend/src/main/java/org/donggle/backend/exception/authentication/AuthenticationException.java

@@ -1,11 +1,19 @@
 package org.donggle.backend.exception.authentication;
 
+import org.springframework.http.HttpStatus;
+
 public abstract class AuthenticationException extends RuntimeException {
     public AuthenticationException(final String message) {
         super(message);
     }
-
+    
     public AuthenticationException(final String message, final Throwable cause) {
         super(message, cause);
     }
+
+    public abstract String getHint();
+
+    public final int getErrorCode() {
+        return HttpStatus.UNAUTHORIZED.value();
+    }
 }

backend/src/main/java/org/donggle/backend/exception/business/BusinessException.java

@@ -8,4 +8,8 @@ public BusinessException(final String message) {
     public BusinessException(final String message, final Throwable cause) {
         super(message, cause);
     }
+
+    public abstract String getHint();
+
+    public abstract int getErrorCode();
 }