はじめに：なぜ今、javax.swing.textを学ぶのか？

Java Swingは、1998年にJava 1.2（当時はJ2SE 1.2）の一部として登場して以来、長年にわたりJavaデスクトップアプリケーション開発の標準的なGUIツールキットとして利用されてきました。現在ではJavaFXのような、よりモダンなUIフレームワークに主役の座を譲りつつありますが、世界中には今なおSwingで構築され、現役で稼働している業務アプリケーションやツールが数多く存在します。

これらの既存アプリケーションを保守・改修する上で、Swingの知識は不可欠です。特に、ユーザーとのインタラクションの要となるテキスト処理は、アプリケーションの品質を左右する重要な要素です。javax.swing.textパッケージは、このテキスト処理のすべてを司る、強力かつ柔軟なフレームワークを提供します。

一見すると、JTextFieldやJTextAreaをフォームに配置するだけの単純な作業に思えるかもしれません。しかし、その背後では、javax.swing.textパッケージが提供する洗練されたアーキテクチャが動いています。このアーキテクチャを理解することで、単なるテキスト表示に留まらない、以下のような高度な機能を実現できます。

• 構文ハイライト機能を持つコードエディタ
• WYSIWYG（What You See Is What You Get）形式のリッチテキストエディタ
• 入力値のリアルタイム検証とフォーマット
• テキストへのコンポーネント（画像やボタンなど）の埋め込み

この記事では、javax.swing.textパッケージの深淵に迫り、その強力な機能を使いこなすための詳細な解説を行います。基本的な概念から実践的な応用例まで、体系的に学んでいきましょう。

第1章: javax.swing.textの基本概念 – MVCアーキテクチャ

Swingのテキストコンポーネントは、Model-View-Controller (MVC) という設計パターンに強く影響を受けています。このアーキテクチャを理解することが、javax.swing.textをマスターするための第一歩です。

Model: Document – テキストデータの保持

モデルの役割を担うのがDocumentインターフェースです。これはテキストコンポーネントが実際に表示するテキストの内容、構造、属性（スタイル情報など）を保持します。 画面上のJTextFieldやJTextPaneは、このDocumentオブジェクトのデータを視覚的に表現しているに過ぎません。

プログラムでテキストの内容を操作する場合、JTextComponentのsetText()やgetText()メソッドを直接呼び出すよりも、getDocument()メソッドでDocumentオブジェクトを取得し、そのメソッド（例：insertString(), remove()）を介して操作することが推奨されます。 これにより、データとビューの一貫性が保たれ、より安全で堅牢なコードになります。

Documentにはいくつかの主要な実装クラスがあります。

View: View – テキストの描画

ビューの役割は、Documentモデル内のデータを画面上にどのように描画（レンダリング）するかを決定することです。 この役割を担うのがViewクラスです。

テキストコンポーネントは通常、単一のViewではなく、複数のViewオブジェクトからなる階層構造（ビューツリー）を持っています。例えば、段落全体を表すParagraphViewがあり、その子として各行を表すBoxViewや、テキストの断片を表すLabelViewなどが存在します。

開発者がViewクラスを直接操作する機会は少ないかもしれませんが、テキストコンポーネントの描画を細かくカスタマイズしたい場合（例えば、独自のインライン要素を描画するなど）には、このViewの仕組みを理解していることが役立ちます。

Controller: EditorKit – 編集ポリシーの定義

コントローラの役割は、特定の種類のコンテンツに対する編集・表示のポリシーをまとめることです。 この役割を担うのがEditorKitクラスです。

EditorKitは、特定のドキュメントタイプ（プレーンテキスト、HTML、RTFなど）をどのように扱うかを定義するファクトリのように機能します。具体的には、以下のような責務を持ちます。

• 対応するDocumentモデルのインスタンスを生成する (createDefaultDocument())。
• Documentを解釈してViewの階層を構築するためのViewFactoryを提供する (getViewFactory())。
• テキストの読み込み（read）や書き出し（write）のロジックを提供する。
• そのコンテンツタイプに固有のアクション（例えば、HTMLの太字タグを挿入するアクションなど）を提供する (getActions())。
• 対応するMIMEタイプを定義する (getContentType())。

