Adds the given array into the composite buffer at the end.
<p>
The appended array is not copied so changes to the source array are visible in this
buffer and vice versa. If this composite was empty than it would return true for the
{@link #hasArray()} method until another array is appended.
<p>
Calling this method resets the limit to the new _capacity.
@param array
The array to add to this composite buffer.
@throws IllegalArgumentException if the array is null or zero size.
@throws IllegalStateException if the buffer does not allow appends.
@return a reference to this {@link CompositeReadableBuffer}.
Adds the given array into the composite buffer at the end. <p> The appended array is not copied so changes to the source array are visible in this buffer and vice versa. If this composite was empty than it would return true for the {@link #hasArray()} method until another array is appended. <p> Calling this method resets the limit to the new _capacity.
@param array The array to add to this composite buffer.
@throws IllegalArgumentException if the array is null or zero size. @throws IllegalStateException if the buffer does not allow appends.
@return a reference to this {@link CompositeReadableBuffer}.