Este tópico aborda a forma como o gerador toString() lista conteúdos de matrizes e como limita o
número de elementos listados em Collections e Maps. O método utilizado
depende não só do tipo de membro, mas também da selecção da compatibilidade de JDK do projecto.
Arrays.toString(). Como este método não está disponível no JDK1.4, é utilizado Arrays.asList() em seu lugar neste caso, mas apenas para matrizes não primitivas. As matrizes primitivas são tratadas com o método Helper, explicado abaixo.Arrays.asList() com List.subList(). Por exemplo, para um membro com o nome anArray, o código gerado é semelhante ao seguinte: Arrays.asList(anArray).subList(0, Math.min(anArray.length, maxLen))Arrays.asList(), por isso, no JDK1.5 ou anterior, é utilizado um método Helper em seu lugar. No JDK1.6, existe outra solução: Arrays.toString(Arrays.copyOf(anArray, Math.min(anArray.length, maxLen)). Embora copiar uma matriz não seja uma solução óptima, a parte copiada é normalmente bastante pequena e a eficiência não é afectada. Um aspecto positivo é que o método Helper pode ser evitado.[1, 2, 3]. O método faz a iteração da matriz e utiliza instanceof para determinar o seu tipo delimitador. Para encurtar o código, verifica apenas os tipos que podem de facto ser passados para a lista.
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();
}
NOTAS:maxLen e não utiliza Math.min()ListsÉ utilizada a mesma solução em todas as versões de JDK: aList.subList(0, Math.min(aList.size(), maxLen))
Collections (método Helper)Uma Collection não pode ser transformada numa List sem copiar os seus conteúdos (assumindo que não se trata já de uma List) e, por isso, é utilizado um método Helper para iterar os primeiros elementos maxLen e construir uma cadeia a partir dos mesmos:
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();
}
NOTAS:MapsNo caso de Maps, é utilizado o mesmo método Helper que o utilizado para
Collections apenas com a diferença que map.entrySet() é passado
para Maps.
Esta tabela resume os métodos utilizados em diferentes condições:
java.util.List |
java.util.Collection |
java.util.Map |
Matriz de tipo primitiva | Matriz de tipo não primitiva | |
|---|---|---|---|---|---|
| jdk 1.4 | - | - | - | método Helper arrayToString(array, len) |
Arrays.asList(matriz) |
| jdk 1.4/1.5, limitar elementos | member.subList() |
método Helper toSting(collection, maxLen) |
método Helper toString(collection, maxLen) com map.entrySet() |
método Helper arrayToString(matriz, comp, compMáx) |
Arrays.asList(matriz).subList() |
| jdk 1.5 | - | - | - | Arrays.toString() |
Arrays.asList(matriz) |
| jdk 1.6 | - | - | - | Arrays.toString() |
Arrays.toString() |
| jdk 1.6, limitar elementos | member.subList() |
método Helper toString(Collection) |
método Helper toString(Collection) com map.entrySet() |
Arrays.toString(Arrays.copyOf(membro, ...)) |
Arrays.asList(matriz).subList() |
List é normalmente processado pelo método subList(), mas se existir outro membro de
tipo Collection (que não List) e o toString(collection) for gerado, Lists também são passados para o código gerado. Desta forma, o código é encurtado e é mais consistente.array != null ? Arrays.asList(matriz) : null"[]") em vez dos métodos descritos acima.
Caixa de diálogo Gerar to(String)
Gerador toString(): Modelos de formatos
Gerador toString(): Estilos de código