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の構築処理 });
}