• オブジェクト：インスタンスやクラスの総称
• クラス：オブジェクトを表現したもの（必要な変数とメソッドの内容を記載してある仕様書）
• インスタンス：クラスの実体（new Foo()自体、クラスを元にnewして実体になったもので実際の操作が可能）

オブジェクト指向を現実世界に置き換えて考える。
この世界は、全てオブジェクトで出来ている。
人間、車、パソコンなど全てがオブジェクトであり、その中でも人間と言う種類や、車という種類など様々な種類に分類できる。
人間と車は同じくオブジェクトだが、人間と車は違うものであり、人間とはどういうものか、車とはどういうものか、それを表現したものがクラスになる。
人間には四肢があり、頭があり、目、鼻、口がある。
無意識に心臓を動かし、呼吸をして、話す事ができる。
このように人間と言うクラスを定義したとする。（人間がどういうものかを表したクラスを作成）
私は、人間クラスの実体である。
つまり、私はインスタンス(new 人間())である。
私はオブジェクトであり、且つ人間クラスのインスタンスである。
私以外の人も、人間クラスのインスタンスである。
インスタンスは、ひとつとして同じものがない。
例えば、自動車販売店で販売されている車はインスタンスである。
同じ車種の同じグレードの車だとしても、一つ一つ少しずつ違う。
つまり、new 車()すると一つ一つ別の車として発生する。

プログラミングにおけるオブジェクト指向

上記の内容を改めてJavaをベースとして考える。

• Object：全てのものはObject。あらゆるClassがjava.lang.Objectを継承している事から明らかであり、ClassもInstanceも何もかもがObjectである。
• Class：型であり、Objectの製造基盤。ClassからObjectを製造することを、インスタンス化という。
• Instance: Classから製造されたObject。「～クラスのインスタンス」という言い方をする。

コンピュータは、「メモリ上の値」以外のものに対して操作も参照も実行もする事が出来ない。
「コンピュータが何かする」というのは、「メモリに対して何かする」という事になる。
インスタンス化（実体化）というのは、クラスという設計図に従って、「コンピュータが何か出来るような値をメモリ上に作る」ことを指している。
つまり、Javaのnewは指定されたクラスに従ってインスタンスをメモリ上に展開する働きをしている。
クラスはJavaソースプログラム上で人間が考えるためのオブジェクトであり、インスタンスはプログラム実行時のメモリ上でコンピュータが何かをするためのオブジェクトである。
そう捉えると、人間が考えるモノの多くは「オブジェクト」としてコンピュータで扱えるはずではないかというのが、オブジェクト指向という考え方と言える。
ちなみに、int型整数などの「基本型(primitive型)の変数」もオブジェクトだが、これらはJavaではクラスを書く必要がないオブジェクトである。
これらは、newでインスタンス化しなくても「メモリ上の値」として、コンピュータが扱う事が出来る。
こうした基本型の変数は、「基本型（というクラス）に従って、コンパイラがインスタンス化している」と言える。
オブジェクト指向のオブジェクトとは、「独立した機能体」というイメージであり、他のオブジェクトと部分的に混同する事は無く、オブジェクト間で何かをやりとりする時も、相手オブジェクトに侵入したり浸食したりする事がない。
オブジェクト指向以前のプログラミングでは、メモリ上は自由空間であり、誰がどんなアクセスをして書き換えているか、その管理は煩雑である。
オブジェクト指向では、全てのプログラムを「オブジェクト（の組み合わせ）」として作成する。
オブジェクトは互いに独立しているので、あるオブジェクトの持つメモリが、他のオブジェクトによって勝手に浸食されたりする事はない。
そして、そういうプログラムをJava等のプログラミング言語で書き表した時、それぞれのオブジェクトを「クラス」という書き方で表現すると決めた。
ソースコードに書かれたクラスは、コンパイルされて実行される。
この時、クラスを元にして作られたメモリ上のオブジェクトのことを、インスタンスと呼んでいる。
つまり、クラスもインスタンスも、どちらもオブジェクトになる。

ToDoリストアプリケーションの作成

今回作成するアプリケーションは以下の機能を提供する。また、ToDoリストの一覧部分は“JList”を使用して表現する。

• ToDoの一覧を表示する
• ToDoを一覧に追加できる
• 一覧のToDoを編集できる
• 一覧のToDoを削除できる

JList

リストボックスを表現するコンポーネント。
複数のオブジェクトを一覧表示することができ、また、動的に一覧へのオブジェクトの追加、変更、削除を行うことができる。

JListの生成

JListは5つの種類のコンストラクタを持っている。
今回は、5つのうちのListModelを渡すタイプのコンストラクタを使用する。
このコンストラクタを使用すると、渡したリストモデルが管理しているデータを表示するリストボックスが生成される。

JList(ListModel dataModel)

ListModel

JListの表示データを管理しているクラス。
JList内の表示データの操作はListModelに対して行う。
JListが表示データの管理をListModelに委譲しているのは、データを管理するクラスと、ビューを管理するクラスを分離するというSwingの設計思想によるもの。
また、JListは.ListDataListenerを使用してListModelの内容を監視しており、ListModelに変更があった場合は、自身のビューを更新する。
この仕組みにより、表示データの操作やデータモデルの拡張はListModelに対してのみ行えばよく、ビューの問題に関しては意識する必要がない。

DefaultListModel

ListModelの基本的な機能を実装したクラス。
このクラスはListModelへの動的な追加、編集、削除に対応している。
今回作成するToDoリストは追加、編集、削除機能を提供するため、DefaultListModelを使用する。

プロジェクトの作成

プロジェクト名「ToDoList」を作成する。

１．[ファイル]⇒[新規]⇒[プロジェクト]を選択

２．[Javaプロジェクト]を選択し[次へ]をクリック

３．プロジェクト名等を入力し[完了]をクリック

• プロジェクト名に「ToDoList」を入力
• プロジェクト・レイアウトで[プロジェクト・フォルダーを・・・]を選択

SwingAppMainクラスの作成

GUIアプリケーションの起動および土台となるフレームの生成を担当するクラス「SwingAppMain」を作成する。

１．[ファイル]⇒[新規]⇒[クラス]を選択

２．[新規Javaクラス]ダイアログで各項目を入力し[完了]をクリック

• パッケージに「swing.sample」を入力
• 名前に「SwingAppMain」を入力
• public static void main(String[] args)をチェック

３．作成したクラスのソースコードを以下のように変更

package swing.sample;

import java.awt.BorderLayout;
import java.awt.Container;
import javax.swing.JComponent;
import javax.swing.JFrame;
import javax.swing.SwingUtilities;

public class SwingAppMain {
	/**
	* アプリケーションの起動
	*/
	public static void main(String[] args) {
		System.out.println("main : " + SwingUtilities.isEventDispatchThread());
		SwingUtilities.invokeLater(new Runnable() {
			public void run() {
				createAndShowTodoList();
			}
		});
	}

