Package org.glassfish.jersey.message.internal

Class EntityInputStream

java.lang.Object

java.io.InputStream

org.glassfish.jersey.innate.io.InputStreamWrapper

org.glassfish.jersey.message.internal.EntityInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public class EntityInputStream
extends org.glassfish.jersey.innate.io.InputStreamWrapper

Entity input stream customized for entity message processing:

• contains isEmpty() method.
• close() method throws Jersey-specific runtime exception in case of an IO error.

Author:

Marek Potociar

Constructor Summary

Constructors

Constructor	Description
EntityInputStream(InputStream input)	Extension constructor.

Method Summary

Modifier and Type	Method	Description
void	close()
static EntityInputStream	create(InputStream inputStream)	Create an entity input stream instance wrapping the original input stream.
void	ensureNotClosed()	Check that the entity input stream has not been closed yet.
protected InputStream	getWrapped()	Return the wrapped stream
InputStream	getWrappedStream()	Get the wrapped input stream instance.
boolean	isClosed()	Get the closed status of this input stream.
boolean	isEmpty()	Check if the underlying entity stream is empty.
void	reset()
void	setWrappedStream(InputStream wrapped)	Set the wrapped input stream instance.

Methods inherited from class org.glassfish.jersey.innate.io.InputStreamWrapper

available, getWrappedIOE, mark, markSupported, read, read, read, readAllBytes, readNBytes, skip, transferTo

Methods inherited from class java.io.InputStream

nullInputStream, readNBytes

Methods inherited from class java.lang.Object

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

Constructor Detail

EntityInputStream

public EntityInputStream(InputStream input)

Extension constructor.

Parameters:

input - underlying wrapped input stream.

Method Detail

create

public static EntityInputStream create(InputStream inputStream)

Create an entity input stream instance wrapping the original input stream.

In case the original entity stream is already of type EntityInputStream, the stream is returned without wrapping.

Parameters:

inputStream - input stream.

Returns:

entity input stream.

reset

public void reset()

The method is customized to not throw an IOException if the reset operation fails. Instead, a runtime ProcessingException is thrown.

Overrides:

reset in class org.glassfish.jersey.innate.io.InputStreamWrapper

Throws:

ProcessingException - in case the reset operation on the underlying entity input stream failed.

close

public void close()
           throws ProcessingException

The method is customized to not throw an IOException if the close operation fails. Instead, a warning message is logged.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class org.glassfish.jersey.innate.io.InputStreamWrapper

Throws:

ProcessingException

isEmpty

public boolean isEmpty()

Check if the underlying entity stream is empty.

Note that the operation may need to block until a first byte (or EOF) is available in the stream.

Returns:

true if the entity stream is empty, false otherwise.

ensureNotClosed

public void ensureNotClosed()
                     throws IllegalStateException

Check that the entity input stream has not been closed yet.

Throws:

IllegalStateException - in case the entity input stream has been closed.

isClosed

public boolean isClosed()

Get the closed status of this input stream.

Returns:

true if the stream has been closed, false otherwise.

getWrappedStream

public final InputStream getWrappedStream()

Get the wrapped input stream instance.

Returns:

wrapped input stream instance.

setWrappedStream

public final void setWrappedStream(InputStream wrapped)

Set the wrapped input stream instance.

Parameters:

wrapped - new input stream instance to be wrapped.

getWrapped

protected InputStream getWrapped()

Description copied from class: org.glassfish.jersey.innate.io.InputStreamWrapper

Return the wrapped stream

Specified by:

getWrapped in class org.glassfish.jersey.innate.io.InputStreamWrapper

Returns: