Spring Boot 기반 게시판 REST API 실습 프로젝트입니다.
JWT 인증, Spring Security, JPA/Hibernate를 학습하기 위한 예제 코드를 포함합니다.
| 분류 | 기술 |
|---|---|
| Language | Java 17 |
| Framework | Spring Boot 3.4.0 |
| Security | Spring Security 6, JWT (jjwt 0.11.5) |
| ORM | Spring Data JPA / Hibernate |
| Database | H2 (인메모리 / 파일 모드) |
| Build | Gradle |
src/main/java/study/board/
├── config/
│ └── CustomSecurityConfig.java # Spring Security 설정
├── controller/
│ ├── BootController.java # 게시글 CRUD API
│ ├── APIRefreshController.java # JWT 토큰 갱신 API
│ └── advice/
│ └── CustomControllerAdvice.java # 전역 예외 처리
├── domain/
│ ├── dto/
│ │ ├── BoardRequest.java # 게시글 요청 DTO
│ │ └── MemberDTO.java # 회원 DTO (Spring Security 연동)
│ └── entity/
│ ├── Board.java # 게시글 엔티티
│ ├── Member.java # 회원 엔티티
│ └── MemberRole.java # 권한 Enum (USER, MANAGER, ADMIN)
├── mapper/
│ └── BoardMapper.java # MyBatis 매퍼 (참고용)
├── repository/
│ ├── BoardRepository.java # JPA 게시글 레포지토리
│ └── MemberRepository.java # JPA 회원 레포지토리
├── security/
│ ├── CustomuserDetailsService.java # 사용자 인증 서비스
│ ├── filter/
│ │ └── JWTCheckFilter.java # JWT 검증 필터
│ └── handler/
│ ├── APILoginSuccessHandler.java # 로그인 성공 핸들러
│ ├── APILoginFailHandler.java # 로그인 실패 핸들러
│ └── CustomAccessDeniedHandler.java
├── service/
│ ├── BoardService.java # 서비스 인터페이스
│ ├── BoardServiceImpl1.java # MyBatis 구현체 (참고용)
│ └── BoardServiceImpl2.java # JPA 구현체 (활성)
└── util/
├── JWTUtil.java # JWT 토큰 생성 및 검증
└── CustomJWTException.java # JWT 커스텀 예외
이 프로젝트는 H2 TCP 모드를 사용합니다. 애플리케이션 실행 전에 H2 서버를 먼저 시작해야 합니다.
# H2 jar 파일 위치에서 실행
java -cp h2*.jar org.h2.tools.Server -tcp -tcpAllowOthers -startH2 콘솔: http://localhost:8082
JDBC URL:jdbc:h2:tcp://localhost/~/board
./gradlew bootRun서버는 8888 포트에서 시작됩니다.
| Method | URL | 설명 |
|---|---|---|
| POST | /api/member/login |
로그인 (accessToken, refreshToken 반환) |
| POST | /api/member/refresh |
토큰 갱신 |
로그인 요청 예시 (form-data)
username=user@example.com
password=1234
로그인 응답 예시
{
"email": "user@example.com",
"nickname": "홍길동",
"roleNames": ["USER"],
"accessToken": "eyJ...",
"refreshToken": "eyJ..."
}| Method | URL | 설명 | 인증 필요 |
|---|---|---|---|
| POST | /board |
게시글 작성 | O |
| GET | /board |
게시글 목록 조회 | O |
게시글 작성 요청 예시 (form-data)
userId=user@example.com
pwd=1234
title=제목
contents=내용
요청 헤더에
Authorization: Bearer {accessToken}을 포함해야 합니다.
@Entity,@Table,@Id,@GeneratedValue- 연관관계 매핑:
@ManyToOne,@OneToMany,@ElementCollection @CreationTimestamp,@UpdateTimestamp자동 타임스탬프- Lazy Loading vs Eager Loading
OncePerRequestFilter를 활용한 JWT 검증 필터UserDetailsService구현으로 사용자 인증 처리AuthenticationSuccessHandler/AuthenticationFailureHandlerSecurityContextHolder에 인증 정보 저장
- Lombok
@Builder를 활용한 객체 생성 - 메서드 체이닝 방식으로 가독성 높은 객체 생성
- Controller → Service → Repository 계층 분리
- 인터페이스와 구현체 분리 (
BoardService/BoardServiceImpl2) - DTO와 Entity 분리
로그인 → accessToken(10분) + refreshToken(24시간) 발급
→ API 요청 시 accessToken 헤더 포함
→ accessToken 만료 시 /api/member/refresh 로 갱신
Hibernate의 ddl-auto=update 설정으로 실행 시 자동 생성됩니다.
MEMBER (email PK, password, nickname)
└── MEMBER_ROLE_LIST (email FK, role)
BOARD (board_id PK, title, contents, user_id, file_name, pwd, create_at, update_at, email FK)
- 이 프로젝트는 학습용 예제입니다. 운영 환경에서는 JWT 시크릿 키를 환경변수로 분리하고 CORS 설정을 적절히 제한해야 합니다.
- MyBatis 구현체(
BoardServiceImpl1)는 참고용 코드이며 현재 비활성 상태입니다.