02-reusable-code-java — Java/Spring Boot 재사용 패턴 라이브러리

Spring Boot 3+ / JPA / Spring Security 6+ 기반 범용 패턴

개요

다양한 프로젝트에서 추출한 범용 Java/Spring Boot 패턴을 관리합니다. 패키지는 com.example.app.*으로 통일되어 있으며, 실제 프로젝트에 적용 시 패키지명을 변경하여 사용합니다.

폴더 구조

폴더	설명	파일 수
`01-domain/`	JPA 엔티티 기본 클래스	3
`02-config/`	Spring Boot 설정 패턴 (Security, Cache, MVC, JPA 등)	9
`03-security/`	Spring Security 인증/인가 패턴	4
`04-exception/`	예외 처리 패턴 (GlobalExceptionHandler 등)	4
`05-util/`	유틸리티 (파일 업로드, 패스워드, 폴넷 SSO)	5
`06-service/`	범용 서비스 패턴 (감사 로그, 파일 관리, 문서 내보내기)	5
`07-testing/`	통합 테스트 베이스 클래스	1

파일 인덱스

01-domain

파일	설명	의존성
`BaseTimeEntity.java`	JPA 감사 기본 클래스 (@CreatedDate/@LastModifiedDate)	Spring Data JPA
`AuditLog.java`	감사 로그 엔티티 (UUID PK, entityType+entityId 복합 인덱스)	JPA, Lombok
`AdminSetting.java`	관리자 설정 KV 엔티티 (UNIQUE settingKey, 공지/비밀번호 상수)	JPA, Lombok

02-config

파일	설명	의존성
`SecurityConfig.java`	Spring Security 6 통합 설정 (CSRF, 역할기반, 세션관리)	Spring Security 6+
`CachingConfig.java`	Caffeine 캐시 설정	Caffeine, Spring Cache
`RestTemplateConfig.java`	HTTP 클라이언트 타임아웃 설정	Spring Web
`FileUploadConfig.java`	업로드 디렉토리 초기화	Spring Core
`GlobalModelAdvice.java`	전역 사용자 정보 모델 주입	Spring MVC, Spring Security
`WebMvcConfig.java`	정적 리소스 핸들링 + 캐시 설정	Spring MVC
`JpaConfig.java`	JPA Auditing 활성화	Spring Data JPA
`BreadcrumbAdvice.java`	URL→라벨 매핑 전역 브레드크럼 (정적 맵 + 프리픽스 동적 매칭)	Spring MVC
`AnnouncementAdvice.java`	AdminSetting 기반 전역 공지 주입 (active/text/type 3개 KV)	Spring MVC, JPA

03-security

파일	설명	의존성
`AjaxAwareAuthenticationEntryPoint.java`	AJAX 요청 감지 → JSON 401 반환	Spring Security
`CustomUserDetails.java`	UserDetails 확장 (직급, 부서, 인증유형)	Spring Security
`CustomUserDetailsService.java`	UserDetailsService 구현체	Spring Security, JPA
`CustomAuthenticationSuccessHandler.java`	역할 기반 로그인 후 리다이렉트	Spring Security

04-exception

파일	설명	의존성
`GlobalExceptionHandler.java`	@ControllerAdvice 중앙 에러 핸들링	Spring MVC
`BusinessException.java`	비즈니스 로직 커스텀 예외	-
`ResourceNotFoundException.java`	리소스 미발견 예외	-
`UnauthorizedException.java`	인증/권한 오류 예외	-

05-util

파일	설명	의존성
`FileUtil.java`	보안 파일 업로드 (경로 탐색 방지, UUID 파일명)	Spring Core, Java NIO
`PasswordUtil.java`	BCrypt 래퍼	Spring Security
`polnet/SeedCBC.java`	KISA SEED-CBC 블록 암호 전체 구현 (SS0-SS3 S-Box, KC 상수)	표준 라이브러리만
`polnet/MakeSeed.java`	SeedCBC Base64 래퍼 (classpath 키 파일 로드, 암/복호화)	SeedCBC
`polnet/MakePolnetNo.java`	폴넷 SSO 토큰 생성/검증 (userno+타임스탬프+IP, TIMEOUT/NOIP/NODATA)	MakeSeed, Lombok

06-service

파일	설명	의존성
`AuditLogService.java`	비동기 감사 로깅 + 스케줄 정리	Spring @Async, @Scheduled, JPA
`FileUploadService.java`	파일 업로드/삭제 + JSON 첨부 직렬화	Jackson, FileUtil
`HwpxExportService.java`	HWPX(ZIP+XML) 문서 생성 (OWPML 표준, 순수 Java)	표준 라이브러리만
`SurveyExportService.java`	설문 다중 포맷 내보내기 (Excel/CSV/TXT/PDF)	Apache POI, iText7
`SinmungoExportService.java`	민원 JPA Specification 필터링 + Excel 4시트 통계 내보내기	Apache POI, Spring Data JPA

07-testing

파일	설명	의존성
`BaseE2ETest.java`	MockMvc E2E 통합 테스트 베이스 (@SpringBootTest, H2, @Transactional, 헬퍼)	Spring Boot Test, Spring Security Test, H2

사용법

필요한 패턴 파일을 프로젝트에 복사
패키지명 com.example.app → 실제 프로젝트 패키지로 변경
import 경로 수정
프로젝트 요구사항에 맞게 커스터마이즈

필수 의존성 (build.gradle)

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-security'
    implementation 'org.springframework.boot:spring-boot-starter-cache'
    implementation 'com.github.ben-manes.caffeine:caffeine'
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
}

호환성

항목	최소 버전
Java	21+
Spring Boot	3.0+
Spring Security	6.0+

추출 이력

날짜	출처	추출 항목
2026-03-08	kcsi-smpa-internal	도메인 1, 설정 7, 보안 4, 예외 4, 유틸 2, 서비스 2 (총 20개)
2026-03-22	kcsi-smpa-internal	도메인 2 (AuditLog, AdminSetting), 설정 2 (BreadcrumbAdvice, AnnouncementAdvice), 유틸 3 (polnet/ SeedCBC, MakeSeed, MakePolnetNo), 서비스 3 (HwpxExportService, SurveyExportService, SinmungoExportService), 테스팅 1 (BaseE2ETest) — 신규 `polnet/`, `07-testing/` 디렉토리 포함 (총 11개)