Java Swing JFileChooser完全ガイド：ファイル選択ダイアログをマスターしよう

サンプルコード：ファイルを開く

以下のコードは、ボタンをクリックするとファイル選択ダイアログを開き、選択されたファイルの絶対パスをコンソールに出力する簡単な例です。

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

public class OpenFileDialogExample {
    public static void main(String[] args) {
        // Swingコンポーネントはイベントディスパッチスレッドで作成・更新するのが安全
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("JFileChooser Open Dialog Example");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(400, 200);
            frame.setLayout(new java.awt.FlowLayout());

            JButton openButton = new JButton("ファイルを開く");
            JLabel label = new JLabel("選択されたファイル: ");

            openButton.addActionListener(new ActionListener() {
                @Override
                public void actionPerformed(ActionEvent e) {
                    // JFileChooserのインスタンスを作成
                    JFileChooser fileChooser = new JFileChooser();

                    // ダイアログを表示し、戻り値を取得
                    // 引数には親コンポーネントを指定
                    int selected = fileChooser.showOpenDialog(frame);

                    // 「開く」ボタンが押された場合の処理
                    if (selected == JFileChooser.APPROVE_OPTION) {
                        // 選択されたファイルを取得
                        File file = fileChooser.getSelectedFile();
                        label.setText("選択されたファイル: " + file.getAbsolutePath());
                        System.out.println("選択されたファイル: " + file.getAbsolutePath());
                    } else {
                        label.setText("ファイル選択がキャンセルされました");
                        System.out.println("キャンセルされました");
                    }
                }
            });

            frame.add(openButton);
            frame.add(label);
            frame.setLocationRelativeTo(null); // 画面中央に表示
            frame.setVisible(true);
        });
    }
}
        

サンプルコード：ファイルを保存する

以下のコードは、「保存」ダイアログを表示し、ユーザーが入力したファイルパスをコンソールに出力します。

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

public class SaveFileDialogExample {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("JFileChooser Save Dialog Example");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(400, 200);
            frame.setLayout(new java.awt.FlowLayout());

            JButton saveButton = new JButton("ファイルを保存");
            JLabel label = new JLabel("保存パス: ");

            saveButton.addActionListener(new ActionListener() {
                @Override
                public void actionPerformed(ActionEvent e) {
                    JFileChooser fileChooser = new JFileChooser();

                    // 「保存」ダイアログを表示
                    int selected = fileChooser.showSaveDialog(frame);

                    if (selected == JFileChooser.APPROVE_OPTION) {
                        File file = fileChooser.getSelectedFile();
                        label.setText("保存パス: " + file.getAbsolutePath());
                        System.out.println("保存パス: " + file.getAbsolutePath());
                        // ここに実際にファイルを保存するロジックを記述する
                    } else {
                        label.setText("保存がキャンセルされました");
                        System.out.println("キャンセルされました");
                    }
                }
            });

            frame.add(saveButton);
            frame.add(label);
            frame.setLocationRelativeTo(null);
            frame.setVisible(true);
        });
    }
}
        

サンプルコード：カスタマイズされたJFileChooser

これらのカスタマイズを組み合わせた例を見てみましょう。

// ... ( ActionListener内などの処理 )
JFileChooser fileChooser = new JFileChooser();

// 1. ダイアログのタイトルを設定
fileChooser.setDialogTitle("画像ファイルを選択してください");

// 2. 初期ディレクトリをユーザーのホームディレクトリに設定
fileChooser.setCurrentDirectory(new File(System.getProperty("user.home")));

// 3. ディレクトリのみ選択可能に設定
fileChooser.setFileSelectionMode(JFileChooser.DIRECTORIES_ONLY);

// 4. 複数選択を有効化
fileChooser.setMultiSelectionEnabled(true);

// 5. 「すべてのファイル」フィルタを無効化
fileChooser.setAcceptAllFileFilterUsed(false);

int selected = fileChooser.showOpenDialog(frame);

if (selected == JFileChooser.APPROVE_OPTION) {
    // 複数選択が有効なので getSelectedFiles() を使用
    File[] files = fileChooser.getSelectedFiles();
    System.out.println(files.length + "個のディレクトリが選択されました:");
    for (File file : files) {
        System.out.println(file.getAbsolutePath());
    }
}
        

サンプルコード：画像ファイルフィルタ

JPEGとPNGファイルのみを表示するフィルタを作成し、適用する例です。

// ... ( ActionListener内などの処理 )
JFileChooser fileChooser = new JFileChooser();
fileChooser.setDialogTitle("画像ファイルを開く");

// 拡張子フィルタを作成
// 説明: "イメージファイル", 拡張子: "jpg", "jpeg", "png", "gif"
FileNameExtensionFilter imageFilter = new FileNameExtensionFilter(
    "イメージファイル (*.jpg, *.jpeg, *.png, *.gif)", "jpg", "jpeg", "png", "gif");

// テキストファイル用のフィルタも作成
FileNameExtensionFilter textFilter = new FileNameExtensionFilter(
    "テキストファイル (*.txt)", "txt");

// フィルタをJFileChooserに追加
fileChooser.addChoosableFileFilter(imageFilter);
fileChooser.addChoosableFileFilter(textFilter);

// デフォルトで表示するフィルタを画像フィルタに設定
fileChooser.setFileFilter(imageFilter);

// 「すべてのファイル」フィルタを非表示にして、指定したフィルタのみを使わせる
fileChooser.setAcceptAllFileFilterUsed(false);


int selected = fileChooser.showOpenDialog(frame);

if (selected == JFileChooser.APPROVE_OPTION) {
    File file = fileChooser.getSelectedFile();
    System.out.println("選択された画像ファイル: " + file.getName());
}
        

