len chars to this buffer from the given source
+ * array starting at index off. The capacity of the buffer
+ * is increased, if necessary, to accommodate all len chars.
+ *
+ * @param b the chars to be appended.
+ * @param off the index of the first char to append.
+ * @param len the number of chars to append.
+ * @throws IndexOutOfBoundsException if off is out of
+ * range, len is negative, or
+ * off + len is out of range.
+ */
+ public void append(final char[] b, int off, int len) {
+ if (b == null) {
+ return;
+ }
+ if ((off < 0) || (off > b.length) || (len < 0) ||
+ ((off + len) < 0) || ((off + len) > b.length)) {
+ throw new IndexOutOfBoundsException("off: "+off+" len: "+len+" b.length: "+b.length);
+ }
+ if (len == 0) {
+ return;
+ }
+ int newlen = this.len + len;
+ if (newlen > this.buffer.length) {
+ expand(newlen);
+ }
+ System.arraycopy(b, off, this.buffer, this.len, len);
+ this.len = newlen;
+ }
+
+ /**
+ * Appends chars of the given string to this buffer. The capacity of the
+ * buffer is increased, if necessary, to accommodate all chars.
+ *
+ * @param str the string.
+ */
+ public void append(String str) {
+ if (str == null) {
+ str = "null";
+ }
+ int strlen = str.length();
+ int newlen = this.len + strlen;
+ if (newlen > this.buffer.length) {
+ expand(newlen);
+ }
+ str.getChars(0, strlen, this.buffer, this.len);
+ this.len = newlen;
+ }
+
+ /**
+ * Appends len chars to this buffer from the given source
+ * buffer starting at index off. The capacity of the
+ * destination buffer is increased, if necessary, to accommodate all
+ * len chars.
+ *
+ * @param b the source buffer to be appended.
+ * @param off the index of the first char to append.
+ * @param len the number of chars to append.
+ * @throws IndexOutOfBoundsException if off is out of
+ * range, len is negative, or
+ * off + len is out of range.
+ */
+ public void append(final CharArrayBuffer b, int off, int len) {
+ if (b == null) {
+ return;
+ }
+ append(b.buffer, off, len);
+ }
+
+ /**
+ * Appends all chars to this buffer from the given source buffer starting
+ * at index 0. The capacity of the destination buffer is
+ * increased, if necessary, to accommodate all {@link #length()} chars.
+ *
+ * @param b the source buffer to be appended.
+ */
+ public void append(final CharArrayBuffer b) {
+ if (b == null) {
+ return;
+ }
+ append(b.buffer,0, b.len);
+ }
+
+ /**
+ * Appends ch char to this buffer. The capacity of the buffer
+ * is increased, if necessary, to accommodate the additional char.
+ *
+ * @param ch the char to be appended.
+ */
+ public void append(char ch) {
+ int newlen = this.len + 1;
+ if (newlen > this.buffer.length) {
+ expand(newlen);
+ }
+ this.buffer[this.len] = ch;
+ this.len = newlen;
+ }
+
+ /**
+ * Appends len bytes to this buffer from the given source
+ * array starting at index off. The capacity of the buffer
+ * is increased, if necessary, to accommodate all len bytes.
+ *
+ * The bytes are converted to chars using simple cast.
+ *
+ * @param b the bytes to be appended.
+ * @param off the index of the first byte to append.
+ * @param len the number of bytes to append.
+ * @throws IndexOutOfBoundsException if off is out of
+ * range, len is negative, or
+ * off + len is out of range.
+ */
+ public void append(final byte[] b, int off, int len) {
+ if (b == null) {
+ return;
+ }
+ if ((off < 0) || (off > b.length) || (len < 0) ||
+ ((off + len) < 0) || ((off + len) > b.length)) {
+ throw new IndexOutOfBoundsException("off: "+off+" len: "+len+" b.length: "+b.length);
+ }
+ if (len == 0) {
+ return;
+ }
+ int oldlen = this.len;
+ int newlen = oldlen + len;
+ if (newlen > this.buffer.length) {
+ expand(newlen);
+ }
+ for (int i1 = off, i2 = oldlen; i2 < newlen; i1++, i2++) {
+ this.buffer[i2] = (char) (b[i1] & 0xff);
+ }
+ this.len = newlen;
+ }
+
+ /**
+ * Appends len bytes to this buffer from the given source
+ * array starting at index off. The capacity of the buffer
+ * is increased, if necessary, to accommodate all len bytes.
+ *
+ * The bytes are converted to chars using simple cast.
+ *
+ * @param b the bytes to be appended.
+ * @param off the index of the first byte to append.
+ * @param len the number of bytes to append.
+ * @throws IndexOutOfBoundsException if off is out of
+ * range, len is negative, or
+ * off + len is out of range.
+ */
+ public void append(final ByteArrayBuffer b, int off, int len) {
+ if (b == null) {
+ return;
+ }
+ append(b.buffer(), off, len);
+ }
+
+ /**
+ * Appends chars of the textual representation of the given object to this
+ * buffer. The capacity of the buffer is increased, if necessary, to
+ * accommodate all chars.
+ *
+ * @param obj the object.
+ */
+ public void append(final Object obj) {
+ append(String.valueOf(obj));
+ }
+
+ /**
+ * Clears content of the buffer. The underlying char array is not resized.
+ */
+ public void clear() {
+ this.len = 0;
+ }
+
+ /**
+ * Converts the content of this buffer to an array of chars.
+ *
+ * @return char array
+ */
+ public char[] toCharArray() {
+ char[] b = new char[this.len];
+ if (this.len > 0) {
+ System.arraycopy(this.buffer, 0, b, 0, this.len);
+ }
+ return b;
+ }
+
+ /**
+ * Returns the char value in this buffer at the specified
+ * index. The index argument must be greater than or equal to
+ * 0, and less than the length of this buffer.
+ *
+ * @param i the index of the desired char value.
+ * @return the char value at the specified index.
+ * @throws IndexOutOfBoundsException if index is
+ * negative or greater than or equal to {@link #length()}.
+ */
+ public char charAt(int i) {
+ return this.buffer[i];
+ }
+
+ /**
+ * Returns reference to the underlying char array.
+ *
+ * @return the char array.
+ */
+ public char[] buffer() {
+ return this.buffer;
+ }
+
+ /**
+ * Returns the current capacity. The capacity is the amount of storage
+ * available for newly appended chars, beyond which an allocation will
+ * occur.
+ *
+ * @return the current capacity
+ */
+ public int capacity() {
+ return this.buffer.length;
+ }
+
+ /**
+ * Returns the length of the buffer (char count).
+ *
+ * @return the length of the buffer
+ */
+ public int length() {
+ return this.len;
+ }
+
+ /**
+ * 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. If the required
+ * argument is non-positive, this method takes no action.
+ *
+ * @param required the minimum required capacity.
+ */
+ public void ensureCapacity(int required) {
+ if (required <= 0) {
+ return;
+ }
+ int available = this.buffer.length - this.len;
+ if (required > available) {
+ expand(this.len + required);
+ }
+ }
+
+ /**
+ * Sets the length of the buffer. The new length value is expected to be
+ * less than the current capacity and greater than or equal to
+ * 0.
+ *
+ * @param len the new length
+ * @throws IndexOutOfBoundsException if the
+ * len argument is greater than the current
+ * capacity of the buffer or less than 0.
+ */
+ public void setLength(int len) {
+ if (len < 0 || len > this.buffer.length) {
+ throw new IndexOutOfBoundsException("len: "+len+" < 0 or > buffer len: "+this.buffer.length);
+ }
+ this.len = len;
+ }
+
+ /**
+ * Returns true if this buffer is empty, that is, its
+ * {@link #length()} is equal to 0.
+ * @return true if this buffer is empty, false
+ * otherwise.
+ */
+ public boolean isEmpty() {
+ return this.len == 0;
+ }
+
+ /**
+ * Returns true if this buffer is full, that is, its
+ * {@link #length()} is equal to its {@link #capacity()}.
+ * @return true if this buffer is full, false
+ * otherwise.
+ */
+ public boolean isFull() {
+ return this.len == this.buffer.length;
+ }
+
+ /**
+ * Returns the index within this buffer of the first occurrence of the
+ * specified character, starting the search at the specified
+ * beginIndex and finishing at endIndex.
+ * If no such character occurs in this buffer within the specified bounds,
+ * -1 is returned.
+ *
+ * There is no restriction on the value of beginIndex and
+ * endIndex. If beginIndex is negative,
+ * it has the same effect as if it were zero. If endIndex is
+ * greater than {@link #length()}, it has the same effect as if it were
+ * {@link #length()}. If the beginIndex is greater than
+ * the endIndex, -1 is returned.
+ *
+ * @param ch the char to search for.
+ * @param beginIndex the index to start the search from.
+ * @param endIndex the index to finish the search at.
+ * @return the index of the first occurrence of the character in the buffer
+ * within the given bounds, or -1 if the character does
+ * not occur.
+ */
+ public int indexOf(int ch, int beginIndex, int endIndex) {
+ if (beginIndex < 0) {
+ beginIndex = 0;
+ }
+ if (endIndex > this.len) {
+ endIndex = this.len;
+ }
+ if (beginIndex > endIndex) {
+ return -1;
+ }
+ for (int i = beginIndex; i < endIndex; i++) {
+ if (this.buffer[i] == ch) {
+ return i;
+ }
+ }
+ return -1;
+ }
+
+ /**
+ * Returns the index within this buffer of the first occurrence of the
+ * specified character, starting the search at 0 and finishing
+ * at {@link #length()}. If no such character occurs in this buffer within
+ * those bounds, -1 is returned.
+ *
+ * @param ch the char to search for.
+ * @return the index of the first occurrence of the character in the
+ * buffer, or -1 if the character does not occur.
+ */
+ public int indexOf(int ch) {
+ return indexOf(ch, 0, this.len);
+ }
+
+ /**
+ * Returns a substring of this buffer. The substring begins at the specified
+ * beginIndex and extends to the character at index
+ * endIndex - 1.
+ *
+ * @param beginIndex the beginning index, inclusive.
+ * @param endIndex the ending index, exclusive.
+ * @return the specified substring.
+ * @exception StringIndexOutOfBoundsException if the
+ * beginIndex is negative, or
+ * endIndex is larger than the length of this
+ * buffer, or beginIndex is larger than
+ * endIndex.
+ */
+ public String substring(int beginIndex, int endIndex) {
+ return new String(this.buffer, beginIndex, endIndex - beginIndex);
+ }
+
+ /**
+ * Returns a substring of this buffer with leading and trailing whitespace
+ * omitted. The substring begins with the first non-whitespace character
+ * from beginIndex and extends to the last
+ * non-whitespace character with the index lesser than
+ * endIndex.
+ *
+ * @param beginIndex the beginning index, inclusive.
+ * @param endIndex the ending index, exclusive.
+ * @return the specified substring.
+ * @exception IndexOutOfBoundsException if the
+ * beginIndex is negative, or
+ * endIndex is larger than the length of this
+ * buffer, or beginIndex is larger than
+ * endIndex.
+ */
+ public String substringTrimmed(int beginIndex, int endIndex) {
+ if (beginIndex < 0) {
+ throw new IndexOutOfBoundsException("Negative beginIndex: "+beginIndex);
+ }
+ if (endIndex > this.len) {
+ throw new IndexOutOfBoundsException("endIndex: "+endIndex+" > length: "+this.len);
+ }
+ if (beginIndex > endIndex) {
+ throw new IndexOutOfBoundsException("beginIndex: "+beginIndex+" > endIndex: "+endIndex);
+ }
+ while (beginIndex < endIndex && HTTP.isWhitespace(this.buffer[beginIndex])) {
+ beginIndex++;
+ }
+ while (endIndex > beginIndex && HTTP.isWhitespace(this.buffer[endIndex - 1])) {
+ endIndex--;
+ }
+ return new String(this.buffer, beginIndex, endIndex - beginIndex);
+ }
+
+ public String toString() {
+ return new String(this.buffer, 0, this.len);
+ }
+
+}