Controller

JavaFX에서 FXML로 설계된 UI와 Java 코드(로직)를 연결하는 역할을 하는 클래스입니다.

사용자의 입력(버튼 클릭, 텍스트 입력 등)을 처리하고, UI 요소를 동적으로 변경하는 기능을 담당합니다.

이벤트 처리

JavaFX 컨트롤러는 UI에서 발생하는 이벤트(버튼 클릭, 키 입력 등)를 감지하고 처리합니다.

주요 이벤트 종류

이벤트 타입	설명
onAction	버튼 클릭, 메뉴 선택 등의 액션 처리
onMouseClicked	마우스 클릭 이벤트
onKeyPressed	키보드 입력 감지
onMouseEntered	마우스가 컨트롤에 들어왔을 때
onMouseExited	마우스가 컨트롤을 떠날 때

FXML에서 Controller 지정하는 방법

FXML에서 특정 Java 클래스가 컨트롤러 역할을 하도록 지정하려면 fx:controller 속성을 사용합니다.

레이아웃 요소에 fx:controller 속성을 작성

fx:controller 속성 값으로 컨트롤러 클래스를 지정 

<Layout fx:controller="application.MainController"></Layout>
Java
복사

FXML에서 Controller 지정

<?xml version="1.0" encoding="UTF-8"?>
<VBox xmlns="http://javafx.com/javafx/8" xmlns:fx="http://javafx.com/fxml/1"
      fx:controller="com.example.MyController">
    <Label fx:id="label" text="Hello, JavaFX!"/>
    <Button text="클릭" onAction="#handleButtonClick"/>
</VBox>
XML
복사

fx:controller="com.example.MyController"

→ com.example.MyController 클래스가 이 FXML의 컨트롤러 역할을 함.

Controller에서 이벤트와 메소드 연결하는 방법

FXML 파일에서 특정 컨트롤러를 지정한 뒤, 컨트롤 요소의 이벤트 속성에 메소드를 #method 형태로 지정하고, @FXML 어노테이션을 연결될 메소드에 붙여준다.

FXML 레이아웃 요소에 컨트롤러 지정

특정 컨트롤 요소에 이벤트 속성에 #method 형태로 메소드명 지정

메소드에 @FXML  어노테이션 지정

FXML 레이아웃 요소에 컨트롤러 지정

<Layout fx:controller="application.MainController"></Layout>
Java
복사

컨트롤 요소 메소드 지정

<Button onAction="#clickButton">버튼</Button>
Java
복사

메소드에 @FXML 어노테이션 지정

@FXML
public void clickButton(ActionEvent event) throws IOException {
		System.out.println("버튼 클릭!");
}
Java
복사

@FXML을 사용하여 FXML의 UI 요소를 Java 객체 선언

package com.example;

import javafx.fxml.FXML;
import javafx.scene.control.Button;
import javafx.scene.control.Label;

public class MyController {

    @FXML private Label label;  // FXML에서 fx:id="label"인 요소 가져오기
    @FXML private Button button; // 버튼 가져오기

    @FXML
    private void handleButtonClick() {  // 버튼 클릭 이벤트 핸들러
        label.setText("버튼이 클릭되었습니다!");
    }
}
Java
복사

@FXML을 사용하여 FXML에서 선언된 요소를 Java 코드에서 접근 가능하게 함.

handleButtonClick() 메서드는 FXML 버튼의 onAction="#handleButtonClick"과 연결됨.

예제 코드

(1) 로그인 화면 (login.fxml + LoginController.java)

[FXML - login.fxml]

<?xml version="1.0" encoding="UTF-8"?>
<VBox xmlns="http://javafx.com/javafx/8" xmlns:fx="http://javafx.com/fxml/1"
      fx:controller="com.example.LoginController" alignment="CENTER" spacing="10">
    <Label text="로그인"/>
    <TextField fx:id="usernameField" promptText="아이디 입력"/>
    <PasswordField fx:id="passwordField" promptText="비밀번호 입력"/>
    <Button text="로그인" onAction="#handleLogin"/>
    <Label fx:id="messageLabel" text="" style="-fx-text-fill: red;"/>
</VBox>
XML
복사

[Controller - LoginController.java]