サンプルコード：特定のプレフィックスを持つファイルフィルタ

ファイル名が “log_” で始まり、拡張子が “.dat” であるファイルのみを表示するカスタムフィルタの例です。

import javax.swing.filechooser.FileFilter;
import java.io.File;

// FileFilterを継承したカスタムフィルタクラス
class CustomLogFileFilter extends FileFilter {

    @Override
    public boolean accept(File f) {
        // ディレクトリは常に表示する
        if (f.isDirectory()) {
            return true;
        }
        
        // ファイル名が "log_" で始まり、".dat" で終わるかチェック
        String fileName = f.getName().toLowerCase();
        return fileName.startsWith("log_") && fileName.endsWith(".dat");
    }

    @Override
    public String getDescription() {
        return "ログデータファイル (log_*.dat)";
    }
}

// --- JFileChooserへの適用部分 ---
// JFileChooser fileChooser = new JFileChooser();
// fileChooser.setFileFilter(new CustomLogFileFilter());
        

サンプルコード：画像プレビュー

選択された画像ファイルをプレビュー表示するアクセサリコンポーネントの実装例です。

import javax.swing.*;
import java.awt.*;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.io.File;

// 画像プレビュー用のアクセサリコンポーネント
class ImagePreviewAccessory extends JComponent implements PropertyChangeListener {
    private JLabel previewLabel;
    private File file = null;
    private static final int PREVIEW_WIDTH = 200;
    private static final int PREVIEW_HEIGHT = 200;

    public ImagePreviewAccessory(JFileChooser chooser) {
        // JFileChooserのプロパティ変更をリッスンする
        chooser.addPropertyChangeListener(this);
        setPreferredSize(new Dimension(PREVIEW_WIDTH, PREVIEW_HEIGHT));

        previewLabel = new JLabel();
        previewLabel.setHorizontalAlignment(JLabel.CENTER);
        previewLabel.setVerticalAlignment(JLabel.CENTER);
        setLayout(new BorderLayout());
        add(previewLabel, BorderLayout.CENTER);
        setBorder(BorderFactory.createTitledBorder("プレビュー"));
    }

    // 選択ファイルが変更されたときに呼び出される
    @Override
    public void propertyChange(PropertyChangeEvent evt) {
        String propName = evt.getPropertyName();

        if (JFileChooser.SELECTED_FILE_CHANGED_PROPERTY.equals(propName)) {
            file = (File) evt.getNewValue();
            if (isShowing()) {
                updatePreview();
            }
        }
    }
    
    // プレビューを更新するメソッド
    private void updatePreview() {
        if (file == null) {
            previewLabel.setIcon(null);
            previewLabel.setText("ファイルが選択されていません");
            return;
        }

        // ファイル名を取得し、画像ファイルか簡易的に判定
        String fileName = file.getName().toLowerCase();
        if (!fileName.endsWith(".jpg") && !fileName.endsWith(".jpeg") && !fileName.endsWith(".png") && !fileName.endsWith(".gif")) {
            previewLabel.setIcon(null);
            previewLabel.setText("プレビュー非対応");
            return;
        }

        // アイコンを読み込み、リサイズしてラベルに設定
        ImageIcon icon = new ImageIcon(file.getPath());
        if (icon.getIconWidth() > PREVIEW_WIDTH || icon.getIconHeight() > PREVIEW_HEIGHT) {
            Image img = icon.getImage().getScaledInstance(PREVIEW_WIDTH, -1, Image.SCALE_SMOOTH);
            icon = new ImageIcon(img);
        }
        previewLabel.setIcon(icon);
        previewLabel.setText(null); // テキストをクリア
    }

    @Override
    public void addNotify() {
        super.addNotify();
        updatePreview();
    }
}

// --- JFileChooserへの適用部分 ---
// JFileChooser fileChooser = new JFileChooser();
// ImagePreviewAccessory preview = new ImagePreviewAccessory(fileChooser);
// fileChooser.setAccessory(preview);
        

サンプルコード：上書き確認処理

// ... (showSaveDialogの後、APPROVE_OPTIONが返された場合)
File fileToSave = fileChooser.getSelectedFile();

// 拡張子がついていない場合、デフォルトの拡張子を付与するなどの処理もここで行うと良い
// 例: if (!fileToSave.getName().contains(".")) {
//         fileToSave = new File(fileToSave.getParentFile(), fileToSave.getName() + ".txt");
//     }

// ファイルが既に存在するかチェック
if (fileToSave.exists()) {
    int response = JOptionPane.showConfirmDialog(
        frame, // 親コンポーネント
        "ファイルは既に存在します。上書きしますか？", // メッセージ
        "上書きの確認", // タイトル
        JOptionPane.YES_NO_OPTION, // ボタンの種類
        JOptionPane.WARNING_MESSAGE // メッセージの種類
    );
    if (response != JOptionPane.YES_OPTION) {
        // 「いいえ」が選択された場合は処理を中断
        System.out.println("保存処理がユーザーによって中断されました。");
        return; 
    }
}

// ここで実際にファイルを書き込む処理を実行する
System.out.println("ファイルを保存します: " + fileToSave.getAbsolutePath());
// try-with-resources などでファイル書き込み...
        

サンプルコード：システムのLook & Feelを設定

mainメソッドの最初にこの処理を追加します。

public static void main(String[] args) {
    try {
        // OSネイティブのルックアンドフィールに設定
        UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
    } catch (ClassNotFoundException | InstantiationException | IllegalAccessException | UnsupportedLookAndFeelException e) {
        e.printStackTrace();
    }

    // この後にSwingUtilities.invokeLater()でGUIを起動する
    SwingUtilities.invokeLater(() -> {
        // ... GUIの構築処理
    });
}