마스토돈(Mastodon)은 탈중앙화된 소셜 네트워크 서비스로, 개발자들에게 친숙한 API 구조를 제공합니다. 이 가이드에서는 Java와 Maven을 사용하여 간단한 마스토돈 자동화 봇을 구축하는 방법과 프로젝트 구조를 살펴봅니다.

1. 프로젝트 디렉토리 구조

표준 Maven 프로젝트 형식을 따르며, 관심사 분리(SoC) 원칙에 따라 패키지를 구성합니다.

mastodon-automation-bot/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── io/github/mastobot/
│   │   │       ├── MastoApp.java           # 메인 엔트리 포인트
│   │   │       ├── SettingsLoader.java     # 설정 관리 클래스
│   │   │       ├── services/
│   │   │       │   └── ApiBridge.java      # Mastodon API 통신 유틸리티
│   │   │       └── listeners/
│   │   │           ├── NotificationWorker.java # 멘션 및 알림 처리
│   │   │           └── PostScheduler.java      # 상태 업데이트 처리
├── resources/
│   └── bot-settings.properties             # 환경 설정 파일
├── pom.xml                                 # 의존성 관리 파일
└── README.md

주요 구성 요소 설명

• io.github.mastobot: 봇의 핵심 비즈니스 로직이 포함된 기본 패키지입니다.
• services/ApiBridge.java: 외부 인스턴스와의 통신을 담당하며 REST API 호출을 캡슐화합니다.
• listeners/: 특정 이벤트(멘션, 타임라인 업데이트 등)가 발생했을 때 실행될 핸들러들을 포함합니다.
• resources/: API 토큰 및 인스턴스 URL과 같은 민감한 정보를 분리하여 관리합니다.

2. 메인 실행 클래스 구현

MastoApp.java는 애플리케이션의 시작점으로, 설정 파일을 로드하고 API 서비스 및 리스너를 초기화하는 역할을 수행합니다.

package io.github.mastobot;

import io.github.mastobot.listeners.NotificationWorker;
import io.github.mastobot.services.ApiBridge;

public class MastoApp {
    public static void main(String[] args) {
        // 1. 환경 설정 로드
        SettingsLoader settings = new SettingsLoader();
        settings.initialize("resources/bot-settings.properties");

        // 2. API 브리지 레이어 초기화
        ApiBridge apiBridge = new ApiBridge(settings);

        // 3. 멘션 감지 서비스 시작
        NotificationWorker worker = new NotificationWorker(apiBridge);
        worker.execute();
        
        System.out.println("Mastodon Bot이 성공적으로 시작되었습니다.");
    }
}

위 코드에서 NotificationWorker는 백그라운드에서 실시간 또는 폴링 방식으로 계정의 알림을 감시하며, 새로운 멘션이 발생할 경우 정의된 로직에 따라 응답을 전송합니다.

3. 환경 설정 파일 구성

인스턴스 주소와 액세스 토큰은 소스 코드에 하드코딩하지 않고 별도의 속성 파일로 관리하는 것이 보안상 안전합니다.

bot-settings.properties

# Mastodon 인스턴스 접속 정보
mastodon.instance.url=https://mastodon.social
mastodon.auth.token=YOUR_ACCESS_TOKEN_HERE

# 봇 동작 설정
bot.log.enabled=true
bot.refresh.interval=30

설정 항목 설명

• mastodon.instance.url: 봇이 접속할 마스토돈 인스턴스의 베이스 주소입니다.
• mastodon.auth.token: 개발자 설정 메뉴에서 발급받은 read, write 권한이 포함된 액세스 토큰입니다.
• bot.refresh.interval: API 호출 간격을 초 단위로 설정하여 인스턴스에 가해지는 부하를 조절합니다.

이러한 모듈화된 구조를 통해 향후 기능 확장 시 코드 수정 범위를 최소화할 수 있으며, 다양한 인스턴스에 대응하는 유연한 봇 개발이 가능합니다.