A Classe StringBuilder em Java

Classe StringBuilder

A classe StringBuilder faz parte do pacote java.lang. Essa classe permite criar e manipular dados de Strings dinamicamente, ou seja, podem criar vari�veis de String modific�veis.

O significado da classe StringBuilder n�o tem o mesmo sentido que classe String. Existe uma diferença entre essas classes, veja algumas caracter�sticas.

Caracter�sticas StringBuilder

Armazena caracteres especificados pela sua capacidade, caso ela seja excedida, � aumentada para acomodar os caracteres adicionais;
N�o precisa alocar novos objetos quando realiza uma concatenaç�o;
N�o s�o sincronizadas;
N�o s�o seguras para threads;

Uma vantagem sobre a classe String � a concatenaç�o de strings. Pois quando concatena strings com StringBuilder � invocado o m�todo append. Esse m�todo aloca novas strings concatenadas para o mesmo objeto, ou seja, cada vez que concatena strings n�o s�o criadas c�pias dos objetos como � realizado pelo m�todo concat da classe String, contribuindo para um melhor desempenho do sistema.

Listagem 1: Concatenaç�o de Strings com m�todo append.


public class TestaStringBuilder {
         public static void main(String[] args) {
    
  StringBuilder nomes = new StringBuilder();
    nomes.append("Carlos>").append("Maria>").append("Jos�>").append("Renata");
    
  System.out.println(nomes.toString());
  
        }
}

Figura 1: Ilustraç�o gr�fica do c�digo da Listagem 1.

M�todos StringBuilder

Abaixo s�o apresentados os m�todos principais e mais utilizados.

length - Retorna o n�mero de caracteres atualmente em um StringBuilder;
capacity � Retorna o n�mero de caracteres que pode ser armazenado em um StringBuilder sem alocar mais mem�ria;
ensureCapacity � Garante que um StringBuilder tenha pelo menos a capacidade especificada;
setLength � Aumenta ou diminui o comprimento de uma StringBuilder;
charAt � Aceita um argumento inteiro que representa o �ndice e retorna o caractere nessa posiç�o no StringBuilder;
setCharAt � Copia caracteres de um StringBuilder no array de caracteres passado como um argumento, tendo aceitaç�o de at� 4 argumentos;

o �ndice inicial a partir do qual os caractere(s) devem ser copiados do StringBuilder;
o �ndice um a mais do �ltimo caractere que ser� copiado a partir do StringBuilder;
o array de caracteres para onde os caracteres ser�o copiados;
localizaç�o inicial no array de caracteres em que o primeiro caractere deve ser colocado;

getChars � Retorna o caractere especificado;

reverse � Retorna os caracteres invertidos;

Listagem 2: M�todos capacity, ensureCapacity, setLength e length.


public class Metodos_StringBuilder {

  public static void main(String[] args) {
    
      StringBuilder buffer = new StringBuilder("Jo�o Silveira Batista");
      System.out.printf(" buffer = %s\n tamanho = %d\n capacidade (%d (tamanho) + " +
        "16(valor inicial padr�o)) = %d\n\n",
        buffer.toString(),buffer.length(),buffer.length(),buffer.capacity());
    
    //EXPANDE A CAPACIDADE P/ 75 CARACTERES
    buffer.ensureCapacity(75);
    System.out.printf("Nova Capacidade = %d\n\n", buffer.capacity());
    
    //REDEFINE O TAMANHO, N�O APARECENDO OS CARACTERES 
    // SE O ARGUMENTO FOR MENOR QUE A QUANTIDADE DE CARACTERES ORIGINAL
    buffer.setLength(10);
    System.out.printf("Novo tamanho = %d\n buffer = %s\n",buffer.length(), 
        buffer.toString());
  }
}

Listagem 3: M�todos charAt, setChar e reverse.


public class Metodos2_StringBuilder {

  public static void main(String[] args) {
    
    StringBuilder buffer = new StringBuilder("Usando outros m�todos StringBuilder");
    
    System.out.printf("buffer = %s\n", buffer.toString());
    System.out.printf("Caractere index 0: %s\nCaractere index 4: " +
        "%s\n\n",buffer.charAt(0),buffer.charAt(4));
    
    char[] charArray = new char[buffer.length()];
    
    buffer.getChars(0, buffer.length(), charArray, 0);
    System.out.print("Os caracteres s�o: ");
    
    for(char c : charArray)
      System.out.print(c);
    
    buffer.setCharAt(0, 'O');
    buffer.setCharAt(4, 'P');
    
    System.out.printf("\n\nbuffer = %s", buffer.toString());
    
    buffer.reverse();
    System.out.printf("\n\nbuffer = %s\n", buffer.toString());
  }
}

Construtores StringBuilder

Nessa classe existem quatro tipos de construtores que s�o apresentados abaixo, lembrando que quando � declarado o construtor sem argumentos a capacidade inicial � identificada com 16 caracteres.

Listagem 4: Construtores.


public class Contrutores_StringBuilder {
  public static void main(String[] args) {
    StringBuilder buffer1 = new StringBuilder();
    StringBuilder buffer2 = new StringBuilder(5655);
    StringBuilder buffer3 = new StringBuilder("Texto Qualquer");
    
    System.out.printf("buffer1 = \"%s\"\n", buffer1.toString());
    System.out.printf("buffer2 = \"%s\"\n", buffer2.toString());
    System.out.printf("buffer3 = \"%s\"\n", buffer3.toString());
  }
}

M�todo insert

Os m�todos insert sobrecarregados inserem valores de v�rios tipos (primitivos, arrays de caracteres, Strings, Objects e CharSequences) em qualquer posiç�o de um StringBuilder.

Existem alguns cuidados nesses tipos de operaç�o, pois se inserir um n�mero maior que um comprimento da StringBuilder ou menor que 0, ir� estourar uma exceç�o StringIndexOutBoundsException.

Listagem 5: M�todo insert.


public class StringBuilder_Insert {
  public static void main(String[] args) {  
    Object objetoRef = "Maria";
    String String = "Joaquina";
    char[] conjArray = {'S','i','l','v','a'};

    StringBuilder buffer = new StringBuilder(); 
    buffer.insert(0, objetoRef);
    buffer.insert(0, " ");
    buffer.insert(0, String);
    buffer.insert(0, " ");
    buffer.insert(0, conjArray);
    buffer.insert(0, " ");
    
    System.out.printf("Valores:\n%s\n\n", buffer.toString()); 
  }
}

M�todo delete

Os m�todos delete excluem caracteres em qualquer posiç�o em um StringBuilder, aceitando 2 argumentos sendo que um deles � o �ndice inicial e o �ndice a mais do fim dos caracteres a excluir. O m�todo deleteCharAt aceita um argumento que � o �ndice do caractere a excluir.

Listagem 6: M�todo delete.


public class StringBuilder_Delete {
  public static void main(String[] args) {  
    Object objetoRef = "Maria";
    String String = "Joaquina";
    char[] conjArray = {'S','i','l','v','a'};
    
    StringBuilder buffer = new StringBuilder();
    
    buffer.insert(0, objetoRef);
    buffer.insert(0, " ");
    buffer.insert(0, String);
    buffer.insert(0, " ");
    buffer.insert(0, conjArray);
    buffer.insert(0, " ");  
    System.out.printf("Valores antes do delete:\n%s\n\n", buffer.toString()); 
    
    buffer.delete(0, 2);
    buffer.deleteCharAt(4); 
    System.out.printf("Valores depois do delete:\n%s\n\n", buffer.toString());
  }
}

Para saber mais dos m�todos acesse.