Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

BasicBoard

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 커스텀 예외

실행 방법

1. H2 서버 실행

이 프로젝트는 H2 TCP 모드를 사용합니다. 애플리케이션 실행 전에 H2 서버를 먼저 시작해야 합니다.

# H2 jar 파일 위치에서 실행
java -cp h2*.jar org.h2.tools.Server -tcp -tcpAllowOthers -start

H2 콘솔: http://localhost:8082
JDBC URL: jdbc:h2:tcp://localhost/~/board

2. 애플리케이션 실행

./gradlew bootRun

서버는 8888 포트에서 시작됩니다.


API 명세

인증

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} 을 포함해야 합니다.


주요 학습 포인트

1. JPA / Hibernate

  • @Entity, @Table, @Id, @GeneratedValue
  • 연관관계 매핑: @ManyToOne, @OneToMany, @ElementCollection
  • @CreationTimestamp, @UpdateTimestamp 자동 타임스탬프
  • Lazy Loading vs Eager Loading

2. Spring Security + JWT

  • OncePerRequestFilter를 활용한 JWT 검증 필터
  • UserDetailsService 구현으로 사용자 인증 처리
  • AuthenticationSuccessHandler / AuthenticationFailureHandler
  • SecurityContextHolder에 인증 정보 저장

3. 빌더 패턴 (Builder Pattern)

  • Lombok @Builder를 활용한 객체 생성
  • 메서드 체이닝 방식으로 가독성 높은 객체 생성

4. 계층 구조 (Layered Architecture)

  • Controller → Service → Repository 계층 분리
  • 인터페이스와 구현체 분리 (BoardService / BoardServiceImpl2)
  • DTO와 Entity 분리

5. 토큰 기반 인증 흐름

로그인 → 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)는 참고용 코드이며 현재 비활성 상태입니다.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages