Spring Boot 프로젝트 (1단계 - 생성 및 환경 설정)

2025. 1. 10. 00:19IT정보/초보자를 위한 IT 팁

Spring Boot를 활용한 프로젝트를 IntelliJ IDEA에서 생성하고 환경을 설정하는 방법을 단계별로 설명합니다.


1. IntelliJ IDEA 실행 및 새로운 프로젝트 생성

  1. IntelliJ IDEA를 실행합니다.
  2. 시작 화면에서 New Project를 선택합니다.

2. 프로젝트 템플릿 선택

  1. 왼쪽 메뉴에서 Spring Initializr를 선택합니다.
  2. Project SDK에서 설치된 JDK를 선택합니다.
  3. Next를 클릭합니다.

3. 프로젝트 메타데이터 설정

  1. Group: 도메인을 역순으로 작성 (예: com.example)
  2. Artifact: 프로젝트 이름 (예: springboot-demo)
  3. Type: Maven 또는 Gradle 중 선택
  4. Language: Java를 선택
  5. Packaging: Jar 또는 War 선택
  6. Java Version: 프로젝트에 사용할 JDK 버전 선택
    Next를 클릭합니다.

 

4. 의존성 추가

  1. Dependencies 에서 필요한 의존성을 선택 추가합니다.
    • 예: Spring Web (웹 애플리케이션 개발을 위해)
  2. 모든 의존성을 추가한 후 Next를 클릭합니다.
  3. Finish를 클릭하여 프로젝트 생성을 완료합니다.


6. 프로젝트 구조 확인 및 설정 파일 수정

  1. 프로젝트 생성 후 기본 디렉토리 구조 확인:
    • src/main/java
    • src/main/resources
  2. 서버 포트를 변경하려면 src/main/resources 폴더 내 application.properties를 같이 설정
    package com.example.springbootdemo.controller;
    
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
    public class HelloController {
    
        @GetMapping("/hello")
        public String hello() {
            return "Hello, World!";
        }
    }
    

7. 메인 클래스 확인 및 실행

  1. src/main/java 디렉토리 내 Application 클래스 확인.
    • 클래스에는 @SpringBootApplication 어노테이션이 포함되어 있습니다.
  2. 메인 메서드를 실행하여 애플리케이션이 정상적으로 작동하는지 확인합니다.


8. 기본 컨트롤러 추가 및 테스트

  1. src/main/java 디렉토리 내 controller 패키지를 생성합니다.
  2. 새로운 Java 클래스 (HelloController.java)를 추가합니다.
  3. 다음과 같이 코드를 작성합니다:
    package com.example.springbootdemo.controller;
    
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
    public class HelloController {
    
        @GetMapping("/hello")
        public String hello() {
            return "Hello, World!";
        }
    }
    
  4. 애플리케이션 실행 후, 웹 브라우저에서 http://localhost:8080/hello 접속하여 "Hello, World!" 출력 확인.

 


9. Oracle 데이터베이스 연동 설정

  1. pom.xml 파일에 Oracle JDBC 드라이버 의존성 추가:
    <dependency>
        <groupId>com.oracle.database.jdbc</groupId>
        <artifactId>ojdbc8</artifactId>
        <version>19.8.0.0</version>
    </dependency>
    
  2. application.properties 파일에 데이터베이스 연결 정보 추가:
    spring.datasource.url=jdbc:oracle:thin:@localhost:1521:xe
    spring.datasource.username=your_username
    spring.datasource.password=your_password
    spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
    

10. MyBatis 설정

  1. pom.xml 파일에 MyBatis 스프링 부트 스타터 의존성 추가:
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.0</version>
    </dependency>
    
  2. application.properties 파일에 MyBatis 설정 추가:
    mybatis.mapper-locations=classpath:mappers/*.xml
    
  3. src/main/resources 디렉토리에 mappers 폴더를 생성하고 필요한 매퍼 XML 파일 추가.

11. 프로젝트 빌드 및 실행

  1. IntelliJ IDEA 상단 메뉴에서 Build > Build Project를 선택하여 프로젝트 빌드.
  2. 빌드 완료 후 메인 클래스를 실행하여 애플리케이션 확인.

다음글 에서는 MyBatis Oracle 이용한 데이터베이스 연동에 대해 알아보겠습니다.