	/**
	* ToDoリストの生成と表示を行います。
	*/
	private static void createAndShowTodoList() {
		System.out.println("createAndShowTodoList :" + SwingUtilities.isEventDispatchThread());
		JFrame mainFrame = new JFrame("ToDoリスト");
		mainFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
		Container contentPane = mainFrame.getContentPane();
		// ToDoリストを生成
		JComponent newContentPane = new ToDoListPane();
		contentPane.add(newContentPane, BorderLayout.CENTER);
		// Windowサイズを調整
		mainFrame.pack();
		// 表示
		mainFrame.setVisible(true);
	}
}

ToDoListPaneクラスの作成

ToDoリストのすべての機能を提供するクラス「ToDoListPane」を作成する。

１．[ファイル]⇒[新規]⇒[クラス]を選択

２．[新規Javaクラス]ダイアログで各項目を入力し[完了]をクリック

• パッケージに「swing.sample」を入力
• 名前に「ToDoListPane」を入力
• public static void main(String[] args)をチェック

３．作成したクラスのソースコードを以下のように変更

package swing.sample;

import java.awt.BorderLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javax.swing.DefaultListModel;
import javax.swing.JButton;
import javax.swing.JList;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.JTextField;
import javax.swing.SwingUtilities;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;

/**
* ToDoリスト
*/
public class ToDoListPane extends JPanel {
	private static final long serialVersionUID = 1L;
	private JList toDoList;
	private DefaultListModel toDoListModel;
	private JTextField toDoInputField;
	private JButton addButton;
	private JButton modifyButton;
	private JButton removeButton;

	/**
	*
	*/
	public ToDoListPane() {
		super(new BorderLayout());
		// 一覧を生成
		toDoListModel = new DefaultListModel();
		toDoList = new JList(toDoListModel);
		JScrollPane listScrollPane = new JScrollPane(toDoList);
		// TODOリストにリスナを設定
		toDoList.addListSelectionListener(new ToDoListSelectionHandler());
		// ToDo追加用テキストフィールドの生成
		toDoInputField = new JTextField();
		// 各ボタンの生成
		JPanel buttonPanel = new JPanel();
		addButton = new JButton("追加");
		modifyButton = new JButton("編集");
		removeButton = new JButton("削除");
		// ボタンにリスナを設定
		addButton.addActionListener(new AddActionHandler());
		modifyButton.addActionListener(new ModifyActionHandler());
		removeButton.addActionListener(new RemoveActionHandler());
		buttonPanel.add(addButton);
		buttonPanel.add(modifyButton);
		buttonPanel.add(removeButton);
		add(listScrollPane, BorderLayout.NORTH);
		add(toDoInputField, BorderLayout.CENTER);
		add(buttonPanel, BorderLayout.SOUTH);
	}

	/**
	* TODOリスト選択アクションのハンドラ
	*/
	private class ToDoListSelectionHandler implements ListSelectionListener {
		public void valueChanged(ListSelectionEvent arg0) {
			// TODOリストのどの行も選択されていない場合や、
			// 複数行が選択されている場合は、
			// 何もしません
			if (toDoList.getSelectedIndices().length!=1) {
				return;
			}
			toDoInputField.setText((String)toDoList.getSelectedValue());
		}
	}

	/**
	* 追加ボタンアクションのハンドラ
	*/
	private class AddActionHandler implements ActionListener {
		public void actionPerformed(ActionEvent e) {
			// テキストフィールドの内容をリストモデルに追加
			toDoListModel.addElement(toDoInputField.getText());
		}
	}

	/**
	* 編集ボタンアクションのハンドラ
	*/
	private class ModifyActionHandler implements ActionListener {
		public void actionPerformed(ActionEvent e) {
			// テキストフィールドの内容でリストモデルを編集
			// TODOリストのどの行も選択されていない場合や、
			// 複数行が選択されている場合は、
			// 何もしません
			if (toDoList.getSelectedIndices().length != 1) {
				return;
			}
			toDoListModel.set(toDoList.getSelectedIndex(), toDoInputField.getText());
		}
	}

	/**
	* 削除ボタンアクションのハンドラ
	*/
	private class RemoveActionHandler implements ActionListener {
		public void actionPerformed(ActionEvent e) {
			// テキストフィールドの内容をリストモデルに追加
			// TODOリストのどの行も選択されていない場合や、
			// 複数行が選択されている場合は、
			// 何もしません
			if (toDoList.getSelectedIndices().length != 1) {
				return;
			}
			setButtonsEnabled(false);
			Thread removeThread = new RemoveThread(toDoList.getSelectedIndex());
			removeThread.start();
		}
	}

	/**
	* ボタンの状態を更新します
	*/
	private void setButtonsEnabled(boolean enabled) {
		addButton.setEnabled(enabled);
		modifyButton.setEnabled(enabled);
		removeButton.setEnabled(enabled);
	}

	/**
	* 削除処理を行うクラス
	*/
	class RemoveThread extends Thread {
		int index;
		RemoveThread(int index) {
			this.index = index;
		}
		public void run() {
			// 時間のかかる処理を実行
			doLongTask();
			// イベントディスパッチスレッドでボタンを変更
			SwingUtilities.invokeLater(new Runnable() {
				public void run() {
					toDoListModel.remove(index);
					setButtonsEnabled(true);
				}
			});
		}
	}

	/**
	* 時間のかかる処理
	*/
	private void doLongTask() {
		try {
			Thread.sleep(10000);
		} catch (InterruptedException ex) {
		}
	}
}

アプリケーションの実行

実行すると一覧部、入力テキストフィールド、追加・編集・削除ボタンが配置されたウィンドウが開く。
［追加］ボタンをクリックすると、テキストフィールドに入力されている文字列（ToDo）を一覧に追加。
一覧でアイテムを選択し、[編集]ボタンをクリックすると選択されている１行の文字列がテキストフィールドに表示されている文字列に変更される。
一覧でアイテムを選択し、[削除]ボタンをクリックすると選択されている１行が削除される。

SwingAppMainとToDoListPaneの2つのクラス、それぞれの役割

プログラムの解説

ToDoリストが提供する機能はToDoListPaneクラスが担当し、アプリケーションの起動等の機能はSwingAppMainクラスが担当するという構成になっている。

JListの生成

ToDoリストは追加／編集／削除機能を持つため、ListModel も状態の変更を受けて更新する処理が必要。
ここでは、これらの機能を満たしているDefaultListModelを生成している。（ここでは標準ライブラリに用意されている実装を利用しているが、ListModelを実装することで、自由に実装することが可能）

// 一覧を生成
toDoListModel = new DefaultListModel();
toDoList = new JList(toDoListModel);
JScrollPane listScrollPane = new JScrollPane(toDoList);

2行目、3行目でDefaultListModelを使用してJListを生成し、JListにスクロール機能を与えている。
最後にaddメソッドによりToDoListPaneに追加し、ToDo一覧の作成が完了する。

add(listScrollPane, BorderLayout.NORTH);

ToDo追加機能の実装(AddActionHandler)

AddActionHandlerクラスは、［追加］ボタンのイベントに対する処理を担当するインナークラス。
「toDoListModel.addElement();」にて、toDoListModelへパラメータで指定したデータを追加することができる。
追加されたデータの情報は、ListModelの監視の仕組みにより、JListのビューへ反映される。

