StringBuilderAPI的常用方法

StringBuilder 是一个可变的字符序列。它继承于AbstractStringBuilder，实现了CharSequence接口。
StringBuffer 也是继承于AbstractStringBuilder的子类；但是，StringBuilder和StringBuffer不同，前者是非线程安全的，后者是线程安全的。

StringBuilder 和 CharSequence之间的关系图如下：

构造方法：
public StringBuilder()：构造一个不带任何字符的字符生成器，其初始容器为16个字符
public StringBuilder(String str)：构造一个字符串生成器，并初始化为指定的字符串内容
代码例子如下：

 public static void main(String[] args) {
        /*String str = "a" + "b" + "c";
        String str2 = "abc";*/
        String str = new String("abc");
        StringBuilder stringBuilder = new StringBuilder(str);
        System.out.println("使用带参的构造方法生成的字符串缓冲区："+stringBuilder);

        //空参构造方法
        StringBuilder builder = new StringBuilder();
        System.out.println("空参构造的字符串缓冲区：" + builder);//""
        String s1 = builder.toString();
        
        StringBuilder builder2 = new StringBuilder();
        System.out.println("空参构造的字符串缓冲区：" + builder2);//""
        String s2 = builder2.toString();
        //equals()
        boolean result1 = builder.equals(builder2);
        System.out.println(result1);//false
        boolean result2 = s1.equals(s2);
        System.out.println(result2);//true

    }

常用方法：

• public StringBuilder append(…): 添加任意类型数据的字符串形式，并返回当前对象本身

• 返回的容量至少与给定的最小容量一样大。
  

• 返回当前容量增加相同数量+ 2，如果那就足够了。
  

• 不会返回大于{@code MAX_ARRAY_SIZE}的容量 Integer.MAX_ARRAY_SIZE-8
• 除非给定的最小容量大于该容量。
• 如果这个最大的容量还不够，内存溢出。 throw new OutOfMemoryError();
  关于StringBuilder扩容代码演示如下例子如下
  代码一

 StringBuilder bu = new StringBuilder();
 System.out.println(bu.capacity()+"----"+bu.length());//这里StringBuilder的初始数量为16
 bu.append("0000000000000000");//此时这里有16个0
 System.out.println(bu.capacity()+"----"+bu.length());

输出结果如下:

代码二

        StringBuilder bu = new StringBuilder();
        System.out.println(bu.capacity()+"----"+bu.length());//这里StringBuilder的初始数量为16
        bu.append("0000000000000000");//此时这里有16个0
        bu.append("0");//这里添加一个0
        System.out.println(bu.capacity()+"----"+bu.length());

结果值如下：

此时的StringBuilder容器的为34个字符，在StringBuilder中添加了17个字符，StringBuilder的确是扩容了两倍，按照StringBuilder底层源码来计算的话，新的StringBuilder容器字符数=初始容器的16个字符*2+2（也就是34）
代码三：

StringBuilder bu = new StringBuilder();
        System.out.println(bu.capacity()+"----"+bu.length());//这里StringBuilder的初始数量为16
        bu.append("0000000000000000000000000000000000000");//此时这里是37个0    输出结果为    37----37
        System.out.println(bu.capacity()+"----"+bu.length());

结果值如下：

如果按照这代码上来说它确实只扩容了一次，但是咱们只添加了一次元素，这个时候如果我们在下面在添加一个元素’

代码四：

 StringBuilder bu = new StringBuilder();
        System.out.println(bu.capacity()+"----"+bu.length());//这里StringBuilder的初始数量为16
        bu.append("0000000000000000000000000000000000000");//此时这里是37个0    输出结果为    37----37
        System.out.println(bu.capacity()+"----"+bu.length());
        bu.append("0");//此时这里又添加了一个0
        System.out.println(bu.capacity()+"----"+bu.length());

结果值如下：

现在看输出结果就又双倍扩容了。通过这几个例子，我发现如果只添加一次，并且超出了容量的2倍+2也就是34，的话StringBuilder的容量就是 StringBuilder的长度。也就是说StringBuilder添加一次执行一次Append()方法只会进行一次2倍容量+2的扩容，如果它的实际长度比容量要大的话，它的实际长度就是它的容量。
代码五：

 StringBuilder bu = new StringBuilder();
        System.out.println(bu.capacity()+"----"+bu.length());//这里StringBuilder的初始数量为16
        bu.append("0000000000000000000000000000000000000");//此时这里是37个0    输出结果为    37----37
        System.out.println(bu.capacity()+"----"+bu.length());
        bu.append("0000000000000000000000000000000000000000000");//此时这里改为47个0
        System.out.println(bu.capacity()+"----"+bu.length());

结果值如下：

• 这个例子就证实了我们的结论，每调用Append()方法只能进行一次扩容。
• 经过仔细查证源码发现，它Append()在执行的时候会判断添加的元素之前会判断现在的容量是否已满，已满的话会进行一次双倍扩容，当然不管你添加多少元素它只扩容一次，在添加完成之后，容量会和实际数量进行判断，实际数量大于容量容量就等于实际容量，当然前提是你没有设置StringBuilder的最大容量。
  StringBuiler和String可以进行相互转换：
• StringBuilder可以和String进行相互转换
• String—>StringBuilder：可以使用StringBuilder的带参构造方法
• StringBuilder(String str) 构造一个字符串生成器，并初始化为指定的字符串内容
• StringBuilder---->String：可以使用StringBuilder类中的toString()方法
• public String toString()：将当前的StringBuilder对象转换成String对象
  代码演示如下：

public static void main(String[] args) {
        // String--->StringBuilder
        String str = "Hello World";
        System.out.println("str:" + str);
        StringBuilder bu = new StringBuilder(str);
        // 添加一些数据
        bu.append("---Java");
        System.out.println("bu:" + bu);//Hello World---Java

        // StringBuilder---->String
        String s = bu.toString();
        System.out.println("s:" + s);//Hello World---Java

        System.out.println(s.equals(bu));// false  Hello World---Java

    }

• StringBuilder类的常用方法
• public StringBuilder insert(int offset,…):根据指定的位置插入类型数据的字符串形式，返回的是当前对象
• 不管存储什么类型的数据，进入字符串缓冲区都变成了字符值。

代码例子如下：

  //构建StringBuilder对象
        StringBuilder bu = new StringBuilder();
        //调用insert方法
        StringBuilder bu2 = bu.insert(0, "A");
        System.out.println(bu2);
        System.out.println(bu);

好了就到这里把! 也请各路大神指正！！