toString() 生成器:内容列示

本主题讨论了 toString() 生成器如何列示数组内容以及如何限制 Collection 和 Map 中所列示的项数。所使用的方法不仅取决于成员类型,而且依赖于项目的所选 JDK 兼容性。

列示数组的内容

列示 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()

其他注意事项

相关参考

“生成 toString()”对话框
toString() 生成器:格式模板
toString() 生成器:代码样式