/**
* 追加ボタンアクションのハンドラ
*/
private class AddActionHandler implements ActionListener {
	public void actionPerformed(ActionEvent e) {
		// テキストフィールドの内容をリストモデルに追加
		toDoListModel.addElement(toDoInputField.getText());
	}
}

ToDo編集機能の実装(ModifyActionHandler)

ModifyActionHandlerクラスは、編集ボタンのイベントに対する処理を担当するインナークラス。
「toDoListModel. set(int index, Object target);」にて、toDoListModelのindex番目のデータ、targetを設定することができる。

ToDo削除機能の実装(RemoveActionHandler)

RemoveActionHandlerクラスは、削除ボタンのイベントに対する処理を担当するインナークラス。
「setButtonsEnabled(false)」にて、すべてのボタンを非活性化し、その後doLongTaskにて、10秒待つ。
その後、「toDoListModel.remove(int index);」にて、toDoListModelのindex番目のデータを削除する。
削除した後、「setButtonsEnabled(true)」にて、すべてのボタンを活性化する。

ToDo選択行反映機能の実装(TodoListSelectionHandler)

TodoListSelectionHandlerクラスは、ToDoリストで選択した行の内容をテキストフィールドに反映する。

イベントディスパッチスレッド

削除処理にあえて10秒間待つ処理を入れた。
もし単純にこれを処理してしまうと、削除処理中は何も操作できなくなってしまう。
このような事態を避けるために、時間のかかる処理を別のスレッドに任せて、ユーザーが操作を行えるようにしながらバックグラウンドで処理を行う。
ここでは、RemoveThreadクラス内で別スレッドを呼び出し、時間のかかる処理（doLongTask）と削除処理を実行させることによって実現している。
時間のかかる処理を行った後、最後にSwingUtilities.invokeLater()を呼び出している。
これは、「toDoListModel.remove(int index);」および「setButtonsEnabled(true)」の2つの処理をイベントディスパッチスレッドで実行させるために使っている。
Swingのスレッドポリシーとして、“コンポーネントの「状態に依存する」あるいは「状態に影響を与える」処理はすべてイベントディスパッチスレッド上で動作しなければならない“というものがある。
これはいい換えると、Swingの描画に関連する処理は、シングルスレッドで処理しなくてはならないということ。
そして、そのシングルスレッドがイベントディスパッチスレッドになる。
このルールに則るため、わざわざSwingUtilities.invokeLater()を使っている。
今回の実装でも、sleepは描画に関係がないため別スレッドを生成して実行させたが、描画に関する処理（toDoListModel.remove、setButtonsEnabled）はイベントディスパッチスレッドで実行させるようにしている。

SwingAppMainクラス

SwingUtilities.invokeLater

「SwingAppMain」クラスのmainメソッド内ではSwingUtilities.invokeLater を呼び出し、Frameを描画する処理をイベントディスパッチスレッドに実行させている。
mainメソッドのスレッドが描画しているわけではない。

SwingUtilities.isEventDispatchThread

「SwingAppMain」クラスのmainメソッドとcreateAndShowTodoListメソッドでは、SwingUtilities.isEventDispatchThreadというメソッドが呼び出されている。
これは、実行されているスレッドがイベントディスパッチスレッドであればtureを、別のスレッドであればfalseを返す。
「SwingAppMain」を実行すると、コンソールに以下のように表示される。

main : false
createAndShowTodoList : true

createAndShorTodoListメソッドは、イベントディスパッチスレッド上で実行されていることが分かる。

GUIアプリケーションにおいて、

1. ユーザーの操作を検知する
2. アプリケーションの振る舞いを状況に応じて判断する
3. ユーザーの期待する処理を実行する

という一連の作業をプログラミングする必要がある。

Swingには、この一連の作業を簡単にプログラミングできるような仕組みであるイベント処理のモデル（アクション、イベント、アクション・リスナー）があらかじめ用意されている。

アクション

GUIコンポーネント（ボタン、テキストフィールド、メニュー等）に対してユーザーが行う操作を「アクション」という。
例えばボタンをクリックする、メニューを選択する等の行動を指す。

イベント

ユーザーが操作した事実およびユーザーの操作に関する情報を保持するオブジェクトを「イベント」という。
このイベントはコンポーネントに対してアクションが行われるたびに生成される。
例えばボタンAがクリックされた、ボタンBがクリックされた、メニュー「ファイル」が選択された、といったアクションを行うと、コンポーネントはその事実や情報を保持するためのクラス「java.awt.event.ActionEvent」のインスタンスを生成する。

アクション・リスナー

ユーザーの操作に応じて一定の処理を行うインターフェイスを「アクション・リスナー」という。
アクション・リスナーはインターフェイス「java.awt.event.ActionListener」であるため、具体的な処理を記述できない。
そのため、例えば音を鳴らす、ダイアログボックスを表示する、といった具体的なアプリケーションの処理はそのインターフェイスを実装した具象クラスのメソッド（actionPerformed）にプログラミングすることになる。

アプリケーションの振る舞いを実装

プロジェクトの作成

プロジェクト名「SwingSample04」を作成する。

１．[ファイル]⇒[新規]⇒[プロジェクト]を選択

２．[Javaプロジェクト]を選択し[次へ]をクリック

３．プロジェクト名等を入力し[完了]をクリック

• プロジェクト名に「SwingSample04」を入力
• プロジェクト・レイアウトで[プロジェクト・フォルダーを・・・]を選択

クラスの作成

GUIアプリケーションの起動、コンポーネントの配置、コンポーネントのアクションに応じた処理を担当するクラス「SwingAppMain」を作成する。

１．[ファイル]⇒[新規]⇒[クラス]を選択

２．[新規Javaクラス]ダイアログで各項目を入力し[完了]をクリック

• パッケージに「swing.sample」を入力
• 名前に「SwingAppMain」を入力
• public static void main(String[] args)をチェック

３．作成したクラスのソースコードを以下のように変更

package swing.sample;
// 必要なクラスのインポート
import java.awt.BorderLayout;
import java.awt.Container;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.JTextArea;
import javax.swing.JTextField;
import java.awt.event.ActionListener;
import java.awt.event.ActionEvent;

public class SwingAppMain implements ActionListener {
	private JFrame mainFrame;
	private Container contentPane;
	private JTextField textField;
	private JTextArea textArea;
	private JScrollPane scrollPane;
	private JPanel buttonPane;
	private JButton addButton;
	private JButton clearButton;

	// コンストラクタ
	public SwingAppMain() {
		mainFrame = new JFrame("サンプル");
		mainFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
		mainFrame.setSize(320, 200);
		mainFrame.setLocationRelativeTo(null);
		contentPane = mainFrame.getContentPane();
		textField = new JTextField();
		textArea = new JTextArea();
		scrollPane = new JScrollPane(textArea);
		addButton = new JButton("追加");
		clearButton = new JButton("消去");
		// 「追加」ボタンとアクション・リスナーの関連付け
		addButton.addActionListener(this);
		// 「消去」ボタンとアクション・リスナーの関連付け
		clearButton.addActionListener(this);
		buttonPane = new JPanel();
		buttonPane.add(addButton);
		buttonPane.add(clearButton);
		contentPane.add(textField, BorderLayout.NORTH);
		contentPane.add(scrollPane, BorderLayout.CENTER);
		contentPane.add(buttonPane, BorderLayout.SOUTH);
		mainFrame.setVisible(true);
	}