package com.example;

import javafx.fxml.FXML;
import javafx.scene.control.Label;
import javafx.scene.control.PasswordField;
import javafx.scene.control.TextField;

public class LoginController {

    @FXML private TextField usernameField;
    @FXML private PasswordField passwordField;
    @FXML private Label messageLabel;

    @FXML
    private void handleLogin() {
        String username = usernameField.getText();
        String password = passwordField.getText();

        if ("admin".equals(username) && "1234".equals(password)) {
            messageLabel.setText("로그인 성공!");
            messageLabel.setStyle("-fx-text-fill: green;");
        } else {
            messageLabel.setText("아이디 또는 비밀번호가 틀렸습니다.");
        }
    }
}
Java
복사

 로그인 버튼을 클릭하면 handleLogin() 실행 → 아이디, 비밀번호 검증 후 메시지 출력.

(2) 게시판 목록 (board.fxml + BoardController.java)

[FXML - board.fxml]

<?xml version="1.0" encoding="UTF-8"?>
<BorderPane xmlns="http://javafx.com/javafx/8" xmlns:fx="http://javafx.com/fxml/1"
            fx:controller="com.example.BoardController">
    <top>
        <Label text="게시판 목록" style="-fx-font-size: 16px;"/>
    </top>
    <center>
        <TableView fx:id="boardTable">
            <columns>
                <TableColumn text="번호" fx:id="colId"/>
                <TableColumn text="제목" fx:id="colTitle"/>
                <TableColumn text="작성자" fx:id="colAuthor"/>
                <TableColumn text="날짜" fx:id="colDate"/>
            </columns>
        </TableView>
    </center>
    <bottom>
        <HBox alignment="CENTER" spacing="10">
            <Button text="새 글 작성" onAction="#handleNewPost"/>
        </HBox>
    </bottom>
</BorderPane>
XML
복사

[Controller - BoardController.java]

package com.example;

import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.fxml.FXML;
import javafx.scene.control.TableColumn;
import javafx.scene.control.TableView;
import javafx.scene.control.Button;
import javafx.scene.control.cell.PropertyValueFactory;

public class BoardController {

    @FXML private TableView<Post> boardTable;
    @FXML private TableColumn<Post, Integer> colId;
    @FXML private TableColumn<Post, String> colTitle;
    @FXML private TableColumn<Post, String> colAuthor;
    @FXML private TableColumn<Post, String> colDate;
    @FXML private Button newPostButton;

    private final ObservableList<Post> posts = FXCollections.observableArrayList();

    @FXML
    private void initialize() {
        colId.setCellValueFactory(new PropertyValueFactory<>("id"));
        colTitle.setCellValueFactory(new PropertyValueFactory<>("title"));
        colAuthor.setCellValueFactory(new PropertyValueFactory<>("author"));
        colDate.setCellValueFactory(new PropertyValueFactory<>("date"));

        boardTable.setItems(posts);
    }

    @FXML
    private void handleNewPost() {
        posts.add(new Post(posts.size() + 1, "새로운 게시글", "관리자", "2025-04-03"));
    }
}
Java
복사

[Post.java (데이터 모델 클래스)]

package com.example;

public class Post {
    private final int id;
    private final String title;
    private final String author;
    private final String date;

    public Post(int id, String title, String author, String date) {
        this.id = id;
        this.title = title;
        this.author = author;
        this.date = date;
    }

    public int getId() { return id; }
    public String getTitle() { return title; }
    public String getAuthor() { return author; }
    public String getDate() { return date; }
}
Java
복사

 initialize()에서 TableView 컬럼을 설정하고 데이터 리스트를 초기화.

handleNewPost() 버튼 클릭 시 새로운 게시글 추가.

정리

•

FXML에서 fx:controller 속성으로 Java 컨트롤러를 연결.

•

@FXML을 이용해 UI 요소를 Java 코드에서 제어.

•

버튼 클릭 등의 이벤트를 Java 메서드(onAction="#methodName")와 연결.

•

initialize() 메서드를 사용해 초기 UI 설정.

이제 JavaFX의 MVC 구조에서 FXML과 컨트롤러를 활용하여 UI와 로직을 분리할 수 있습니다!