Quartz Scheduling

<aside> 💙 해당 페이지는 데스트톱 전체화면에 맞게 구성되어 있습니다. 노션 어플리케이션의 경우, 상단의 **페이지로 열기**를 통해 확인해주세요. 웹사이트의 경우, **창 최대화**를 통해 확인해주세요.

</aside>

<aside> 🖱️ 첨부된 자료는 클릭 또는 오른쪽 상단의 원본 보기 클릭 시, 더 크게 보실 수 있습니다.

</aside>

< 목차 >

⏪ 포트폴리오로

[ 기능 요구 사항 ]

요구사항
- 각 크루의 납입일마다
  - ‘내 알림(MyAlert)’ 테이블에 납입일 알림 DB를 추가한다.
  - 크루의 선원들의 의무납입횟수를 +1 증가시킨다.
- 매월 1일마다
  - 크루 일정에 각 크루의 납입일 일정을 추가한다.
- 항해 중단을 신청한 일자로부터 3일 뒤에
  - 크루에 대한 데이터를 모두 삭제한다.
기술 선택 시의 고려사항
- 애플리케이션 내에는 다양한 크루가 있고, 각 크루마다 납입일이 다른 상황이다.
- 크루의 납입일은 사용자에 의해 언제든지 변경될 수 있으며,
  
  납입일이 변경되면 해당 변경사항에 따라 해당 크루의 납입일에 맞추어 스케줄링된 작업이 업데이트 되어야한다.
- 크루의 추가, 삭제와 같은 변경사항도 스케줄링에 동적으로 반영되어야 한다.

[ Quartz 사용 이유 ]

Spring 에서 기본적으로 제공하는 @Scheduled의 한계
1. 정적 스케줄링
  - **@Scheduled**는 애플리케이션 시작 시에 정의된 스케줄만 실행할 수 있다. 런타임 중에 기존에 등록된 스케줄을 동적으로 변경하는 것은 꽤 복잡하고 제한적이었다.
    - 애플리케이션이 실행되고 있을 때 어떤 크루가 항해 중단을 신청하면, 그 크루의 데이터를 삭제하는 스케줄을 애플리케이션을 중단하지 않고 추가해야 한다.
    - 애플리케이션이 실행되고 있을 때 새로운 크루가 만들어지면, 그 크루의 납입일에 해당하는 스케줄링을 애플리케이션을 중단하지 않고 추가해야한다.
2. 메모리 기반 저장
  - 스케줄 상태를 메모리에 저장하는 방식이기 때문에, 애플리케이션이 재시작되는 경우 스케줄링된 작업이 사라질 수 있다.
Quartz Scheduler의 장점
1. 동적 스케줄 관리
  - Quartz는 Job 및 Trigger를 사용하여 스케줄링을 관리할 수 있다. 이를 활용하여 크루의 납입일 변경 시, 이전 납입일에 대한 작업을 삭제하고 새로운 납입일에 대한 작업을 추가하는 등의 방식으로 구현한다면 좋을 것이라고 판단했다.
  - Quartz는 애플리케이션 실행 중에도 간편하게 새로운 Job을 추가하거나, 기존 Job을 수정, 삭제할 수 있었다. 그렇기에, 고려사항을 염두한 채 스케줄링 작업을 하기에 적합하다고 판단했다.
2. DB를 통한 스케줄링 관리
  - Quartz는 작업과 트리거의 상태를 데이터베이스에 저장하므로, 애플리케이션이 재시작 되더라도 스케줄링된 작업이 유지된다.
    - 유지보수 및 애플리케이션 업데이트에 있어서 더욱 원활한 작업이 가능할 것이라고 생각했다.
    - 전원 장애 및 서버 오류 등으로 애플리케이션이 중단되더라도, 재시작 후에 스케줄링에 대해 일관된 상태를 유지할 수 있다는 장점이 있다고 생각했다.

⏫ 위로

[ 구성 1 - CrewPaydateJob ]

각 크루의 납입일마다 실행되는 JOB 입니다.

[ JOB ]

My Alert 테이블에 납입일 알림을 추가합니다.
크루 내 각 회원들의 의무납입횟수를 +1 합니다.

CrewPaydateJob.pdf

[ Scheduler에 Job이 추가되는 시점 ]

PassbookController / passbook_ok()

크루가 생성될 때 해당 크루의 납입일에 맞춰 해당 Job을 실행하는 스케줄이 추가됩니다.
- 코드 보기
CrewSettingController / updateCrewInfo()

크루의 납입일이 수정될 때, 기존에 등록되어있던 스케줄이 제거되고, 수정된 납입일에 맞춘 새로운 cron식을 가진 스케줄이 추가됩니다.
- 코드 보기
CrewSettingController / cancelSailingStop()

항해 중단 신청을 취소했을 때, 해당 Job을 실행하는 스케줄이 다시 추가됩니다.
- 코드 보기