스프링 부트 프로젝트 구조

 

📁 스프링 프로젝트 기본 구조 예시

📦 my-spring-project/
 ┣ 📁 src/
 ┃ ┣ 📁 main/
 ┃ ┃ ┣ 📁 java/
 ┃ ┃ ┃ ┗ 📁 com/example/demo/
 ┃ ┃ ┃ ┃ ┣ 📄 DemoApplication.java
 ┃ ┃ ┃ ┃ ┣ 📁 controller/
 ┃ ┃ ┃ ┃ ┣ 📁 service/
 ┃ ┃ ┃ ┃ ┣ 📁 repository/
 ┃ ┃ ┣ 📁 resources/
 ┃ ┃ ┃ ┣ 📄 application.properties (or .yml)
 ┃ ┃ ┃ ┣ 📁 static/
 ┃ ┃ ┃ ┣ 📁 templates/
 ┣ 📁 test/
 ┃ ┣ 📁 java/
 ┃ ┃ ┗ 📁 com/example/demo/
 ┃ ┃ ┃ ┣ 📄 DemoApplicationTests.java
 ┣ 📄 build.gradle or pom.xml

 

 

📂 주요 폴더/파일 설명

📁 src/main/java/

• 실제 비즈니스 로직이 들어가는 코드들이 이 안에 있음.
• 보통 패키지를 기준으로 나눔: controller, service, repository, domain 등.

📄 DemoApplication.java

• 프로젝트의 진입점(Entry Point).
• @SpringBootApplication이 붙어 있어서 실행 시 이 파일부터 실행됨.

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

 

 

📁 controller/

• 사용자의 요청(Request)을 받아 처리하는 웹 계층.
• 주로 @RestController 또는 @Controller 사용.

@RestController
public class HelloController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello Spring!";
    }
}

 

 

📁 service/

• 비즈니스 로직을 처리하는 계층.
• controller와 repository 사이의 중간 단계 역할.
• @Service 애너테이션 사용.

@Service
public class UserService {
    public String getUserName() {
        return "홍길동";
    }
}

 

 

📁 repository/

• DB와 연결되는 계층.
• JPA, MyBatis, JDBC 등을 통해 DB CRUD 작업 수행.
• 보통 @Repository 또는 JpaRepository를 상속함.

@Repository
public interface UserRepository extends JpaRepository<User, Long> {}

 

 

📁 resources/

• 설정 파일과 정적 파일, 템플릿 등이 들어감.

📄 application.properties 또는 application.yml

• 환경 설정 파일.
• 포트 번호, DB 연결 정보, 타임리프 설정 등.

server.port=8081
spring.datasource.url=jdbc:mysql://localhost:3306/mydb

📁 static/

• 정적 자원을 두는 곳 (CSS, JS, 이미지 등).
• 예: /static/style.css → 브라우저에서 /style.css로 접근 가능.

📁 templates/

• Thymeleaf 등의 템플릿 HTML 파일 위치.
• 예: templates/home.html → return "home"; 으로 반환 시 렌더링됨.

📁 src/test/java/

• 테스트 코드를 작성하는 공간.
• JUnit, Mockito 등을 활용해서 기능을 검증.

 

 

📄 build.gradle 또는 pom.xml

• 빌드 도구 설정 파일.
• 어떤 라이브러리를 사용할지, 어떤 플러그인을 쓸지 명시.

 

전체적인 흐름 정리

1. 사용자 요청 → controller로 전달
2. controller → service 호출해서 비즈니스 처리
3. service → repository 통해 DB 접근
4. 결과를 다시 거꾸로 반환 → 응답
5. 웹 페이지가 필요하면 templates에서 HTML 렌더링