Javaで作るGUIアプリケーション入門

はじめに (対象読者・この記事でわかること)

この記事は、Javaの基本的な文法を理解している方、特にデスクトップアプリケーション開発に興味がある方を対象としています。この記事を読むことで、JavaのSwingとJavaFXを使って基本的なGUIアプリケーションを作成できるようになります。また、イベント処理の方法やレイアウトの設定といった重要な概念についても理解を深めることができます。近年ではWebアプリケーションが主流ですが、デスクトップアプリケーションも依然として需要があり、Javaはクロスプラットフォームで動作するため、マルチOS対応のアプリケーション開発に適しています。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。前提となる知識1: Javaの基本的な文法（クラス、メソッド、変数など）前提となる知識2: オブジェクト指向プログラミングの基本的な概念

Java GUIライブラリの概要と選択理由

JavaでGUIアプリケーションを開発する場合、主に2つのライブラリが利用されます。一つは古くから使われているSwing、もう一つは比較的新しいJavaFXです。SwingはJava標準のGUIライブラリとして長年利用されており、多くのアプリケーションで実績があります。一方、JavaFXはリッチなユーザーインターフェースを提供し、アニメーションやCSSによるスタイリングが可能です。近年ではJavaFXが推奨される傾向にありますが、Swingは依然として広く利用されています。

GUIアプリケーション開発では、ユーザーインターフェースの設計とイベント処理が重要になります。これらの概念を理解することで、ユーザーにとって使いやすいアプリケーションを開発できるようになります。また、JavaのGUI開発ではスレッドの扱いに注意が必要で、UIの更新は専用のスレッドで行う必要があります。この記事では、これらの重要なポイントを押さえながら、実際のコード例を交えて解説します。

SwingとJavaFXによるGUIアプリケーションの実装

Swingによる基本的なGUIアプリケーションの作成

まずはSwingを使った簡単なGUIアプリケーションを作成してみましょう。以下は、ウィンドウとボタンを表示する基本的なコードです。

Java

import javax.swing.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class SimpleSwingApp {
    public static void main(String[] args) {
        // JFrameの作成
        JFrame frame = new JFrame("Swingアプリケーション");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(300, 200);

        // JButtonの作成
        JButton button = new JButton("クリックしてください");

        // ボタンにアクションリスナーを追加
        button.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                JOptionPane.showMessageDialog(frame, "ボタンがクリックされました！");
            }
        });

        // ボタンをフレームに追加
        frame.getContentPane().add(button);

        // フレームを表示
        frame.setVisible(true);
    }
}

このコードを実行すると、ウィンドウ内にボタンが表示され、ボタンをクリックするとメッセージボックスが表示されます。Swingの基本的なコンポーネントは、JFrame（ウィンドウ）、JButton（ボタン）、JLabel（ラベル）、JTextField（テキストフィールド）などがあります。

JavaFXによるGUIアプリケーションの作成

次に、JavaFXを使ったGUIアプリケーションを作成します。JavaFXはSwingとは異なり、FXMLというXMLベースのファイルでUIを定義することもできます。ここでは、JavaのコードだけでUIを作成する方法を紹介します。