例えば、JEditorPaneにsetContentType("text/html")と設定すると、内部ではHTMLEditorKitが使用されるようになります。 これにより、JEditorPaneはHTMLを解釈し、適切に表示・編集できるようになるのです。

第2章: 主要コンポーネントとクラスの詳解

javax.swing.textパッケージの中核をなす主要なクラスとコンポーネントについて、さらに詳しく見ていきましょう。

JTextComponent: すべてのテキストコンポーネントの基盤

JTextComponentは、Swingのすべてのテキストコンポーネント（JTextField, JTextArea, JPasswordField, JEditorPane, JTextPane）の親となる抽象クラスです。 このクラスは、テキストコンポーネントに共通の基本的な機能を提供します。

これらのコンポーネントはすべてJTextComponentを継承しているため、基本的なテキスト操作は統一された方法で行うことができます。

高機能コンポーネント: JTextPane と JEditorPane

単純なテキスト入力にはJTextFieldやJTextAreaで十分ですが、よりリッチな表現が求められる場合にはJTextPaneまたはJEditorPaneを使用します。

JTextPane: スタイル付きテキストのスペシャリスト

JTextPaneは、文字ごとにフォント、色、サイズ、太字、イタリックなどのスタイルを細かく設定できるコンポーネントです。 さらに、テキスト中にアイコンや他のSwingコンポーネントを埋め込むことも可能です。ワープロソフトのようなリッチテキストエディタを作成する際に最適な選択肢となります。

JTextPaneは、モデルとしてStyledDocument（通常はDefaultStyledDocument）を使用します。 スタイル情報は、後述するAttributeSetを介して管理されます。

JEditorPane: 多様なコンテンツ形式の表示

JEditorPaneは、プレーンテキストだけでなく、HTMLやRTF（Rich Text Format）といった、特定の形式で記述されたドキュメントを読み込んで表示する能力を持っています。 URLを指定してWebページを直接ロードすることも可能です。

ただし、Swingに組み込まれているHTMLパーサーはHTML 3.2仕様に準拠しており、現代の複雑なCSSやJavaScriptで構成されたWebページを正しく表示することはできません。 あくまで簡易的なHTMLビューアや、ヘルプドキュメントの表示などに用途が限られます。

JTextPaneはJEditorPaneのサブクラスであり、JEditorPaneの機能に加えて、より便利なスタイル操作メソッドを提供しています。 独自のスタイルをプログラムで細かく制御したい場合はJTextPane、既存のHTML/RTFファイルを表示したい場合はJEditorPane、という使い分けが一般的です。

DocumentFilter: ドキュメントへの変更を監視・制御

DocumentFilterは、Documentに加えられる変更（挿入、削除、置換）をインターセプトし、その内容を検証したり、変更したりするための強力な仕組みです。 これを利用することで、以下のような機能を簡単に実装できます。

• 入力文字数制限: 許可された文字数を超えた入力を拒否する。
• 入力文字種制限: 数字のみ、英字のみといった入力を強制する。
• 自動フォーマット: 入力された小文字を自動的に大文字に変換する、など。

DocumentFilterは、AbstractDocumentのサブクラス（PlainDocumentやDefaultStyledDocumentなど）にsetDocumentFilter()メソッドで設定します。フィルタは、insertString(), remove(), replace()の3つのメソッドをオーバーライドして実装します。これらのメソッド内では、引数として渡されるFilterBypassオブジェクトを使って、実際にドキュメントへの変更を適用します。

