Release v1.1.0 – 모놀로식에서 멀티 모듈로 migration

📦 Release v1.1.0

Release date: 2025-05-07
Previous version: lib-v1.0.6, jwt-v1.0.1

---

📝 Overview

배포 방식이 바뀌면서 jwt, lib jar 파일 둘 중 하나만 받아지는 버그 수정했습니다.

🐛 Bug Fixes

• issue: jwt, lib jar 파일 둘 중 하나만 받을 수 있게 됨:
  • git package로 배포하던 방식이 jitpack으로 바뀌게 되면서 한 레포 당 jar 파일 한 개만 빌드할 수 있어, 멀티모듈로 바꾸게 되었습니다.

---

🔧 Migration

• 수정 전 build.gradle

repositories {
    mavenCentral()
    // 이 부분 추가
    maven {
        url 'https://jitpack.io'
    }
}

implementation 'com.github.ryulkim:LibCC:1.0.5:plain'

• 수정 후 build.gradle

repositories {
    mavenCentral()
    // 이 부분 추가
    maven {
        url 'https://jitpack.io'
    }
}

implementation 'com.github.ryulkim.LibCC:lib:v1.1.0'
implementation 'com.github.ryulkim.LibCC:jwt:v1.1.0'

---

Release v1.0.5 – 공통 응답코드 및 예외 핸들러 추가

📦 Release 1.0.5

Release date: 2025-05-05
Previous version: 없음

---

📝 Overview

Spring 기반 서비스에서 공통적으로 사용되는 예외 처리 및 유틸 기능을 모듈화한 첫 릴리즈입니다.

---

🔧 설치 및 사용

Gradle에 다음 의존성을 추가하세요:

repositories {
    mavenCentral()
    // 이 부분 추가
    maven {
        url 'https://jitpack.io'
    }
}

implementation 'com.github.ryulkim:LibCC:1.0.5:plain'

예외 핸들러를 사용하고 싶다면,
SpringBootApplication에서 다음을 추가해주세요:

@SpringBootApplication(scanBasePackages = {
  "com.mycompany.app",       // 여러분 앱의 패키지
  "com.library.lib.exception"  // 모듈의 패키지
})

---

✨ New Features

✅ 공통 예외 처리

1. 공통 예외 핸들러 (GlobalExceptionHandler)

• @RestControllerAdvice 기반의 예외 처리 지원
• 발생한 예외에 대해 로그 자동 출력

  • 출력 형식:

    {Exception 클래스명}: {지정한 에러 메시지}
    

2. 공통 코드 정의

• 제공되는 기본 에러 코드:

  SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "서버 에러가 발생하였습니다.")

• 제공되는 기본 성공 코드:

  SUCCESS(HttpStatus.OK, "성공했습니다.")

• 제공되는 ApiResponseEntity 형태

  • 출력 형식:

    {
      "code": "{enum_name}",
      "message": "{message}",
      "result": "{data}"
    }

  • 사용 예시:

    • 성공 응답

      ApiResponseEntity.onSuccess(Object result);
      ApiResponseEntity.onSuccess(null);

    • 실패 응답

      ApiResponseEntity.onFailure(StatusCode code);

    • 응답 커스텀

      ApiResponseEntity.from(StatusCode code, Object result);
      ApiResponseEntity.from(StatusCode code, null);

3. 사용 방법 예시

(1) 공통 예외 사용

@GetMapping
public ResponseEntity<ApiResponse<Object>> test() {
    throw new GlobalException(ErrorCode.SERVER_ERROR);
}

• 💡 결과:
  
  

• 📄 로그:
  

---

(2) 에러 코드 확장

• StatusCode를 구현한 enum을 새로 정의

@Getter
@RequiredArgsConstructor
public enum ERORORO implements StatusCode {
    TEST(NOT_FOUND, "test다. test"),
    TEST2(NOT_FOUND, "testtesttest다.");

    private final HttpStatus httpStatus;
    private final String message;

    @Override
    public String getName() {
        return this.name();
    }
}

• 사용 예:

@GetMapping
public ResponseEntity<ApiResponse<Object>> test() {
    throw new GlobalException(ERORORO.TEST2);
}

• 💡 결과:
  
  

• 📄 로그:
  

---

(3) 커스텀 예외 클래스 사용

@Getter
public class AError extends GlobalException {
    public AError(StatusCode errorCode) {
        super(errorCode);
    }
}

@GetMapping
public ResponseEntity<ApiResponse<Object>> test() {
    throw new AError(ERORORO.TEST2);
}

• 💡 결과:
  

---

🐣 랜덤 닉네임 생성기

1. 제공 포맷

• 형식: 형용사 + 명사
• 형용사 예시:
  "행복한", "즐거운", "신나는", "멋진", "용감한", "친절한", "성실한", "유머러스한"...
• 명사 예시:
  "호랑이", "고양이", "펭귄", "돌고래", "알파카", "수달", "전기뱀장어"...

2. 사용 방법

NickGenerator.generateUniqueNickname();

• 💡 결과 예시:
  
  

---

Release lib-v1.0.6 – 공통 응답코드에 Create 추가

📦 Release lib-v1.0.6

Release date: 2025-05-05
Previous version: 1.0.5

---

📝 Overview

• 공통 응답코드에 create가 추가 되었습니다.
• 버전도 1.0.5에서 기능 이름을 구분한 lib-v1.0.6으로 바뀌었습니다

---

📌 How to Upgrade

dependencies {
    implementation "com.github.ryulkim:LibCC:lib-v1.0.6:plain"
}

---

✨ New Features

• ApiResponseEntity.class:

public static <T> ResponseEntity<ApiResponse<T>> create(StatusCode code, String url, T result) {
    return ResponseEntity.created(URI.create(url))
            .body(new ApiResponse<>(code.getName(), code.getMessage(), result));
}

• 사용법 예

@GetMapping
public ResponseEntity<ApiResponse<Object>> test() {
    long resourceId=1L;

    return ApiResponseEntity.create(ERORORO.CREATE,"/located/"+resourceId, null);
}