Java

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class SimpleJavaFXApp extends Application {
    @Override
    public void start(Stage primaryStage) {
        // ボタンの作成
        Button button = new Button("クリックしてください");

        // ボタンのアクションイベントハンドラ
        button.setOnAction(e -> {
            System.out.println("ボタンがクリックされました！");
        });

        // StackPaneにボタンを追加
        StackPane root = new StackPane();
        root.getChildren().add(button);

        // シーンの作成
        Scene scene = new Scene(root, 300, 200);

        // ステージにシーンを設定
        primaryStage.setTitle("JavaFXアプリケーション");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

このコードを実行すると、Swingの例と同様にウィンドウ内にボタンが表示されます。JavaFXでは、ステージ（Stage）とシーン（Scene）の概念が重要です。ステージはウィンドウそのものを表し、シーンはステージ上に表示されるコンテンツを表します。

レイアウトの設定方法

GUIアプリケーションでは、コンポーネントの配置方法（レイアウト）が重要です。SwingとJavaFXでは、それぞれ異なるレイアウトマネージャーが提供されています。

Swingの主なレイアウトマネージャー

BorderLayout: 東西南北と中央にコンポーネントを配置
FlowLayout: コンポーネントを左から右へ順に配置
GridLayout: グリッド状にコンポーネントを配置
BoxLayout: 指定された方向にコンポーネントを配置

以下は、Swingで複数のボタンをFlowLayoutで配置する例です。

Java

import javax.swing.*;
import java.awt.*;

public class LayoutExample {
    public static void main(String[] args) {
        JFrame frame = new JFrame("レイアウトの例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(400, 200);

        // FlowLayoutを使用
        frame.setLayout(new FlowLayout());

        // 複数のボタンを追加
        for (int i = 1; i <= 5; i++) {
            JButton button = new JButton("ボタン" + i);
            button.addActionListener(e -> 
                JOptionPane.showMessageDialog(frame, e.getActionCommand() + "がクリックされました！")
            );
            frame.add(button);
        }

        frame.setVisible(true);
    }
}

JavaFXの主なレイアウト

BorderPane: 上下左右と中央にコンポーネントを配置
HBox: 水平方向にコンポーネントを配置
VBox: 垂直方向にコンポーネントを配置
GridPane: グリッド状にコンポーネントを配置
StackPane: コンポーネントを重ねて配置

JavaFXでHBoxとVBoxを使った例は以下の通りです。

Java

import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.HBox;
import javafx.scene.layout.VBox;
import javafx.stage.Stage;

public class LayoutExampleJavaFX extends Application {
    @Override
    public void start(Stage primaryStage) {
        // HBoxの作成
        HBox hbox = new HBox(10); // 10pxの間隔
        hbox.setPadding(new Insets(15, 12, 15, 12));

        // ボタンの作成
        Button button1 = new Button("ボタン1");
        Button button2 = new Button("ボタン2");
        Button button3 = new Button("ボタン3");

        // ボタンをHBoxに追加
        hbox.getChildren().addAll(button1, button2, button3);

        // VBoxの作成
        VBox vbox = new VBox(10); // 10pxの間隔
        vbox.setPadding(new Insets(15, 12, 15, 12));

        // 別のボタンの作成
        Button button4 = new Button("ボタン4");
        Button button5 = new Button("ボタン5");

        // ボタンをVBoxに追加
        vbox.getChildren().addAll(hbox, button4, button5);

        // シーンの作成
        Scene scene = new Scene(vbox, 300, 200);

        // ステージにシーンを設定
        primaryStage.setTitle("レイアウトの例");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

イベント処理の実装方法

GUIアプリケーションでは、ユーザーの操作（ボタンのクリック、マウスの移動など）に応じて処理を実行するイベント処理が重要です。SwingとJavaFXでは、イベント処理の方法が異なります。

Swingのイベント処理

ActionListener: ボタンのクリックなどのアクションイベントを処理
MouseListener: マウスのクリック、移動、ドラッグなどのイベントを処理
KeyListener: キーボードのキー入力イベントを処理

以下は、Swingで複数のイベントリスナーを使った例です。

Java

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

public class EventHandlingExample {
    public static void main(String[] args) {
        JFrame frame = new JFrame("イベント処理の例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(400, 300);

        // ボタンの作成
        JButton button = new JButton("マウスを上に移動させてください");

        // ActionListenerの追加
        button.addActionListener(e -> System.out.println("ボタンがクリックされました！"));

        // MouseListenerの追加
        button.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseEntered(MouseEvent e) {
                System.out.println("マウスがボタンの上に入りました！");
            }

            @Override
            public void mouseExited(MouseEvent e) {
                System.out.println("マウスがボタンの外に出ました！");
            }
        });

        // KeyListenerの追加（ボタンにフォーカスがある場合）
        button.addKeyListener(new KeyAdapter() {
            @Override
            public void keyPressed(KeyEvent e) {
                System.out.println("キーが押されました: " + e.getKeyChar());
            }
        });

        // フレームにボタンを追加
        frame.getContentPane().add(button, BorderLayout.CENTER);

        // フレームを表示
        frame.setVisible(true);
    }
}

JavaFXのイベント処理

setOnAction: ボタンのクリックなどのアクションイベントを処理
setOnMouseEntered: マウスがコンポーネント上に入ったときのイベントを処理
setOnKeyPressed: キーボードのキーが押されたときのイベントを処理

JavaFXでイベント処理を行う例は以下の通りです。

Java

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.input.KeyEvent;
import javafx.scene.input.MouseEvent;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class EventHandlingExampleJavaFX extends Application {
    @Override
    public void start(Stage primaryStage) {
        // ボタンの作成
        Button button = new Button("イベントをテスト");

        // アクションイベントの処理
        button.setOnAction(e -> System.out.println("ボタンがクリックされました！"));

        // マウスイベントの処理
        button.setOnMouseEntered(e -> System.out.println("マウスがボタンの上に入りました！"));
        button.setOnMouseExited(e -> System.out.println("マウスがボタンの外に出ました！"));

        // キーイベントの処理
        button.setOnKeyPressed(e -> System.out.println("キーが押されました: " + e.getCode()));

        // StackPaneにボタンを追加
        StackPane root = new StackPane();
        root.getChildren().add(button);

        // シーンの作成
        Scene scene = new Scene(root, 300, 200);

        // ステージにシーンを設定
        primaryStage.setTitle("イベント処理の例");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

実装中によく遭遇する問題と解決策

SwingのEvent Dispatch Thread (EDT)に関する問題

Swingでは、UIの更新はEDTで行う必要があります。重い処理をEDTで実行すると、アプリケーションが応答しなくなります。解決策として、SwingWorkerを使用して重い処理を別のスレッドで実行します。

Java

SwingWorker<Void, String> worker = new SwingWorker<Void, String>() {
    @Override
    protected Void doInBackground() throws Exception {
        // 重い処理
        for (int i = 0; i < 100; i++) {
            publish("進捗: " + i + "%");
            Thread.sleep(100);
        }
        return null;
    }

    @Override
    protected void process(java.util.List<String> chunks) {
        // UIの更新
        for (String message : chunks) {
            textArea.append(message + "\n");
        }
    }

    @Override
    protected void done() {
        // 処理完了後の処理
        button.setEnabled(true);
    }
};

button.setEnabled(false);
worker.execute();

JavaFXのスレッドに関する問題

JavaFXでは、UIの更新はJavaFX Application Threadで行う必要があります。Platform.runLater()を使用して、UIの更新をスケジュールします。

Java

// 別のスレッドで重い処理を実行
new Thread(() -> {
    for (int i = 0; i < 100; i++) {
        final int progress = i;
        // UIの更新をJavaFX Application Threadで実行
        Platform.runLater(() -> {
            progressBar.setProgress(progress / 100.0);
            label.setText("進捗: " + progress + "%");
        });

        try {
            Thread.sleep(100);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }
}).start();

JavaFXのモジュールシステムに関する問題

Java 9以降ではモジュールシステムが導入され、JavaFXアプリケーションを実行する際にモジュールパスの設定が必要になる場合があります。--module-pathオプションを使用してJavaFXのモジュールパスを指定してください。

java --module-path /path/to/javafx/lib --add-modules javafx.controls,javafx.fxml -jar yourapp.jar

まとめ

本記事では、JavaのSwingとJavaFXを使ったGUIアプリケーション開発の基礎から実践までを解説しました。まずは基本的なウィンドウとボタンの作成方法を学び、次にレイアウトの設定方法、そしてイベント処理の実装方法について説明しました。GUIアプリケーション開発では、ユーザーインターフェースの設計とイベント処理が重要です。これらの概念を理解することで、ユーザーにとって使いやすいアプリケーションを開発できるようになります。SwingとJavaFXの両方を理解しておくと、プロジェクトの要件に応じて適切なライブラリを選択できます。今後は、より高度なGUIコンポーネントの使い方や、データバインディングといった発展的な内容についても解説する予定です。

Javaで作るGUIアプリケーション入門💻