// DocumentFilterを使用して、テキストフィールドへの入力を数字のみに制限する例
public class NumericOnlyFilter extends DocumentFilter { @Override public void insertString(FilterBypass fb, int offset, String string, AttributeSet attr) throws BadLocationException { if (string == null) { return; } if (string.matches("\\d+")) { // 正規表現で数字かどうかをチェック super.insertString(fb, offset, string, attr); } } @Override public void replace(FilterBypass fb, int offset, int length, String text, AttributeSet attrs) throws BadLocationException { if (text == null) { return; } if (text.matches("\\d+")) { // 正規表現で数字かどうかをチェック super.replace(fb, offset, length, text, attrs); } }
}
// 使用方法
JTextField textField = new JTextField();
AbstractDocument doc = (AbstractDocument) textField.getDocument();
doc.setDocumentFilter(new NumericOnlyFilter());

このように、DocumentFilterはGUIコンポーネントのロジックから入力検証ロジックを分離し、コードの再利用性と保守性を高めるのに役立ちます。

第3章: テキストのスタイリングと属性

JTextPaneの真価は、その強力なスタイリング機能にあります。この章では、テキストに様々な装飾を施すための仕組みについて解説します。

AttributeSetとStyleConstants: スタイルの定義

Swingのテキストコンポーネントでは、スタイル情報は属性(Attribute)の集合として管理されます。この属性の集合を表すのがAttributeSetインターフェースです。 属性は、キーと値のペアで構成されます（例：「色」＝「赤」）。

どのような属性キーが使えるかは、StyleConstantsクラスに定数としてまとめられています。 このクラスには、フォントファミリー、フォントサイズ、太字、イタリック、下線、文字色、背景色、行揃えなど、一般的に必要とされるスタイルのほとんどが定義されています。

実際にスタイルを定義する際には、MutableAttributeSet（変更可能なAttributeSet）インターフェースを実装したSimpleAttributeSetクラスを使うのが一般的です。

import javax.swing.text.*;
import java.awt.Color;
// 新しいスタイル（赤色の太字）を定義する例
MutableAttributeSet redBoldStyle = new SimpleAttributeSet();
// StyleConstantsのスタティックメソッドを使用して属性を設定
StyleConstants.setForeground(redBoldStyle, Color.RED); // 文字色を赤に
StyleConstants.setBold(redBoldStyle, true); // 太字を有効に
StyleConstants.setFontFamily(redBoldStyle, "SansSerif"); // フォントファミリーを設定
StyleConstants.setFontSize(redBoldStyle, 16); // フォントサイズを設定

スタイルの適用方法

作成したスタイル（AttributeSet）をテキストに適用するには、いくつかの方法があります。JTextPaneが内部で保持しているStyledDocumentオブジェクトに対して操作を行います。

1. テキスト挿入時にスタイルを指定する

StyledDocumentのinsertString()メソッドは、挿入する文字列と同時にAttributeSetを受け取ることができます。

JTextPane textPane = new JTextPane();
StyledDocument doc = textPane.getStyledDocument();
try { // ドキュメントの末尾に、先ほど定義したredBoldStyleでテキストを挿入 doc.insertString(doc.getLength(), "これは赤色の太字です。", redBoldStyle);
} catch (BadLocationException e) { e.printStackTrace();
}

2. 既存のテキストにスタイルを適用する

既に入力されているテキストの一部にスタイルを適用するには、setCharacterAttributes()メソッドを使用します。このメソッドは、指定した範囲のテキストの属性を上書き（またはマージ）します。

// 0番目から5文字のテキストのスタイルをredBoldStyleに変更する
// 第4引数がfalseの場合、既存のスタイルを完全に置き換える
doc.setCharacterAttributes(0, 5, redBoldStyle, false);

3. 段落全体にスタイルを適用する

中央揃えや右揃えなど、段落全体に影響するスタイルを適用するにはsetParagraphAttributes()メソッドを使用します。

// 中央揃え用のスタイルを作成
MutableAttributeSet centerAlign = new SimpleAttributeSet();
StyleConstants.setAlignment(centerAlign, StyleConstants.ALIGN_CENTER);
// 0番目の文字が含まれる段落全体を中央揃えにする
// 第2引数がfalseの場合、既存の段落スタイルを完全に置き換える
doc.setParagraphAttributes(0, 1, centerAlign, false);

4. StyleContextと名前付きスタイル

より高度な使い方として、StyleContextとStyleインターフェースを使用する方法があります。StyleContextはスタイルのライブラリのようなもので、スタイルを名前で管理できます。これにより、スタイルを再利用したり、一元管理したりすることが容易になります。

StyleContext sc = new StyleContext();
Style defaultStyle = sc.getStyle(StyleContext.DEFAULT_STYLE);
// "heading" という名前の新しいスタイルを作成し、StyleContextに追加
Style headingStyle = sc.addStyle("heading", defaultStyle);
StyleConstants.setFontSize(headingStyle, 24);
StyleConstants.setBold(headingStyle, true);
// 名前でスタイルを取得して適用
doc.setLogicalStyle(0, headingStyle);

setLogicalStyle()は、カーソル位置の段落に論理的なスタイルを割り当てるメソッドです。これにより、段落単位でのスタイル管理がより直感的になります。

第4章: 実践的な使い方と応用例

これまでに学んだ知識を活かして、より実践的なコード例を見ていきましょう。

import javax.swing.*;
import javax.swing.text.*;
import java.awt.*;
import java.awt.event.*;
public class SimpleRichTextEditor extends JFrame { private JTextPane textPane; public SimpleRichTextEditor() { setTitle("簡易リッチテキストエディタ"); setSize(600, 400); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); textPane = new JTextPane(); JScrollPane scrollPane = new JScrollPane(textPane); add(scrollPane, BorderLayout.CENTER); JToolBar toolBar = new JToolBar(); add(toolBar, BorderLayout.NORTH); // 太字アクション Action boldAction = new StyledEditorKit.BoldAction(); boldAction.putValue(Action.NAME, "B"); toolBar.add(new JButton(boldAction)); // イタリックアクション Action italicAction = new StyledEditorKit.ItalicAction(); italicAction.putValue(Action.NAME, "I"); toolBar.add(new JButton(italicAction)); // 下線アクション Action underlineAction = new StyledEditorKit.UnderlineAction(); underlineAction.putValue(Action.NAME, "U"); toolBar.add(new JButton(underlineAction)); toolBar.addSeparator(); // 色変更アクション（赤） Action redAction = new StyledEditorKit.ForegroundAction("Red", Color.RED); toolBar.add(new JButton(redAction)); // 色変更アクション（青） Action blueAction = new StyledEditorKit.ForegroundAction("Blue", Color.BLUE); toolBar.add(new JButton(blueAction)); } public static void main(String[] args) { SwingUtilities.invokeLater(() -> { new SimpleRichTextEditor().setVisible(true); }); }
}

import javax.swing.*;
import java.awt.*;
import java.io.File;
import java.io.IOException;
import java.net.URL;
public class HtmlViewer extends JFrame { public HtmlViewer(String filePath) { setTitle("HTMLビューア"); setSize(800, 600); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); JEditorPane editorPane = new JEditorPane(); editorPane.setEditable(false); // 編集不可にする JScrollPane scrollPane = new JScrollPane(editorPane); add(scrollPane); try { File file = new File(filePath); URL url = file.toURI().toURL(); // FileオブジェクトをURLに変換 editorPane.setPage(url); // URLを指定してページを読み込む System.out.println("Loaded page: " + url); } catch (IOException e) { JOptionPane.showMessageDialog(this, "ファイルの読み込みに失敗しました: " + e.getMessage(), "エラー", JOptionPane.ERROR_MESSAGE); editorPane.setText("<html><body><h1>ファイルが見つかりません</h1></body></html>"); editorPane.setContentType("text/html"); } } public static void main(String[] args) { // 表示したいHTMLファイルのパスを引数で渡す if (args.length == 0) { System.out.println("使用法: java HtmlViewer <htmlファイルのパス>"); // サンプルとしてカレントディレクトリにdemo.htmlを作成して試す // (demo.html: 
テスト
これはHTMLです。
) args = new String[]{"demo.html"}; } final String path = args; SwingUtilities.invokeLater(() -> { new HtmlViewer(path).setVisible(true); }); }
}

まとめ

本記事では、Java Swingのテキスト処理の根幹をなすjavax.swing.textパッケージについて、そのアーキテクチャから主要クラス、具体的な応用例までを網羅的に解説しました。

javax.swing.textパッケージは、一見複雑に見えるかもしれませんが、その構造を一度理解すれば、非常に柔軟で拡張性の高いテキスト処理が可能になります。JavaFXが主流となった現代においても、Swing製のアプリケーションの保守開発などで、この知識が役立つ場面は依然として多くあります。

本記事が、皆さんのJava Swingアプリケーション開発の一助となれば幸いです。