	// ユーザーの操作に応じた処理を実装
	public void actionPerformed(ActionEvent event){
		// ユーザーの操作対象を判断
		if(event.getSource() == addButton) {
			// テキストエリアへ文字列を追加
			textArea.append(textField.getText() + "\n");
		}
		if(event.getSource() == clearButton) {
			// テキストエリアの文字列を全消去
			textArea.setText(null);
		}
	}

	// アプリケーションの起動
	public static void main(String[] args) {
		new SwingAppMain();
	}
}

４．［実行］→［Javaアプリケーション］を選択して、実行する

実行した結果、テキスト入力用コンポーネント、追加・消去のボタンが配置されたウィンドウが開く。
ユーザーの操作（［追加］ボタンのクリックというアクション）に応じてテキストフィールドに入力されている文字列をテキストエリアに追加する。
ユーザーの操作（［消去］ボタンのクリックというアクション）に応じてテキストエリアの文字列をすべて消去する。

アクション・リスナーの実装

ボタンに対してユーザーの操作（アクション）に反応するためには「ActionListener」をimplementsしたクラスを定義する必要がある。
今回の例では「SwingAppMain」自身がその役割を担っている。

public class SwingAppMain implements ActionListener {

このインターフェイスは抽象メソッド「actionPerformed」を宣言しているため、「ActionListener」インターフェイスはimplementsするだけでは機能しない。
そのため「SwingAppMain」固有の「actionPerformed」メソッドを定義する。

public void actionPerformed(ActionEvent event){
}

アクション・リスナーの登録

// 「追加」ボタンとアクション・リスナーの関連付け
addButton.addActionListener(this);
// 「消去」ボタンとアクション・リスナーの関連付け
clearButton.addActionListener(this);

ボタンはアクションがあった場合に、どのクラス（メソッド）を実行すればよいかをあらかじめ知っておく（関連付けておく）必要がある。
そのため「addActionListener」を記述し、ボタンとアクション・リスナーを実装したクラスとを関連付ける。
「addActionListener」の引数には「ActionListener」をimplementsしたクラスのインスタンスを設定する。
今回の例では「SwingAppMain」自身となるため「this」を設定している。
上記のコードを記述することで［追加］ボタンまたは［消去］ボタンがクリックされたとき「SwingAppMain」クラス固有の「actionPerformed」が実行されるようになる。

ユーザーの操作に応じた処理の実装

ボタンに対してアクションを行うと「ActionEvent」のインスタンスが生成される。
今回の例では、「追加」ボタンまたは「消去」ボタンに対して行われたアクション（クリック）の結果として生成された「ActionEvent」クラスのインスタンスの情報を基にアプリケーションの振る舞い（actionPerformed）を変えている。

// ユーザーの操作に応じた処理を実装
public void actionPerformed(ActionEvent event){
	// ユーザーの操作対象を判断
	if(event.getSource() == addButton) {
		// テキストエリアへ文字列を追加
		textArea.append(textField.getText() + "\n");
	}
	if(event.getSource() == clearButton) {
		// テキストエリアの文字列を全消去
		textArea.setText(null);
	}
}

Swingで利用できるテキスト入力用コンポーネントには、以下のものが存在する。

• 1行分の入力ができる「JTextField」
• 複数行の入力ができる「JTextArea」

プロジェクトの作成

プロジェクト名「SwingSample03」を作成する。

１．[ファイル]⇒[新規]⇒[プロジェクト]を選択

２．[Javaプロジェクト]を選択し[次へ]をクリック

３．プロジェクト名等を入力し[完了]をクリック

• プロジェクト名に「SwingSample03」を入力
• プロジェクト・レイアウトで[プロジェクト・フォルダーを・・・]を選択

クラスの作成

GUIアプリケーションの起動および各コンポーネントの作成を行う「SwingAppMain」クラスを作成する。

１．[ファイル]⇒[新規]⇒[クラス]を選択

２．[新規Javaクラス]ダイアログで各項目を入力し[完了]をクリック

• パッケージに「swing.sample」を入力
• 名前に「SwingAppMain」を入力
• public static void main(String[] args)をチェック

３．作成したクラスに以下のクラスをインポート

• javax.swing.JButton
• javax.swing.JFrame
• javax.swing.JScrollPane
• javax.swing.JTextArea
• javax.swing.JTextField
• java.awt.BorderLayout
• java.awt.Container

４．mainメソッド内で「JFrame」クラスのインスタンス（mainFrame）を生成し初期設定を行いテキストフィールド、テキストエリアを配置

以下の項目の実装

• JFrameクラスのインスタンスを生成
• 閉じるボタン押下時のアプリケーションの振る舞いを決定
• ウィンドウの初期サイズ（幅、高さ）をピクセル単位で設定
• ウィンドウの表示場所を規定（画面の中央に表示）
• mainFrameのContentPaneを取得（contentPane）
• 「JTextField」クラスのインスタンス(textField)を生成
• 「JTextArea」クラスのインスタンス(textArea)を生成
• 「JScrollPane」クラスのインスタンス(scrollPane)を生成し、textAreaを追加
• 「JButton」クラスのインスタンス（button）を生成
• アクションの定義
• contentPaneにtextField、textArea、buttonを追加
• ウィンドウの表示

package swing.sample;
// 必要なクラスのインポート
import java.awt.BorderLayout;
import java.awt.Container;
import java.awt.event.ActionEvent;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JScrollPane;
import javax.swing.JTextArea;
import javax.swing.JTextField;
import javax.swing.AbstractAction;

public class SwingAppMain {
	public static void main(String[] args) {
		// JFrameクラスのインスタンスを生成
		JFrame mainFrame = new JFrame("サンプル");
		// 閉じるボタン押下時のアプリケーションの振る舞いを決定
		mainFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
		// ウィンドウの初期サイズ（幅、高さ）をピクセル単位で設定
		mainFrame.setSize(320, 160);
		// ウィンドウの表示場所を規定
		mainFrame.setLocationRelativeTo(null);

		// mainFrameのContentPaneを取得する
		Container contentPane = mainFrame.getContentPane();
		// テキストフィールドのインスタンスを生成
		final JTextField textField = new JTextField();
		// テキストエリアのインスタンスを生成
		final JTextArea textArea = new JTextArea(5,0);
		// スクロールペインにテキストエリアを追加
		JScrollPane scrollPane = new JScrollPane(textArea);
		// ボタンのインスタンスを生成
		JButton button = new JButton("追加");
		// アクションの定義
		button.addActionListener(new AbstractAction(){
			private static final long serialVersionUID = 1L;
			public void actionPerformed(ActionEvent arg0) {
				// textFieldから文字列を取得し、取得した文字列に改行コードを加え、textAreaに追加
				textArea.append(textField.getText() + "\n");
			}
		});
		// パネルをコンポーネントに配置
		contentPane.add(textField, BorderLayout.NORTH);
		contentPane.add(scrollPane, BorderLayout.CENTER);
		contentPane.add(button, BorderLayout.SOUTH);

		// ウィンドウを表示する
		mainFrame.setVisible(true);
	}
}

５．［実行］→［Javaアプリケーション］を選択して、実行する

実行した結果、テキスト入力用コンポーネントが配置されたウィンドウが開く。

上段のテキストフィールドに値を入力し、「追加」ボタンをクリックするとテキストフィールドの値が下段のテキストエリアに追加される。

JScrollPane

JScrollPaneは、自身に追加されたコンポーネントに対して、スクロール処理を提供する。
サンプルでは、下段のテキストエリアに対して改行を数回入力すると、スクロールバーが現れる。

JScrollPaneの生成

JScrollPane scrollPane = new JScrollPane(textArea);

このコードでは、コンストラクタでJScrollPaneに追加するコンポーネントを指定している。
上記の場合は、textAreaが追加するコンポーネント。
textArea内の行数が増えたり、行内の文字数が増えたりしてスクロールする必要が生じると、スクロールバーが表示される。

テキストフィールドの値の取得と設定

テキスト入力用コンポーネントからの値の取得

getText()

getText()はJTextFieldとJTextAreaの親クラスであるJTextComponentクラスで提供されているメソッドで、テキスト入力用コンポーネント内のテキスト全体を取得する。
このほかにも、オフセットと読取長を指定したgetText(int, int)や、選択されている部分のみを取得するgetSelectedText()がある。

テキスト入力用コンポーネントへの値の設定

setText(String)
append(String)

setText(String)はJTextFieldとJTextAreaの親クラスであるJTextComponentクラスで提供されているメソッドで、テキスト入力用コンポーネントにパラメータで指定した文字列が設定される。
Append(String)はJTextAreaクラスで提供されているメソッドで、パラメータをテキストの末尾に追加する。

アクションの定義

「クラスの作成」で作成したウィンドウでは、テキスト入力用コンポーネントから値を取得したり、値を設定したりすることはできない。
そこで、以下のようなコードが必要になる。

クラスのインポート

java.awt.event.ActionEvent
javax.swing.AbstractAction

// アクションの定義
button.addActionListener(new AbstractAction(){
	private static final long serialVersionUID = 1L;
	public void actionPerformed(ActionEvent arg0) {
		// textFieldから文字列を取得し、取得した文字列に改行コードを加え、textAreaに追加
		textArea.append(textField.getText() + "\n");
	}
});

ここでは、次のようなことを行っている。

• textFieldから文字列を取得(textField.getText())
• 取得した文字列に改行コードを加え、textAreaに追加

Swingコンポーネントの種類

Swingコンポーネントは以下の3つの階層に分類される。

１．トップレベルコンテナ（JFrame等）
メインウィンドウとなるコンポーネントであり、ほかのコンポーネントの土台となる。

２．中間コンテナ（JPanel等）
コンポーネントを配置するためのコンテナの役割。

３．コントロール（JLable、JButton等）
ボタンやラベルなどの個々のGUI部品。

Swingでは、この3つの階層のコンポーネントを組み合わせてアプリケーションを作成する。

JLabelなどのコントロールを持ったアプリケーションを作成するには、まずトップレベルコンテナを作成し、そこに中間コンテナを配置し、さらに中間コンテナにコントロールを配置するといった手順を踏むことになる。

プロジェクトの作成

プロジェクト名「SwingSample02」を作成する。

１．[ファイル]⇒[新規]⇒[プロジェクト]を選択

２．[Javaプロジェクト]を選択し[次へ]をクリック

３．プロジェクト名等を入力し[完了]をクリック

• プロジェクト名に「SwingSample02」を入力
• プロジェクト・レイアウトで[プロジェクト・フォルダーを・・・]を選択

クラスの作成

GUIアプリケーションの起動および各コンポーネントの作成を行う「SwingAppMain」クラスを作成する。

１．[ファイル]⇒[新規]⇒[クラス]を選択

２．[新規Javaクラス]ダイアログで各項目を入力し[完了]をクリック

• パッケージに「swing.sample」を入力
• 名前に「SwingAppMain」を入力
• public static void main(String[] args)をチェック

３．作成したクラスに以下のクラスをインポート

• javax.swing.JButton
• javax.swing.JFrame
• javax.swing.JLabel
• java.awt.BorderLayout

４．mainメソッド内で「JFrame」クラスのインスタンス（mainFrame）を生成し初期設定を行いラベル、ボタンを配置

以下の項目の実装

• JFrameクラスのインスタンスを生成
• 閉じるボタン押下時のアプリケーションの振る舞いを決定
• ウィンドウの初期サイズ（幅、高さ）をピクセル単位で設定
• ウィンドウの表示場所を規定（画面の中央に表示）
• mainFrameのContentPaneを取得（contentPane）
• ［JLabel］クラスのインスタンス（label）を生成
• ［JButton］クラスのインスタンス（button）を生成
• contentPaneにlabelを追加
• contentPaneにbuttonを追加
• ウィンドウの表示

package swing.sample;
// 必要なクラスのインポート
import java.awt.BorderLayout;
import java.awt.Container;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JLabel;

public class SwingAppMain {
	/**
	　* @param args
	*/
	public static void main(String[] args) {
		// JFrameクラスのインスタンスを生成
		JFrame mainFrame = new JFrame("サンプル");
		// 閉じるボタン押下時のアプリケーションの振る舞いを決定
		mainFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
		// ウィンドウの初期サイズ（幅、高さ）をピクセル単位で設定
		mainFrame.setSize(320, 160);
		// ウィンドウの表示場所を規定
		mainFrame.setLocationRelativeTo(null);

		// JFrameよりContentPaneを取得
		Container contentPane = mainFrame.getContentPane();
		// ラベルのインスタンスを生成
		JLabel label = new JLabel("SwingLabel");
		// ボタンのインスタンスを生成
		JButton button = new JButton("SwingButton");
		// ラベルをContentPaneに配置
		contentPane.add(label, BorderLayout.CENTER);
		// ボタンをContentPaneに配置
		contentPane.add(button, BorderLayout.SOUTH);

		// ウィンドウを表示
		mainFrame.setVisible(true);
	}
}

５．［実行］→［Javaアプリケーション］を選択して、実行する

実行した結果、タイトルバーに「サンプル」、ラベルとボタンが配置されたウィンドウが開く

各コンポーネントの役割と機能

ContentPane

ContentPaneとは、JFrameの表示領域。
JFrameに表示したいコンポーネントは、ContentPaneに追加する必要がある。

ContentPaneの取得

Container contentPane = mainFrame.getContentPane();

上記コードのgetContentPaneメソッドで、ContentPaneを取得している。
ContentPaneは、Containerクラスの型で取得できるが、JFrameの中でJPanelとして生成されている。

JPanelクラス

JPanelは、複数のコンポーネントを配置できるコンテナ（コンポーネントを張り付ける台紙のイメージ）。
Swingでは、JPanelのような中間コンテナにコンポーネントを張り付ける感覚で画面を作成する。

コンポーネントの配置

contentPane.add(label, BorderLayout.CENTER);
contentPane.add(button, BorderLayout.SOUTH);

上記コードで、ContentPaneにコンポーネントを追加することができる。
addメソッドの第1パラメータでは、ContentPaneに配置したいコンポーネントを指定。
第2パラメータでは、コンポーネントを配置する位置を指定。
BorderLayout.CENTERは、コンポーネントをContentPaneの中心に配置することを意味している。（BorderLayoutクラスの定数）

レイアウトマネージャ

コンテナ内のコンポーネントのレイアウトに関してはレイアウトマネージャが管理している。
レイアウトマネージャにはBorderLayoutや、GridLayoutなどさまざまな種類のものがある。
これらのレイアウトマネージャを使用することでコンテナ内の統一的なレイアウトを簡単に実現することができる。

BorderLayoutクラス

BorderLayoutは、「east、west、south、north、center」の5つの領域に分けてコンポーネントを配置する。
1つの表示領域には、1つのコンポーネントを配置することができる。
設定されたコンポーネントは、その領域を満たすサイズで表現される。

Package swing.sample;
import java.awt.BorderLayout;
import javax.swing.Jbutton;
import javax.swing.Jframe;
import javax.swing.Jpanel;
public class BorderLayoutSample {
	/**
	　* @param args
	　*/
	public static void main(String[] args) {
		Jframe mainFrame = new Jframe(“BorderLayoutSample”);
		mainFrame.setDefaultCloseOperation(Jframe.EXIT_ON_CLOSE);
		mainFrame.setSize(320, 160);
		mainFrame.setLocationRelativeTo(null);
		Jpanel contentPane = (Jpanel) mainFrame.getContentPane();
		Jbutton north = new Jbutton(“north”);
		Jbutton west = new Jbutton(“west”);
		Jbutton east = new Jbutton(“east”);
		Jbutton center = new Jbutton(“center”);
		Jbutton south = new Jbutton(“south”);
		contentPane.add(north, BorderLayout.NORTH);
		contentPane.add(west, BorderLayout.WEST);
		contentPane.add(east, BorderLayout.EAST);
		contentPane.add(center, BorderLayout.CENTER);
		contentPane.add(south, BorderLayout.SOUTH);
		mainFrame.setVisible(true);
	}
}

Jlabelクラス

Jlabelクラスは、文字列やイメージの表示に使用するクラス。

インスタンスの生成

JLabel label = new JLabel("SwingLabel");

上記コードで、JLabelクラスのインスタンスを生成している。
コンストラクタには、JLabelで表示したい文字列を設定している。
また、表示したい文字列はインスタンスを生成した後で設定することも可能。
その場合は、JLabelクラスのsetTextメソッドを使用する。

表示文字列の配置位置の制御

JLabelは、表示文字列の配置位置を制御することができる。

label.setHorizontalAlignment(SwingConstants.CENTER);

上記コードで、labelインスタンスに設定した文字列が中央に表示される。
etHorizontalAlignmentは、表示文字列の横軸に沿った配置位置を制御するメソッド。
パラメータのSwingConstants.CENTERで表示文字列を配置する位置を指定する。
SwingConstantsは、JLabelが継承しているインターフェイスで、コンポーネントの配置に関する定数が定義されている。
JLabel、JButton等のSwingConstantsを継承したクラスは、SwingConstantsの定数を使用することで、配置の指定に関する表現が統一されている。

JButtonクラス

JButtonクラスは、プッシュボタンを表現するクラス。JLabel同様、イメージを表示することも可能。

インスタンスの生成

JButton button = new JButton("SwingButton");

上記コードで、JButtonクラスのインスタンスを生成している。
コンストラクタには、JButtonで表示したい文字列を設定している。
JLabelと同じく、setTextメソッドを使用することで後から表示文字列を設定することができる。

有効無効の制御

ボタンの有効無効を制御するには、setEnabledメソッドを使用する。

button.setEnabled(false);

上記コードで、buttonインスタンスで生成したボタンが無効状態となる。
setEnabledメソッドは、パラメータのboolean値で有効無効を指定することができる。
trueの場合が有効、falseの場合が無効を意味する。
このsetEnabledメソッドは、トップレベルコンテナ（JFrame等）以外のすべてのSwingコンポーネントが継承しているJComponentクラスのメソッド。
よって、トップレベルコンテナ以外のSwingコンポーネントはsetEnabledメソッドにより、有効無効を制御することができる。
JLabelもsetEnabledメソッドを使用して有効無効を制御することができる。

まずは、ウィンドウを表示するだけの単純なGUIアプリケーションを作成する。

プロジェクトの作成

プロジェクト名「SwingSample01」を作成する。

１．[ファイル]⇒[新規]⇒[プロジェクト]を選択

２．[Javaプロジェクト]を選択し[次へ]をクリック

３．プロジェクト名等を入力し[完了]をクリック

• プロジェクト名に「SwingSample01」を入力
• プロジェクト・レイアウトで[プロジェクト・フォルダーを・・・]を選択

クラスの作成

GUIアプリケーションの起動およびウィンドウの作成を行う「SwingAppMain」クラスを作成する。

１．[ファイル]⇒[新規]⇒[クラス]を選択

２．[新規Javaクラス]ダイアログで各項目を入力し[完了]をクリック

• パッケージに「swing.sample」を入力
• 名前に「SwingAppMain」を入力
• public static void main(String[] args)をチェック

３．作成したクラスに「javax.swing.JFrame」をインポート

package swing.sample;
// 「javax.swing.JFrame」をインポート
import javax.swing.JFrame;
public class SwingAppMain {
	/**
	* @param args
	*/
	public static void main(String[] args) {
		// TODO 自動生成されたメソッド・スタブ
	}
}

４．mainメソッド内で「JFrame」クラスのインスタンス（mainFrame）を生成し初期設定を行う

以下の項目の実装

• JFrameクラスのインスタンスを生成
• 閉じるボタン押下時のアプリケーションの振る舞いを決定
• ウィンドウの初期サイズ（幅、高さ）をピクセル単位で設定
• ウィンドウの表示場所を規定（画面の中央に表示）
• ウィンドウの表示

package swing.sample;
// 「javax.swing.JFrame」をインポート
import javax.swing.JFrame;

public class SwingAppMain {
	/**
	* @param args
	*/
	public static void main(String[] args) {
		// TODO 自動生成されたメソッド・スタブ
		// JFrameクラスのインスタンスを生成
		JFrame mainFrame = new JFrame("サンプル");
		// 閉じるボタン押下時のアプリケーションの振る舞いを決定
		mainFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
		// ウィンドウの初期サイズ（幅、高さ）をピクセル単位で設定
		mainFrame.setSize(320, 160);
		// ウィンドウの表示場所を規定
		mainFrame.setLocationRelativeTo(null);
		// ウィンドウを表示
		mainFrame.setVisible(true);
	}
}

５．［実行］→［Javaアプリケーション］を選択して、実行する

実行した結果、タイトルバーに「サンプル」と表示されたウィンドウが開く。

JFrame

ウィンドウを作成するためのクラス。
Swingを利用したGUIアプリケーションでは、必ず初めにJFrameクラスのインスタンスを生成し、その後、生成したインスタンスのメソッドを介してウィンドウの初期設定を行う。

loggerインスタンスを作成する度にコード内で設定を記述するのは非効率であり、ログレベル等の変更をするにもリビルドが必要になってしまう。

プロパティファイルを利用すれば、上記の問題を解決できる。

標準出力へログ出力するハンドラを定義

標準出力へログ出力するハンドラを通常のクラスとして定義する。

ログレベルの設定は、プロパティファイルで行うので指定不要。

package logging.test;

import java.util.logging.StreamHandler;

/*
 * 標準出力へログ出力するハンドラ
 */
public class StdOutHandler extends StreamHandler {
	{
		//標準出力への出力設定
		setOutputStream(System.out);
	}
}

プロパティファイルを作成する

ハンドラの指定、ルートロガーのログレベル設定、標準出力ハンドラの設定、SimpleFormatterのフォーマット変更を記述し、実行コードと同じディレクトリに配置する。

#Specified handler
handlers= logging.test.StdOutHandler
#Log level setting of the root logger
.level= ALL
#Setting the standard output handler
logging.test.StdOutHandler.level = ALL
#Format change of SimpleFormatter
java.util.logging.SimpleFormatter.format=%1$tY-%1$tm-%1$td %1$tH:%1$tM:%1$tS.%1$tL %4$s [%3$s] %5$s (%2$s) %6$s%n

ログを標準出力へ出力する

定義しておいたプロパティファイルを読み込んで、ログ出力を行う。

package logging.test;

import java.io.IOException;
import java.util.logging.LogManager;
import java.util.logging.Logger;

public class StandardOutput {
	public static void main(String[] args) {
		// プロパティファイルの読み込み
		try {
			LogManager.getLogManager().readConfiguration(StandardOutput.class.getResourceAsStream("customLog.properties"));
		} catch (SecurityException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
		// Loggerクラスのインスタンスを生成
		Logger logger = Logger.getLogger(Logger.GLOBAL_LOGGER_NAME);
		// ログ出力
		logger.fine("ログ出力テスト：fine");
		logger.info("ログ出力テスト：info");
		logger.severe("ログ出力テスト：severe");
	}
}

これはデフォルトのログ設定ファイルの設定上、ルートロガーのハンドラがConsoleHandlerとなっており、ConsoleHandlerはエラー出力を使う仕様になっている為。

ログの出力先を標準出力に変更するには、別途ハンドラを定義する必要がある。

標準出力へログ出力するハンドラを定義

標準出力へログ出力するハンドラを通常のクラスとして定義する。

package logging.test;

import java.util.logging.Level;
import java.util.logging.StreamHandler;

/*
 * 標準出力へログ出力するハンドラ
 */
public class StdOutHandler extends StreamHandler {
	{
		// 標準出力への出力設定
		setOutputStream(System.out);
		// ログレベルの設定（ALLに設定しないとログレベルをコントロールできない）
		setLevel(Level.ALL);
	}
}

ログを標準出力へ出力する

定義しておいた標準出力へログ出力するハンドラをロガーに追加して、ログ出力を行う。

その際、デフォルトのログ設定ファイルで管理されているルートロガーのハンドラ（ConsoleHandler）へログメッセージを発行しないように制御しないとエラー出力、標準出力それぞれにログが出力される。

package logging.test;

import java.util.logging.Level;
import java.util.logging.Logger;

public class StandardOutput {
	public static void main(String[] args) {
		// Loggerクラスのインスタンスを生成
		Logger logger = Logger.getLogger(Logger.GLOBAL_LOGGER_NAME);
		// 標準出力へログを出力するハンドラを追加
		logger.addHandler(new logging.test.StdOutHandler());
		// ルートロガーのハンドラ（ConsoleHandler）へログメッセージを発行しない
		logger.setUseParentHandlers(false);
		// ログレベル設定
		logger.setLevel(Level.ALL);
		// ログ出力
		logger.fine("ログ出力テスト：fine");
		logger.info("ログ出力テスト：info");
		logger.severe("ログ出力テスト：severe");
	}
}

ログを出力する

// Loggerクラスのインスタンスを生成する
final Logger logger = Logger.getLogger("SampleLogging");
// ログを出力する
logger.log(Level.FINEST, "ログ出力テスト：finest");
logger.log(Level.FINER, "ログ出力テスト：finer");
logger.log(Level.FINE, "ログ出力テスト：fine");
logger.log(Level.CONFIG, "ログ出力テスト：config");
logger.log(Level.INFO, "ログ出力テスト：info");
logger.log(Level.WARNING, "ログ出力テスト：warning");
logger.log(Level.SEVERE, "ログ出力テスト：severe");

Java標準APIでのログ出力の基本は、java.util.logging.Loggerクラス。

Logger.getLogger()で、ロガーに設定する名称をパラメータで渡し、ロガー（Loggerクラスのインスタンス）を取得する。

ロガーに設定する名称としてFQCN（完全修飾クラス名：this.getClass().getName()）を利用することが多い。

log(Level level, String msg)メソッドで、ログレベルとログメッセージをパラメータで渡し、ログを出力する。（ログレベルについては後述）

尚、上記の例では標準エラー出力にのみログ内容が出力され、ファイルには出力されない。

ログをファイルに出力する

// Loggerクラスのインスタンスを生成する
final Logger logger = Logger.getLogger("SampleLogging");
try {
    // 出力ファイルを指定する
    FileHandler fh = new FileHandler("SampleLog.log");
    logger.addHandler(fh);
} catch (IOException e) {
    e.printStackTrace();
}
// ログを出力する
logger.log(Level.FINEST, "ログ出力テスト：finest");
logger.log(Level.FINER, "ログ出力テスト：finer");
logger.log(Level.FINE, "ログ出力テスト：fine");
logger.log(Level.CONFIG, "ログ出力テスト：config");
logger.log(Level.INFO, "ログ出力テスト：info");
logger.log(Level.WARNING, "ログ出力テスト：warning");
logger.log(Level.SEVERE, "ログ出力テスト：severe");

java.util.logging.FileHandlerクラスを使うことでファイルにも出力できる。

上記の例では、実行ディレクトリのSampleLog.logというファイルにログが出力される。

ただし、出力結果はXML形式となる。

ログファイルの出力書式を変更する

// Loggerクラスのインスタンスを生成する
final Logger logger = Logger.getLogger("SampleLogging");
try {
    // 出力ファイルを指定する
    FileHandler fh = new FileHandler("SampleLog.log");
    // 出力フォーマットを指定する
    fh.setFormatter(new java.util.logging.SimpleFormatter());
    logger.addHandler(fh);
} catch (IOException e) {
    e.printStackTrace();
}
// ログを出力する
logger.log(Level.FINEST, "ログ出力テスト：finest");
logger.log(Level.FINER, "ログ出力テスト：finer");
logger.log(Level.FINE, "ログ出力テスト：fine");
logger.log(Level.CONFIG, "ログ出力テスト：config");
logger.log(Level.INFO, "ログ出力テスト：info");
logger.log(Level.WARNING, "ログ出力テスト：warning");
logger.log(Level.SEVERE, "ログ出力テスト：severe");

Java標準APIでのログ出力の標準設定はXML形式になっているが、FileHandlerに対してjava.util.logging.SimpleFormatterクラスを設定することで、コンソール出力と同じ書式でファイルに出力できる。

ログレベルを変更する

ログレベルは、文字通りログ出力制御のレベルを指定するために利用されるもので、java.util.logging.Levelクラスで定義されている。

Java標準APIでのログ出力の標準設定では、ログレベルがINFOまでになっており、INFOレベルより下のレベルのログは出力されない。

ログレベル、対応するLoggerクラスの簡易メソッド、それぞれの意味は下記の通り。

ログレベルの種類（レベルの昇順）

// Loggerクラスのインスタンスを生成する
final Logger logger = Logger.getLogger("SampleLogging");
try {
    // 出力ファイルを指定する
    FileHandler fh = new FileHandler("SampleLog.log");
    // 出力フォーマットを指定する
    fh.setFormatter(new java.util.logging.SimpleFormatter());
    logger.addHandler(fh);
} catch (IOException e) {
    e.printStackTrace();
}
// 出力レベルをCONFIG以上に設定する
logger.setLevel(Level.CONFIG);
// ログを出力する
logger.log(Level.FINEST, "ログ出力テスト：finest");
logger.log(Level.FINER, "ログ出力テスト：finer");
logger.log(Level.FINE, "ログ出力テスト：fine");
logger.log(Level.CONFIG, "ログ出力テスト：config");
logger.log(Level.INFO, "ログ出力テスト：info");
logger.log(Level.WARNING, "ログ出力テスト：warning");
logger.log(Level.SEVERE, "ログ出力テスト：severe");

setLevel()メソッドを使うことで、出力レベルの指定ができる。（”Level.ALL”ですべてのログレベルを出力）

ただし、これで変更されるのはファイルに対する出力レベルのみで、コンソールへの出力は変わらない。

// Loggerクラスのインスタンスを生成する
final Logger logger = Logger.getLogger("SampleLogging");
// ログを出力する
logger.finest("ログ出力テスト：finest");
logger.finer("ログ出力テスト：finer");
logger.fine("ログ出力テスト：fine");
logger.config("ログ出力テスト：config");
logger.info("ログ出力テスト：info");
logger.warning("ログ出力テスト：warning");
logger.severe("ログ出力テスト：severe");

例外のスタックトレースを出力する

// Loggerクラスのインスタンスを生成する
final Logger logger = Logger.getLogger("SampleLogging");
try {
    // 出力ファイルを指定する
    FileHandler fh = new FileHandler("SampleLog.log");
    // 出力フォーマットを指定する
    fh.setFormatter(new java.util.logging.SimpleFormatter());
    logger.addHandler(fh);
} catch (IOException e) {
    e.printStackTrace();
}
// 出力レベルをCONFIG以上に設定する
logger.setLevel(Level.CONFIG);
// 例外を発生させ、ログを出力する
try {
    String s = null;
    s.toString();
} catch (NullPointerException e) {
    // スタックトレースを出力する
    logger.log(Level.SEVERE, "例外発生", e);
}

log(Level level, String msg, Throwable thrown)メソッドを利用することで、例外やエラーのスタックトレースを出力することができる。

追加モードで出力する

// Loggerクラスのインスタンスを生成する
final Logger logger = Logger.getLogger("SampleLogging");
try {
    // 出力ファイルを追加モードで指定する
    FileHandler fh = new FileHandler("SampleLog.log", true);
    // 出力フォーマットを指定する
    fh.setFormatter(new java.util.logging.SimpleFormatter());
    logger.addHandler(fh);
} catch (IOException e) {
    e.printStackTrace();
}
// 出力レベルをALLに設定する
logger.setLevel(Level.ALL);
// ログを出力する
logger.log(Level.FINEST, "ログ出力テスト：finest");
logger.log(Level.FINER, "ログ出力テスト：finer");
logger.log(Level.FINE, "ログ出力テスト：fine");
logger.log(Level.CONFIG, "ログ出力テスト：config");
logger.log(Level.INFO, "ログ出力テスト：info");
logger.log(Level.WARNING, "ログ出力テスト：warning");
logger.log(Level.SEVERE, "ログ出力テスト：severe");

出力ファイルを追加モードで指定しない場合、実行の度にログファイルが上書きされる。（過去のログが消える）

これを回避する為には、パラメータが2つあるFileHandlerのコンストラクタを使い、第2パラメータにtrueを設定する。

addメソッド

public abstract void add(int field, int amount)

カレンダーの規則に基づいて、指定された時間量を指定されたカレンダーフィールドに加算または減算する。

例えば、カレンダーの現在時刻から 5 日を引く場合は、次の呼び出しを実行する。

add(Calendar.DAY_OF_MONTH, -5)

【パラメータ】
field：カレンダーフィールド
amount：フィールドに追加される日付または時刻の量

尚、日を1ずつ増加させていき、その月の最後の日になりさらに追加すると月が1増加され日は1に戻る。

ただし、注意する点としては日が31日などの場合に月を1だけ増加させた場合、増加後の月が30日までしか無い場合などは日も30に変更される。

その後に31日まである月になったとしても日は30日のままとなる。

サンプルプログラム

import java.util.Calendar;

class testCalendar{
  public static void main(String args[]){

    Calendar calendar = Calendar.getInstance();

    System.out.println("日時を2005/12/30に設定する");
    calendar.set(2005, 11, 30);
    dispCalendar(calendar);

    System.out.println("-- -- -- -- -- --");

    System.out.println("日を1ずつ増加させる");
    for (int i = 0 ; i < 6 ; i++){
      calendar.add(Calendar.DAY_OF_MONTH, 1);
      dispCalendar(calendar);
    }

    System.out.println("-- -- -- -- -- --");

    System.out.println("日時を2006/1/31に設定する");
    calendar.set(2006, 0, 31);
    dispCalendar(calendar);

    System.out.println("-- -- -- -- -- --");

    System.out.println("月を1ずつ増加させる");
    for (int i = 0 ; i < 4 ; i++){
      calendar.add(Calendar.MONTH, 1);
      dispCalendar(calendar);
    }
  }

  private static void dispCalendar(Calendar calendar){
    int year = calendar.get(Calendar.YEAR);
    int month = calendar.get(Calendar.MONTH) + 1;
    int day = calendar.get(Calendar.DATE);

    StringBuffer sb = new StringBuffer();
    sb.append("設定されている日時は");
    sb.append(year + "年" + month + "月" + day + "日");

    System.out.println(new String(sb));
  }
}