컨트롤러 생명주기

JavaFX 컨트롤러는 FXMLLoader.load() 시 자동 생성되고, FXML 주입 후 initialize()가 호출된다. 일반 메소드 후, UI 변경은 Platform.runLater()로 안전하게 처리된다.

JavaFX 컨트롤러 생명주기

sequenceDiagram
    participant StageManager
    participant Controller as Controller
    participant FXThread as JavaFX Application Thread

    StageManager->>Controller: new Controller() 생성<br> (FXMLLoader.load())
    FXThread->>Controller: initialize() 호출
    note right of Controller: FXML 로드 후 자동 호출
    StageManager->>Controller: receiveData(data) 호출
    note right of Controller: StageManager가 데이터 전달
    Controller->>FXThread: Platform.runLater(() -> {...}) 등록
    note right of FXThread: UI 업데이트 코드 예약
    FXThread-->>Controller: runLater 내부 코드 실행
    note right of Controller: UI 스레드에서 안전하게 실행됨
Mermaid
복사

단계별 설명

① FXMLLoader.load() 실행

•

StageManager에서 FXMLLoader.load()를 호출하면,

◦

FXML 파일을 해석하면서 <fx:controller>로 지정된 클래스(Controller)의 인스턴스를 자동 생성합니다.

→ 즉, new Controller() 가 내부적으로 실행됨.

•

생성 직후, FXML 내의 UI 컴포넌트(@FXML TextField input 등)가 자동으로 주입됩니다.

② initialize() 자동 호출

•

모든 FXML 요소가 주입된 후,

컨트롤러의 @FXML initialize() 메서드가 자동 호출됩니다.

•

초기화 로직(UI 기본 설정, 리스너 등록 등)을 여기에 작성합니다.

•

아직 StageManager에서 데이터 전달 전이라,

외부 값(receiveData)은 아직 null일 수 있습니다.

③ StageManager.show(fxml, data) → receiveData() 호출

•

StageManager가 화면 전환을 완료한 뒤,

새 컨트롤러가 DataReceiver를 구현하고 있다면 receiveData(data)를 호출합니다.

•

이 단계에서 외부 데이터(예: 로그인 정보, 사용자 이름 등)를 전달받습니다.

④ Platform.runLater() 호출

•

receiveData() 안에서 UI 요소를 변경하려면

JavaFX UI Thread에서 안전하게 실행되어야 합니다.

•

Platform.runLater(() -> {...}) 를 사용하면

전달된 코드 블록이 JavaFX Application Thread 큐에 등록되어,

다음 UI 프레임 시점에 안전하게 실행됩니다.

⑤ runLater 내부 코드 실행

•

JavaFX Application Thread가 등록된 작업을 실행합니다.

•

이때 TextField.setText() 등 UI 변경이 발생해도 안전합니다.

•

화면이 최종 갱신됩니다.

핵심 요약

순서	단계	실행 스레드	설명
1	Controller 생성 (FXMLLoader.load())	JavaFX Application Thread	FXML 로드 시 자동 생성
2	initialize()	JavaFX Application Thread	UI 구성요소 초기화
3	receiveData()	JavaFX Application Thread	StageManager에서 데이터 전달
4	Platform.runLater() 등록	JavaFX Application Thread	UI 변경 코드 예약
5	runLater 실행	JavaFX Application Thread	UI 안전하게 갱신