[Spring]파일구조 (중요)

이쯤되면 프로젝트 셋업은 거뜬히 할 줄 알아야 된다고 생각이 들었다.

 

그래서 해보려는데 생각보다 어렵다, 각 파일별로 어떤 역할을 하는지 명확하게 이해하지 못하기 때문인 것 같다.

 

 

 

📦com.example.myproject
 ┣ 📂controller      ← 손님 응대
 ┣ 📂dto             ← 포장된 요청/응답
 ┣ 📂entity          ← 진짜 데이터(물건)
 ┣ 📂config          ← 환경 설정
 ┗ 📂repository      ← 창고 (DB와 연결)

 

각 폴더/계층 역할 요약

 

• 📁 dto: 응답/요청 역할을 맡고 있음. 데이터를 주고받는 그릇들.
  • PostCreateRequestDto
    사용자가 게시글을 새로 작성할 때, 제목과 내용 같은 요청 데이터를 담는 그릇
  • PostResponseDto
    저장된 게시글을 조회하거나 사용자에게 응답할 때, 필요한 정보만 골라서 담는 그릇
  • PostUpdateRequestDto
    사용자가 게시글을 수정할 때, 수정된 제목과 내용을 담는 요청 그릇

  ---

  📁 entity: DB와 1:1로 매핑되는 클래스
  • Post라는 이름으로 만들고
    실제 데이터(제목, 내용 등)를 저장할 필드들이 들어감
    → 이 클래스가 실제 DB 테이블과 연결됨

  ---

  📁 repository: 생성된 게시글을 단순히 저장하는 게 아니라, CRUD(생성/조회/수정/삭제)가 가능하도록 도와주는 인터페이스  
  • save(), findById(), delete() 같은 메서드가 자동으로 제공됨
  • JPA가 알아서 구현체 만들어줌

  ---

  📁 service: 게시글 생성, 수정, 삭제, 조회 등의 핵심 로직을 처리하는 공간
  • Controller와 Repository 사이에서 동작
  • 사용자가 요청한 작업을 실제로 처리하는 비즈니스 로직 담당자

  ---

  📁 controller: 사용자의 요청을 가장 먼저 받는 곳, URL을 매핑해서 처리하고 응답을 돌려줌
  • 쉽게 말하면 요청 진입점
  • REST API 기준으로는 주로 JSON 형식의 데이터를 응답으로 돌려줌
    예) @PostMapping("/posts") 이런 게 여기서 처리됨

---

 

1. controller 

사용자 요청 받고 서비스로 전달하고 응답을 돌려주는 문지기

 

@RestController
@RequestMapping("/posts")
public class PostController {

    private final PostService postService;

    @PostMapping
    public PostResponseDto createPost(@RequestBody PostCreateRequestDto requestDto) {
        return postService.create(requestDto);
    }
}

 

2. dto

Entity는 민감한 정보도 포함되므로 외부엔 필요한 정보만 따로 감싸서 주고 받음

 

Entity는 비밀번호 같은 민감한 정보나 DB 관련 설정이 포함되어 있어서, 이를 그대로 외부에 노출하면 위험

그래서 외부 통신에는 필요한 정보만 담은 DTO를 따로 만들어 사용한다.

 

DTO는 단독으로 의미를 가진 개념이 아니라 항상 Entity와 함께 비교되면서 쓰인다.

즉, 

Entity: 진짜 데이터(DB와 직접 연결)

DTO: 전송용 데이터 (프론트엔드와 주고받는 가공된 데이터)

@Getter
@AllArgsConstructor
public class UserResponseDto {
    private String username;  // password는 제외
}

 

@Entity
public class User {
    @Id
    private Long id;

    private String username;
    private String password;  // 절대 외부에 보여주면 안 됨
}

 

 

3. entity

DB테이블과 1:1매핑됨

@Entity, @Id, @Colum 같은 어노테이션 붙음

 

@Entity
public class Post {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String title;
    private String content;

    // 생성자, getter 등...
}

 

 

4. config

프로젝트 전반적인 설정: CORS, 필터, 인증, 빈 등록 등

얘는 스프링이 자동으로 읽는다.

 

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**").allowedOrigins("*");
    }
}

---

 

흐름 정리

[사용자] → Controller → DTO → Service → Entity → Repository → DB ↓ 결과 DTO 응답

 

entity 와 dto를 따로 써야 하는 이유

 

보안과 역할 분리

Entity는 그대로 외부에 주면 DB구조가 노출됨