本主题讨论了 toString() 生成器如何列示数组内容以及如何限制 Collection 和 Map 中所列示的项数。所使用的方法不仅取决于成员类型,而且依赖于项目的所选 JDK 兼容性。
Arrays.toString()。由于此方法在 JDK1.4 中不可用,因此在此例中使用了 Arrays.asList(),但是仅用于非基本数组。基本数组由下面所显示的 helper 方法来处理。List.subList() 的 Arrays.asList()。例如,对于一个名为 anArray 的成员,生成的代码与以下内容类似:Arrays.asList(anArray).subList(0, Math.min(anArray.length, maxLen))Arrays.asList(),因此在 JDK1.5 或更低版本中改为使用 helper 方法。在 JDK1.6 中,有另一种解决方案:Arrays.toString(Arrays.copyOf(anArray, Math.min(anArray.length, maxLen))。尽管复制数组并不是最佳解决方案,但是所复制部分通常相当小并且不会影响效率。还有一个好处就是可以避免使用 helper 方法。[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 的有限内容(helper 方法)如果不复制 Collection 的内容,将无法使此 Collection 变为 List(假定它还不是 List),因此,使用 helper 方法来迭代前 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 相同的 helper 方法,只不过传递给 Map 的是 map.entrySet()。
下表总结了在不同情况下使用的方法:
java.util.List |
java.util.Collection |
java.util.Map |
基本类型数组 | 非基本类型数组 | |
|---|---|---|---|---|---|
| jdk 1.4 | - | - | - | helper 方法 arrayToString(array, len) |
Arrays.asList(array) |
| jdk 1.4/1.5,限制元素数 | member.subList() |
helper 方法 toSting(collection, maxLen) |
helper 方法 - 带有 map.entrySet() 的 toString(collection, maxLen) |
helper 方法 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 方法 toString(Collection) |
helper 方法 - 带有 map.entrySet() 的 toString(Collection) |
Arrays.toString(Arrays.copyOf(member, ...)) |
Arrays.asList(array).subList() |
subList() 方法来处理 List,但是,如果有 Collection(而不是 List)类型的另一个成员并且生成了 toString(collection),那么也会将 List 传递给此成员。因此,代码更简短并且更一致。array != null ? Arrays.asList(array) : null"[]")而不使用上面所描述的方法。