このトピックでは、toString() 生成プログラムが配列の内容をリストする方法と、Collection および Map でリストされる項目の数を制御する方法について説明します。使用されるメソッドは、メンバーの型だけでなく、プロジェクトで選択されている JDK 互換性によっても異なります。
Arrays.toString() が使用されます。このメソッドは JDK1.4 では使用不可であるため、このケースでは Arrays.asList() が代わりに使用されます。ただしこれは、プリミティブ以外の配列に限られます。プリミティブ配列は、ヘルパー・メソッドによって処理されます (下記を参照)。Arrays.asList() と List.subList() の組み合わせ) が使用されます。例えば、anArray という名前のメンバーについて生成されるコードは次のようになります。Arrays.asList(anArray).subList(0, Math.min(anArray.length, maxLen))Arrays.asList() を使用できないため、JDK1.5 以下ではヘルパー・メソッドが代わりに使用されます。JDK1.6 では、Arrays.toString(Arrays.copyOf(anArray, Math.min(anArray.length, maxLen)) という方法もあります。配列のコピーは最適な方法ではありませんが、
コピーされた部分は通常サイズがかなり小さいため、効率には影響しません。優れている点は、ヘルパー・メソッドを回避できるということです。[1, 2, 3] の形式で返します。このメソッドは配列全体にわたって繰り返され、
instanceof を使用してそのエンクロージング型を判別します。コードが短くなるよう、実際に渡すことのできる型の有無だけが確認されます。
private String arrayToString(Object array, int len, int maxLen) {
StringBuffer stringBuffer = new StringBuffer();
len = Math.min(len, maxLen);
stringBuffer.append("[");
for (int i = 0; i < len; i++) {
if (i > 0)
stringBuffer.append(", ");
if (array instanceof float[])
stringBuffer.append(((float[]) array)[i]);
if (array instanceof int[])
stringBuffer.append(((int[]) array)[i]);
if (array instanceof Object[])
stringBuffer.append(((Object[]) array)[i]);
}
stringBuffer.append("]");
return stringBuffer.toString();
}
注:maxLen 引数は取り出されず、Math.min() も使用されませんList の制限された内容のリスト作成すべての JDK バージョンで次の方法が使用されます。aList.subList(0, Math.min(aList.size(), maxLen))
Collection の制限された内容のリスト作成 (ヘルパー・メソッド)Collection はその内容をコピーせずに List に変換することができないため (もともと List である場合を除く)、ヘルパー・メソッドの使用が最初の maxLen 要素全体にわたって繰り返され、それらからストリングが作成されます。
private String toString(Collection collection, int maxLen) {
StringBuffer stringBuffer = new StringBuffer();
stringBuffer.append("[");
int i = 0;
for (Iterator iterator = collection.iterator(); iterator.hasNext() && i < maxLen; i++) {
if (i > 0)
stringBuffer.append(", ");
stringBuffer.append(iterator.next());
}
stringBuffer.append("]");
return stringBuffer.toString();
}
注:Map の制限された内容のリスト作成Map の場合は、Collection の場合と同じヘルパー・メソッドが使用されます。ただし、map.entrySet() が渡されます。
この表では、さまざまな条件で使用されるメソッドが要約されています。
java.util.List |
java.util.Collection |
java.util.Map |
プリミティブ型の配列 | プリミティブ以外の型の配列 | |
|---|---|---|---|---|---|
| jdk 1.4 | - | - | - | ヘルパー・メソッド arrayToString(array, len) |
Arrays.asList(array) |
| jdk 1.4/1.5、要素数の制限 | member.subList() |
ヘルパー・メソッド toSting(collection, maxLen) |
ヘルパー・メソッド toString(collection, maxLen) および map.entrySet() |
ヘルパー・メソッド arrayToString(array, len, maxLen) |
Arrays.asList(array).subList() |
| jdk 1.5 | - | - | - | Arrays.toString() |
Arrays.asList(array) |
| jdk 1.6 | - | - | - | Arrays.toString() |
Arrays.toString() |
| jdk 1.6、要素数の制限 | member.subList() |
helper method toString(Collection) |
ヘルパー・メソッド toString(Collection) および map.entrySet() |
Arrays.toString(Arrays.copyOf(member, ...)) |
Arrays.asList(array).subList() |
List は通常では subList() メソッドによって処理されますが、Collection (List ではない) 型の別のメンバーが存在して toString(collection) が生成された場合は、List も渡されます。これにより、コードはより短くなり、一貫性も向上します。array != null ? Arrays.asList(array) : null"[]") を使用します。
「toString() の生成」ダイアログ
toString() 生成プログラム: フォーマット・テンプレート
toString() 生成プログラム: コード・スタイル