共同学习Java源代码--常用工具类--AbstractStringBuilder（三）

    public void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)
    {
        if (srcBegin < 0)
            throw new StringIndexOutOfBoundsException(srcBegin);
        if ((srcEnd < 0) || (srcEnd > count))
            throw new StringIndexOutOfBoundsException(srcEnd);
        if (srcBegin > srcEnd)
            throw new StringIndexOutOfBoundsException("srcBegin > srcEnd");
        System.arraycopy(value, srcBegin, dst, dstBegin, srcEnd - srcBegin);

    }

这个方法是将value数组中指定下标区间内的元素拷贝到参数中的数组里。

    public void setCharAt(int index, char ch) {
        if ((index < 0) || (index >= count))
            throw new StringIndexOutOfBoundsException(index);
        value[index] = ch;
    }

这个方法是将value数组指定下标赋值为指定值。

    public AbstractStringBuilder append(Object obj) {
        return append(String.valueOf(obj));
    }

    public AbstractStringBuilder append(String str) {
        if (str == null)
            return appendNull();
        int len = str.length();
        ensureCapacityInternal(count + len);
        str.getChars(0, len, value, count);
        count += len;
        return this;
    }

这两个方法很关键。第一个方法调用第二个方法，第一个方法的参数转换成字符串然后传入第二个方法。

第二个方法先判断参数是否是空串，如果是就调用appendNull方法，这个方法很简单就是将value后面拼一个"null"字符串。

然后先对value数组扩容然后将参数复制到value中count下标之后，然后count自增。

最后返回本字符串对象。

因为返回的是this所以append后是同一对象。

StringBuilder s1=new StringBuilder("a");
StringBuilder s2=s1.append("b");
System.out.println(s1==s2);

这段代码返回true。

    public AbstractStringBuilder append(StringBuffer sb) {
        if (sb == null)
            return appendNull();
        int len = sb.length();
        ensureCapacityInternal(count + len);
        sb.getChars(0, len, value, count);
        count += len;
        return this;
    }

这个方法和上面的几乎一样，就是参数变成的StringBuffer。

    AbstractStringBuilder append(AbstractStringBuilder asb) {
        if (asb == null)
            return appendNull();
        int len = asb.length();
        ensureCapacityInternal(count + len);
        asb.getChars(0, len, value, count);
        count += len;
        return this;
    }

这个方法也和上面的几乎一样，只是参数变成了抽象的AbstractStringBuilder，也就是本类的实现类。

    public AbstractStringBuilder append(CharSequence s) {
        if (s == null)
            return appendNull();
        if (s instanceof String)
            return this.append((String)s);
        if (s instanceof AbstractStringBuilder)
            return this.append((AbstractStringBuilder)s);


        return this.append(s, 0, s.length());
    }

这个方法的参数是CharSequence接口的实现类，方法中对参数进行判断，然后再分别调用相关方法。

private AbstractStringBuilder appendNull() {
        int c = count;
        ensureCapacityInternal(c + 4);
        final char[] value = this.value;
        value[c++] = 'n';
        value[c++] = 'u';
        value[c++] = 'l';
        value[c++] = 'l';
        count = c;
        return this;
    }

这个方法上面提到了，就是先将value扩容，然后在最后拼接一个"null"字符串。