Package net.officefloor.server.buffer

Class StreamBufferByteSequence

java.lang.Object

net.officefloor.server.buffer.StreamBufferByteSequence

All Implemented Interfaces:

CharSequence, ByteSequence

public class StreamBufferByteSequence
extends Object
implements ByteSequence, CharSequence

ByteSequence reading from StreamBuffer instances.

Author:

Daniel Sagenschneider

Field Summary

Fields inherited from interface net.officefloor.server.stream.impl.ByteSequence

EMPTY

Constructor Summary

Constructors

Constructor	Description
StreamBufferByteSequence(StreamBuffer<ByteBuffer> buffer, int offset, int length)	Instantiate with the first StreamBuffer.

Method Summary

Modifier and Type	Method	Description
void	appendStreamBuffer(StreamBuffer<ByteBuffer> buffer, int offset, int length)	Appends a StreamBuffer to this ByteSequence.
byte	byteAt(int index)	Obtains the byte at the index.
char	charAt(int index)
<T extends Throwable> StreamBufferByteSequence	decodeUri(Function<String,T> invalidDecodeExceptionFactory)	Decodes the URI.
CharSequence	getHttpCharSequence()	Obtains this ByteSequence as a CharSequence for HTTP Character values.
int	length()	Obtains the number of byte values in the ByteSequence.
<T extends Throwable> StreamBufferByteSequence	removeQuotes(Supplier<T> invalidValueExceptionFactory)	Removes surrounding HTTP quotes.
static void	setMaxByteLength(int length)	Specifies the maximum byte length of any ByteSequence.
CharSequence	subSequence(int start, int end)
String	toHttpString()	Obtains this ByteSequence decoded to a HTTP String.
<T extends Throwable> long	toLong(Function<Character,T> invalidDigitExceptionFactory)	Obtains this ByteSequence as a long value.
<T extends Throwable> String	toString(Charset charset, Function<CoderResult,T> invalidValueExceptionFactory)	Obtains this ByteSequence as a String for the particular Charset.
<T extends Throwable> String	toUriString(Function<CoderResult,T> invalidValueExceptionFactory)	Obtains this ByteSequence decoded to a URI String.
StreamBufferByteSequence	trim()	Trims this ByteSequence of outer HTTP spaces and tabs.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.CharSequence

chars, codePoints, isEmpty, toString

Constructor Details

StreamBufferByteSequence

public StreamBufferByteSequence(StreamBuffer<ByteBuffer> buffer,
 int offset,
 int length)

Instantiate with the first StreamBuffer.

Parameters:

buffer - First StreamBuffer of this ByteSequence.

offset - Offset into the StreamBuffer to read data.

length - Length of data from the StreamBuffer.

Method Details

setMaxByteLength

public static void setMaxByteLength(int length)

Specifies the maximum byte length of any ByteSequence.

Parameters:

length - Maximum byte length of any ByteSequence.

appendStreamBuffer

public void appendStreamBuffer(StreamBuffer<ByteBuffer> buffer,
 int offset,
 int length)

Appends a StreamBuffer to this ByteSequence.

Parameters:

buffer - StreamBuffer to append to this ByteSequence.

offset - Offset into the StreamBuffer to read data.

length - Length of data from the StreamBuffer.

trim

public StreamBufferByteSequence trim()

Trims this ByteSequence of outer HTTP spaces and tabs.

Returns:

this.

removeQuotes

public <T extends Throwable>
StreamBufferByteSequence removeQuotes(Supplier<T> invalidValueExceptionFactory)
                               throws T

Removes surrounding HTTP quotes.

Type Parameters:

T - Invalid value Exception type.

Parameters:

invalidValueExceptionFactory - Supplier of the invalid value Exception.

Returns:

this.

Throws:

T - Invalid value Exception.

getHttpCharSequence

public CharSequence getHttpCharSequence()

Obtains this ByteSequence as a CharSequence for HTTP Character values.

This is for use with NonMaterialisedHttpHeader comparing on the name.

Returns:

CharSequence for HTTP Character values of this ByteSequence.

toHttpString

public String toHttpString()

Obtains this ByteSequence decoded to a HTTP String.

Returns:

ByteSequence decoded to a HTTP String.

decodeUri

public <T extends Throwable>
StreamBufferByteSequence decodeUri(Function<String,T> invalidDecodeExceptionFactory)
                            throws T

Decodes the URI.

Type Parameters:

T - Invalid decode Exception type.

Parameters:

invalidDecodeExceptionFactory - Function to create an invalid encoding Throwable.

Returns:

this.

Throws:

T - If invalid encoding.

toUriString

public <T extends Throwable> String toUriString(Function<CoderResult,T> invalidValueExceptionFactory)
                                         throws T

Obtains this ByteSequence decoded to a URI String.

Type Parameters:

T - Invalid value Exception type.

Parameters:

invalidValueExceptionFactory - Factory to create the Exception should the ByteSequence not be valid for the URI.

Returns:

ByteSequence decoded to a URI String.

Throws:

T - If invalid ByteSequence for the URI.

toString

public <T extends Throwable> String toString(Charset charset,
 Function<CoderResult,T> invalidValueExceptionFactory)
                                      throws T

Obtains this ByteSequence as a String for the particular Charset.

Type Parameters:

T - Invalid value Exception type.

Parameters:

charset - Charset for the decoding the StreamBuffer data.

invalidValueExceptionFactory - Factory to create the Exception should the ByteSequence not be valid for the Charset.

Returns:

String value for the StreamBuffer values.

Throws:

T - If invalid ByteSequence for Charset.

toLong

public <T extends Throwable> long toLong(Function<Character,T> invalidDigitExceptionFactory)
                                  throws T

Obtains this ByteSequence as a long value.

Type Parameters:

T - Invalid digit Exception type.

Parameters:

invalidDigitExceptionFactory - Function to create an Throwable should there be an invalid HTTP digit.

Returns:

long value.

Throws:

T - If invalid value to convert to long.

byteAt

public byte byteAt(int index)

Description copied from interface: ByteSequence

Obtains the byte at the index.

Specified by:

byteAt in interface ByteSequence

Parameters:

index - Index of the byte.

Returns:

byte at the index.

length

public int length()

Description copied from interface: ByteSequence

Obtains the number of byte values in the ByteSequence.

Specified by:

length in interface ByteSequence

Specified by:

length in interface CharSequence

Returns:

Number of byte values in the ByteSequence.

charAt

public char charAt(int index)

Specified by:

charAt in interface CharSequence

subSequence

public CharSequence subSequence(int start,
 int end)

Specified by:

subSequence in interface CharSequence