org.glassfish.grizzly.http.util
Class CharChunk

java.lang.Object
  org.glassfish.grizzly.http.util.CharChunk

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Chunk

public final class CharChunk
extends java.lang.Object
implements Chunk, java.lang.Cloneable, java.io.Serializable

Utilities to manipluate char chunks. While String is the easiest way to manipulate chars ( search, substrings, etc), it is known to not be the most efficient solution - Strings are designed as imutable and secure objects.

Author:

dac@sun.com, James Todd [gonzo@sun.com], Costin Manolache, Remy Maucherat

See Also:

Serialized Form

Nested Class Summary

static interface	CharChunk.CharInputChannel
static interface	CharChunk.CharOutputChannel When we need more space we'll either grow the buffer ( up to the limit ) or send it to a channel.

Constructor Summary

CharChunk()
Creates a new, uninitialized CharChunk object.

CharChunk(int size)

Method Summary

void	allocate(int initial, int limit)
void	append(char b)
void	append(char[] src, int off, int len) Add data to the buffer
void	append(CharChunk src)
void	append(java.lang.String s) Append a string to the buffer
void	append(java.lang.StringBuffer sb) Add data to the buffer
void	append(java.lang.String s, int off, int len) Append a string to the buffer
void	delete(int start, int end)
void	ensureCapacity(int size)
boolean	equals(byte[] b2, int off2, int len2)
boolean	equals(char[] b2, int off2, int len2)
boolean	equals(CharChunk cc)
boolean	equals(java.lang.CharSequence s) Compares the message bytes to the specified String object.
boolean	equalsIgnoreCase(byte[] b) Compares the message bytes to the specified byte array representing ASCII characters.
boolean	equalsIgnoreCase(java.lang.CharSequence s) Compares the message bytes to the specified String object.
boolean	equalsIgnoreCaseLowerCase(byte[] b) Compares the char chunk to the specified byte array representing lower-case ASCII characters.
void	flushBuffer()
char[]	getBuffer()
char[]	getChars()
CharChunk	getClone()
int	getEnd()
int	getInt()
int	getLength() Returns the length of the bytes.
int	getLimit()
int	getStart() Returns the start offset of the bytes.
int	hash()
int	hashIgnoreCase()
int	indexOf(char c)
static int	indexOf(char[] chars, int off, int cend, char qq)
int	indexOf(char c, int starting) Returns true if the message bytes starts with the specified string.
int	indexOf(java.lang.String s, int fromIndex)
int	indexOf(java.lang.String src, int srcOff, int srcLen, int myOff)
boolean	isNull()
void	notifyDirectUpdate() Notify the Chunk that its content is going to be changed directly
void	recycle() Resets the message bytes to an uninitialized state.
void	reset()
protected void	resetStringCache()
void	setCharInputChannel(CharChunk.CharInputChannel in) When the buffer is empty, read the data from the input channel.
void	setCharOutputChannel(CharChunk.CharOutputChannel out) When the buffer is full, write the data to the output channel.
void	setChars(char[] c, int off, int len)
void	setEnd(int i)
void	setLimit(int limit) Maximum amount of data in this buffer.
void	setOptimizedWrite(boolean optimizedWrite)
void	setStart(int start) Returns the start offset of the bytes.
boolean	startsWith(java.lang.String s) Returns true if the message bytes starts with the specified string.
boolean	startsWithIgnoreCase(java.lang.String s, int pos) Returns true if the message bytes starts with the specified string.
int	substract()
int	substract(char[] src, int off, int len)
int	substract(CharChunk src)
java.lang.String	toString()
java.lang.String	toString(int start, int end)
java.lang.String	toStringInternal()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CharChunk

public CharChunk()

Creates a new, uninitialized CharChunk object.

CharChunk

public CharChunk(int size)

Method Detail

getClone

public CharChunk getClone()

isNull

public boolean isNull()

recycle

public void recycle()

Resets the message bytes to an uninitialized state.

reset

public void reset()

allocate

public void allocate(int initial,
                     int limit)

ensureCapacity

public void ensureCapacity(int size)

setOptimizedWrite

public void setOptimizedWrite(boolean optimizedWrite)

setChars

public void setChars(char[] c,
                     int off,
                     int len)

setLimit

public void setLimit(int limit)

Maximum amount of data in this buffer. If -1 or not set, the buffer will grow indefinitely. Can be smaller than the current buffer size ( which will not shrink ). When the limit is reached, the buffer will be flushed ( if out is set ) or throw exception.

getLimit

public int getLimit()

setCharInputChannel

public void setCharInputChannel(CharChunk.CharInputChannel in)

