StringBuilder Sınıfı

Giriş
Şu satırı dahil ederiz.

import java.lang.StringBuilder;

Açıklaması şöyle

StringBuilder is not thread-safe and an instance can be shared across multiple threads

Bu sınıfın kardeşi olan StringBuffer sınıfı thread safe'tir.

constructor
Şöyle yaparız.

StringBuilder sb = new StringBuilder ();

constructor - CharSequence
Metodun içi şöyle.

public StringBuilder(String str) {
  super(str.length() + 16);
   append(str);
}

constructor - String
Metodun içi şöyle.

public StringBuilder(String str) {
  super(str.length() + 16);
  append(str);
}

Örnek
Şöyle yaparız.

String str = "...";

StringBuilder sb = new StringBuilder (str);

append metodu - CharSequence
Örnek
Java 8 Stream'leri ile şöyle kullanılır.

StringBuilder sb = 
    p.stream()
     .filter( p -> p.lastName.equals("kent"))
     .map(p -> p.lastName)
     .collect(StringBuilder::new,
              StringBuilder::append,
              StringBuilder::append);

Örnek
Şöyle yaparız

StringBuilder sb =list.stream().parallel()
  .collect(
    StringBuilder::new, 
    StringBuilder::append, 
    StringBuilder::append
  )
);

appendCodePoint metodu - int
Şöyle yaparız. String.chars() int dizisi döndürür.

public static String removeDuplicateLetters(String s) {
    return s.chars().sorted().distinct().collect(
        StringBuilder::new,
        StringBuilder::appendCodePoint,
        StringBuilder::append
    ).toString();
}

capacity metodu
Şöyle yaparız

StringBuilder sb = new StringBuilder();
System.out.println(sb.capacity());

ensureCapacity metodu
Açıklaması şöyle

Ensures that the capacity is at least equal to the specified minimum. If the current capacity is less than the argument, then a new internal array is allocated with greater capacity. The new capacity is the larger of:

• The minimumCapacity argument.
• Twice the old capacity, plus 2.

If the minimumCapacity argument is nonpositive, this method takes no action and simply returns.

equals metodu
Bu sınıf equals metodunu override etmez. Şu kod false döner.

StringBuilder sb1 = new StringBuilder("string");
StringBuilder sb2 = new StringBuilder("string");

System.out.println(sb1.equals(sb2));

indexOf metodu
Şöyle yaparız.

int index = sb.indexOf ("kent");

length metodu
Şöyle yaparız

StringBuilder sb = new StringBuilder();
System.out.println(sb.length());

repeat metodu

Java 21 ile geliyor. İmzası şöyle

StringBuilder repeat(CharSequence cs,
                    int count)
StringBuilder repeat(int codePoint,
                     int count)

Örnek

Şöyle yaparız

var santaBuilder = new StringBuilder();
santaBuilder.repeat("Ho! ", 3);

var str = santaBuilder.toString()
// => "Ho! Ho! Ho! "

replace metodu

Şöyle yaparız.

int index = ...;
sb.replace (index, index + 2, ":");

reverse metodu
Şöyle yaparız.

StringBuilder reversedSb = sb.reverse ();

toString metodu
Metodun içi şöyle.

public String toString() {
  // Create a copy, don't share the array
  return new String(value, 0, count);
}

Şöyle yaparız.

String str = sb.toString()

Try With Resources

Giriş

try-with-resources kullanımıyla finally yazmaya gerek kalmıyor. Aslında finally bazen kafa karıştırıcı olabilir.

Örnek

Elimizde şöyle bir kod olsun. finally her zaman çalıştığı için sonuç olarak "Intelligent Boy!" alırız.

public static void main(String[] args) {
  System.out.println(checkBoy());
}
public static String checkBoy() {
  try {
    return "Good Boy!";
  } catch(Exception e) {
    return "Bad Boy!";
  } finally {
    return "Intelligent Boy!";
  }
}

Örnek

Kapatılmasını istediğimiz her kaynak bir değişkene atanmak zorundadır. Şöyle yaparız

try (Connection connection = DriverManager.getConnection(...);
     Statement statement = connection.createStatement();
     ResultSet resultSet = statement.executeQuery(sql)) {
    // ...   
}

Bazen kapatılan kaynak kendisine constructor içinde verilen kaynağı da kapatır. Bu durumda şöyle yapabiliriz

try (BufferedWriter bw = new BufferedWriter(new FileWriter(...)) {
    // ...   
}

try İçinde Exception Fırlatılırsa

Sadece finally işletilir

Örnek

Elimizde şöyle bir kod olsun

public static class Resource implements AutoCloseable {

  public Resource() throws Exception {
    throw new Exception("Exception from constructor");
  }

  public void doSomething() throws Exception {
    throw new Exception("Exception from method");
  }

  @Override
  public void close() throws Exception {
    throw new Exception("Exception from closeable");
  }
}

public static void main(String[] args) {
  try(Resource r = new Resource()) {
    r.doSomething();
  } catch (Exception ex) {
    ex.printStackTrace();
  }
}

Yakalanan exception nesnesinin detailMessage alanında "Exception from constructor" görürüz. finally block çalıştırılmaz.

work İçinde Exception Fırlatılırsa

Throwable nesnesinin suppressed alanında görebiliriz.

Örnek
Şöyle yaparız

try (Connection c = DriverManager.getConnection(url)) {
    work();
} catch (Exception e) {
    throw new Error("Insert failed", e);
}

Eğer hem work() hem de Connection.close() metodu içinde exception fırlatılırsa close() tarafından fırlatılan exception Throwable nesnesinin suppressed alanında görürüz.
Açıklaması şöyle

This will close your connection or generally the passed AutoCloseable appropriately. And will handle the shadowing of the exception by using the Throwable.addSuppressed() method.

Çıktı olarak şuna benzer bir şey alırız. Koyu kısım suppressed olan ve close() metodundan gelen exception.

>>> work()
  >>> close()
  MyException: Exception in work()
    at AutoClose.work(AutoClose.java:11)
    at AutoClose.main(AutoClose.java:16)    Suppressed: java.lang.RuntimeException: Exception in close()
      at AutoClose.close(AutoClose.java:6)
      at AutoClose.main(AutoClose.java:17)