Platform

JavaFX Platform 클래스

주요 메소드 정리

개요

•

패키지: javafx.application.Platform

•

역할:

JavaFX 애플리케이션의 스레드 제어, 종료, UI 작업 예약 등을 관리하는 클래스

(모든 메서드는 static)

JavaFX Application Thread(메인 UI 스레드)에서 실행되는 작업을 제어하기 위해 사용한다.

주요 메소드

1. runLater(Runnable runnable)

•

설명:

지정한 작업을 JavaFX Application Thread에서 나중에 실행하도록 예약한다.

•

용도:

UI가 완전히 초기화된 후에 실행하거나, 백그라운드 스레드에서 UI를 수정할 때 사용.

•

예시:

Platform.runLater(() -> {
    label.setText("UI 변경 완료!");
});
Java
복사

2. exit()

•

설명:

JavaFX 애플리케이션을 종료한다.

내부적으로 모든 윈도우(Stage)를 닫고 Application.stop() 메서드를 호출한다.

•

예시:

Platform.exit();
Java
복사

3. startup(Runnable runnable)

•

설명:

JavaFX 런타임이 아직 시작되지 않은 상태에서 명시적으로 초기화할 때 사용.

(일반적으로 Application.launch() 이전에 JavaFX 기능을 사용하려는 경우)

•

예시:

Platform.startup(() -> {
    System.out.println("JavaFX 런타임 초기화 완료");
});
Java
복사

4. isFxApplicationThread()

•

설명:

현재 코드가 JavaFX Application Thread에서 실행 중인지 확인한다.

•

예시:

if (Platform.isFxApplicationThread()) {
    System.out.println("UI 스레드입니다!");
} else {
    System.out.println("백그라운드 스레드입니다!");
}
Java
복사

5. setImplicitExit(boolean implicitExit)

•

설명:

모든 Stage가 닫혔을 때 자동으로 애플리케이션을 종료할지 여부를 설정한다.

◦

true (기본값): 모든 창이 닫히면 종료

◦

false: 창이 닫혀도 백그라운드 유지

•

예시:

Platform.setImplicitExit(false);
Java
복사

요약 비교표

메소드	주요 기능	사용 시점
runLater()	UI 스레드에서 나중에 실행	UI 초기화 후, 백그라운드 → UI
exit()	애플리케이션 종료	프로그램 종료 버튼 등
startup()	JavaFX 런타임 수동 초기화	비표준 환경, 테스트 환경
isFxApplicationThread()	현재 스레드 확인	디버깅 / 안전성 확인
setImplicitExit()	자동 종료 여부 설정	트레이 앱, 다중 창 앱 등

실무 팁

•

initialize() 안에서 Platform.runLater() 사용하면 UI 준비 후 실행 가능

•

긴 연산(파일 읽기, DB 쿼리)은 Task나 Service에서 처리하고,

결과를 Platform.runLater()로 UI에 반영한다.

•

Platform.exit()는 System.exit(0)보다 안전하게 종료됨 (자원 해제 포함)

예제 코드

Platform.runLater(() -> {
    System.out.println("UI 스레드에서 안전하게 실행!");
});

if (!Platform.isFxApplicationThread()) {
    Platform.runLater(() -> myLabel.setText("UI 변경"));
}

Platform.setImplicitExit(false); // 창 닫혀도 앱 유지
Java
복사

요약

Platform 클래스는 JavaFX 애플리케이션의 “생명주기 제어자”이자

“UI 스레드 보안 관리자” 역할을 한다.

특히 runLater()는 실무에서 가장 많이 쓰이는 메서드로,

모든 UI 업데이트를 안전하게 실행할 수 있게 해준다.