When the buffer is empty, read the data from the input channel.

setCharOutputChannel

public void setCharOutputChannel(CharChunk.CharOutputChannel out)

When the buffer is full, write the data to the output channel. Also used when large amount of data is appended. If not set, the buffer will grow to the limit.

getChars

public char[] getChars()

getBuffer

public char[] getBuffer()

getStart

public int getStart()

Returns the start offset of the bytes. For output this is the end of the buffer.

Specified by:

getStart in interface Chunk

setStart

public void setStart(int start)

Returns the start offset of the bytes.

Specified by:

setStart in interface Chunk

getLength

public int getLength()

Returns the length of the bytes.

Specified by:

getLength in interface Chunk

getEnd

public int getEnd()

Specified by:

getEnd in interface Chunk

setEnd

public void setEnd(int i)

Specified by:

setEnd in interface Chunk

append

public void append(char b)
            throws java.io.IOException

Throws:

java.io.IOException

append

public void append(CharChunk src)
            throws java.io.IOException

Throws:

java.io.IOException

append

public void append(char[] src,
                   int off,
                   int len)
            throws java.io.IOException

Add data to the buffer

Throws:

java.io.IOException

append

public void append(java.lang.StringBuffer sb)
            throws java.io.IOException

Add data to the buffer

Throws:

java.io.IOException

append

public void append(java.lang.String s)
            throws java.io.IOException

Append a string to the buffer

Throws:

java.io.IOException

append

public void append(java.lang.String s,
                   int off,
                   int len)
            throws java.io.IOException

Append a string to the buffer

Throws:

java.io.IOException

delete

public void delete(int start,
                   int end)

Specified by:

delete in interface Chunk

substract

public int substract()
              throws java.io.IOException

Throws:

java.io.IOException

substract

public int substract(CharChunk src)
              throws java.io.IOException

Throws:

java.io.IOException

substract

public int substract(char[] src,
                     int off,
                     int len)
              throws java.io.IOException

Throws:

java.io.IOException

flushBuffer

public void flushBuffer()
                 throws java.io.IOException

Throws:

java.io.IOException

notifyDirectUpdate

public void notifyDirectUpdate()

Notify the Chunk that its content is going to be changed directly

Specified by:

notifyDirectUpdate in interface Chunk

resetStringCache

protected final void resetStringCache()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toString

public java.lang.String toString(int start,
                                 int end)

Specified by:

toString in interface Chunk

toStringInternal

public java.lang.String toStringInternal()

getInt

public int getInt()

equals

public boolean equals(java.lang.CharSequence s)

Compares the message bytes to the specified String object.

Parameters:

s - the String to compare

Returns:

true if the comparison succeeded, false otherwise

equalsIgnoreCase

public boolean equalsIgnoreCase(java.lang.CharSequence s)

Compares the message bytes to the specified String object.

Parameters:

s - the String to compare

Returns:

true if the comparison succeeded, false otherwise

equalsIgnoreCase

public boolean equalsIgnoreCase(byte[] b)

Compares the message bytes to the specified byte array representing ASCII characters.

Parameters:

b - the byte[] to compare

Returns:

true if the comparison succeeded, false otherwise

Since:

2.1.2

equalsIgnoreCaseLowerCase

public boolean equalsIgnoreCaseLowerCase(byte[] b)

Compares the char chunk to the specified byte array representing lower-case ASCII characters.

Parameters:

b - the byte[] to compare

Returns:

true if the comparison succeeded, false otherwise

Since:

2.1.2

equals

public boolean equals(CharChunk cc)

equals

public boolean equals(char[] b2,
                      int off2,
                      int len2)

equals

public boolean equals(byte[] b2,
                      int off2,
                      int len2)

startsWith

public boolean startsWith(java.lang.String s)

Returns true if the message bytes starts with the specified string.

Parameters:

s - the string

startsWithIgnoreCase

public boolean startsWithIgnoreCase(java.lang.String s,
                                    int pos)

Returns true if the message bytes starts with the specified string.

Parameters:

s - the string

hash

public int hash()

hashIgnoreCase

public int hashIgnoreCase()

indexOf

public int indexOf(char c)

indexOf

public int indexOf(char c,
                   int starting)

Returns true if the message bytes starts with the specified string.

Specified by:

indexOf in interface Chunk

Parameters:

c - the character

indexOf

public static int indexOf(char[] chars,
                          int off,
                          int cend,
                          char qq)

indexOf

public final int indexOf(java.lang.String s,
                         int fromIndex)

Specified by:

indexOf in interface Chunk

indexOf

public final int indexOf(java.lang.String src,
                         int srcOff,
                         int srcLen,
                         int myOff)