Package org.eclipse.jetty.server

Class HttpInput.SpecialContent

java.lang.Object

org.eclipse.jetty.server.HttpInput.Content

org.eclipse.jetty.server.HttpInput.SpecialContent

All Implemented Interfaces:

Callback, Invocable

Direct Known Subclasses:

HttpInput.EofContent, HttpInput.ErrorContent

Enclosing class:

HttpInput

public abstract static class HttpInput.SpecialContent
extends HttpInput.Content

Abstract class that implements the standard special content behavior.

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.Callback

Callback.Completable, Callback.Completing, Callback.Nested

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.thread.Invocable

Invocable.InvocationType, Invocable.ReadyTask, Invocable.Task

Field Summary

Fields inherited from class org.eclipse.jetty.server.HttpInput.Content

_content

Fields inherited from interface org.eclipse.jetty.util.Callback

NOOP

Fields inherited from interface org.eclipse.jetty.util.thread.Invocable

__nonBlocking

Constructor Summary

Constructors

Constructor	Description
SpecialContent()

Method Summary

Modifier and Type	Method	Description
final int	get(byte[] buffer, int offset, int length)	Read the wrapped byte buffer.
final ByteBuffer	getByteBuffer()	Get the wrapped byte buffer.
final boolean	hasContent()	Check if there is at least one byte left in the buffer.
final boolean	isEmpty()	Check if the buffer is empty.
final boolean	isSpecial()	Check if the content is special.
final int	remaining()	Get the number of bytes remaining in the buffer.
final int	skip(int length)	Skip some bytes from the buffer.

Methods inherited from class org.eclipse.jetty.server.HttpInput.Content

getError, getInvocationType, isEof, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.Callback

completeWith, failed, succeeded

Constructor Details

SpecialContent

public SpecialContent()

Method Details

getByteBuffer

public final ByteBuffer getByteBuffer()

Description copied from class: HttpInput.Content

Get the wrapped byte buffer. Throws IllegalStateException if the content is special.

Overrides:

getByteBuffer in class HttpInput.Content

Returns:

the wrapped byte buffer.

get

public final int get(byte[] buffer,
 int offset,
 int length)

Description copied from class: HttpInput.Content

Read the wrapped byte buffer. Throws IllegalStateException if the content is special.

Overrides:

get in class HttpInput.Content

Parameters:

buffer - The array into which bytes are to be written.

offset - The offset within the array of the first byte to be written.

length - The maximum number of bytes to be written to the given array.

Returns:

The amount of bytes read from the buffer.

skip

public final int skip(int length)

Description copied from class: HttpInput.Content

Skip some bytes from the buffer. Has no effect on a special content.

Overrides:

skip in class HttpInput.Content

Parameters:

length - How many bytes to skip.

Returns:

How many bytes were skipped.

hasContent

public final boolean hasContent()

Description copied from class: HttpInput.Content

Check if there is at least one byte left in the buffer. Always false on a special content.

Overrides:

hasContent in class HttpInput.Content

Returns:

true if there is at least one byte left in the buffer.

remaining

public final int remaining()

Description copied from class: HttpInput.Content

Get the number of bytes remaining in the buffer. Always 0 on a special content.

Overrides:

remaining in class HttpInput.Content

Returns:

the number of bytes remaining in the buffer.

isEmpty

public final boolean isEmpty()

Description copied from class: HttpInput.Content

Check if the buffer is empty. Always true on a special content.

Overrides:

isEmpty in class HttpInput.Content

Returns:

true if there is 0 byte left in the buffer.

isSpecial

public final boolean isSpecial()

Description copied from class: HttpInput.Content

Check if the content is special. A content is deemed special if it does not hold bytes but rather conveys a special event, like when EOF has been reached or an error has occurred.

Overrides:

isSpecial in class HttpInput.Content

Returns:

true if the content is special, false otherwise.