스프링부트 스케줄러(Seheduler)란?

젼이·2024년 10월 25일

스프링부트 스케줄러(Seheduler)란?

스프링부트에서 스케줄링은 정해진 주기마다 특정 작업을 자동으로 실행하는 기능을 제공한다. 이 기능을 통해 주기적인 데이터 처리나 백그라운드 작업을 수행할 수 있다. 예를 들면, 매일 자정에 데이터 백업을 수행하거나, 일정 간격마다 외부 API를 호출하는 작업을 자동화할 수 있다.

스프링부트에서는 스케줄러 기능을 @Scheduled 어노테이션을 사용해 쉽게 구현할 수 있다.

스케줄러 설정 방법

1. @EnableScheduling 어노테이션 활성화:
스케줄러를 사용하려면 스프링 부트 애플리케이션의 메인 클래스나 설정 클래스에 @EnableScheduling 어노테이션을 추가해야 한다.

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;

@SpringBootApplication
@EnableScheduling  // 스케줄링 기능 활성화
public class SchedulerApplication {
    public static void main(String[] args) {
        SpringApplication.run(SchedulerApplication.class, args);
    }
}

2. 스케줄 작업 정의하기:
스케줄 작업을 수행할 메서드에 @Scheduled 어노테이션을 추가한다.

@Scheduled 사용 예시

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import java.time.LocalDateTime;

@Component
public class ScheduledTasks {

    // 매 5초마다 실행되는 작업
    @Scheduled(fixedRate = 5000)
    public void fixedRateTask() {
        System.out.println("Fixed Rate Task: " + LocalDateTime.now());
    }

    // 이전 작업이 끝난 후 5초 후에 실행
    @Scheduled(fixedDelay = 5000)
    public void fixedDelayTask() {
        System.out.println("Fixed Delay Task: " + LocalDateTime.now());
    }

    // 매일 자정(00:00:00)에 실행
    @Scheduled(cron = "0 0 0 * * ?")
    public void cronTask() {
        System.out.println("Cron Task: " + LocalDateTime.now());
    }
}

스케줄링 방식 설명

1. fixedRate

이전 작업이 완료되었는지 여부와 상관없이 고정된 주기마다 실행된다.
예시: 5초마다 실행되는 작업
- 만약 작업이 7초 걸려도, 5초마다 작업이 시작된다. (작업이 겹칠 수 있음)

@Scheduled(fixedRate = 5000)  // 5초마다 실행
public void fixedRateTask() {
    System.out.println("Fixed Rate Task: " + LocalDateTime.now());
}

2. fixedDelay

이전 작업이 끝난 후 지정된 시간이 지난 후에 다음 작업이 실행된다.
예시: 작업이 2초 걸리고, 5초의 fixedDelay가 설정되면, 7초마다 실행된다.

@Scheduled(fixedDelay = 5000)  // 이전 작업 종료 후 5초 후 실행
public void fixedDelayTask() {
    System.out.println("Fixed Delay Task: " + LocalDateTime.now());
}

3. cron 표현식

크론 표현식(Cron Expression)을 사용해 특정 시간에 작업을 수행할 수 있다.
예시: 매일 자정(00:00:00)에 실행되는 작업

@Scheduled(cron = "0 0 0 * * ?")  // 매일 자정 실행
public void cronTask() {
    System.out.println("Cron Task: " + LocalDateTime.now());
}

Cron 표현식 구조

초(Seconds): 0 ~ 59
분(Minutes): 0 ~ 59
시(Hours): 0 ~ 23
일(Day of Month): 1 ~ 31
월(Month): 1 ~ 12 (혹은 JAN, FEB 등)
요일(Day of Week): 0 ~ 6 (0 = 일요일)

예시 크론 표현식:

"0 0 12 * *" -> 매일 정오 12시에 실행
"0 15 10 * *" -> 매일 오전 10시 15분에 실행
"0 0/5 * * *" -> 매 5분마다 실행

스케줄링 주의사항

멀티 스레드 환경:
기본적으로 스케줄링은 단일 스레드에서 동작한다. 여러 스케줄이 동시에 실행될 수 있으면 @Async와 @ThreadPoolTaskScheduler를 사용해 멀티 스레드 환경을 구성할 수 있다.
스케줄링 예외 처리:
스케줄러에서 발생하는 예외는 처리하지 않으면 작업이 중지될 수 있다. 예외 발생 시 로그를 남기거나 필요한 처리를 해주는 것이 좋다.

@Scheduled(fixedRate = 5000)
public void safeTask() {
    try {
        // 스케줄링 작업
    } catch (Exception e) {
        System.err.println("Error occurred: " + e.getMessage());
    }
}

비동기 작업 처리:
여러 스케줄 작업이 병렬로 실행되기 원하면 비동기 스케줄링을 사용해야 한다. 이를 위해 @EnableAsync와 @Async를 조합해 사용할 수 있다.

import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Component;

@Component
public class AsyncTasks {

    @Async
    public void runAsyncTask() {
        System.out.println("Executing Async Task");
    }
}

스케줄링 테스트 방법

스케줄링 작업은 서버가 실행된 후 자동으로 주기적으로 실행된다. 테스트를 위해 작업 내에서 로그 출력이나 파일 생성을 추가할 수 있다.

정리

스프링부트 스케줄러는 정기적으로 반복되는 작업을 자동화하는 데 유용하다. 주로 데이터 백업, 이메일 발송, API 호출 등 다양한 작업에 사용된다.
@Secheduled를 이용해 쉽게 구현할 수 있으며, fixedRate, fixedDelay, cron 등 다양한 방식을 지원한다.

추가적으로, 멀티 스레드 환경 설정과 예외 처리를 통해 스케줄링의 안전성을 높일 수 있다.

젼이

신입 개발자 임니당 : > (2025.02.05~)

이전 포스트

Trigger(트리거)란?

다음 포스트

스프링부트 스케줄러(Seheduler)란?