org.eclipse.jetty.http2

Class HTTP2Stream

java.lang.Object

org.eclipse.jetty.io.IdleTimeout

org.eclipse.jetty.http2.HTTP2Stream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, Stream, IStream, Callback, Dumpable, Invocable

public class HTTP2Stream
extends IdleTimeout
implements IStream, Callback, Dumpable

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.http2.api.Stream

Stream.Listener

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

Callback.Completable, Callback.Nested

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

Invocable.InvocationType

Field Summary

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

NOOP

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

__nonBlocking

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

KEY

Constructor Summary

Constructors

Constructor and Description
HTTP2Stream(Scheduler scheduler, ISession session, int streamId, boolean local)

Method Summary

Modifier and Type	Method and Description
void	close() Forcibly closes this stream.
void	data(DataFrame frame, Callback callback) Sends the given DATA frame.
java.lang.String	dump()
void	dump(java.lang.Appendable out, java.lang.String indent) Dump this object (and children) into an Appendable using the provided indent after any new lines.
void	failed(java.lang.Throwable x) Callback invoked when the operation fails.
java.lang.Object	getAttachment()
java.lang.Object	getAttribute(java.lang.String key)
int	getId()
Stream.Listener	getListener()
int	getRecvWindow()
int	getSendWindow()
ISession	getSession()
void	headers(HeadersFrame frame, Callback callback) Sends the given HEADERS frame representing a HTTP response.
boolean	isClosed()
boolean	isLocal()
boolean	isLocallyClosed()
boolean	isOpen() This abstract method should be called to check if idle timeouts should still be checked.
boolean	isRemotelyClosed()
boolean	isReset()
void	onClose()
protected void	onIdleExpired(java.util.concurrent.TimeoutException timeout) This abstract method is called when the idle timeout has expired.
void	process(Frame frame, Callback callback) Processes the given frame, belonging to this stream.
void	push(PushPromiseFrame frame, Promise<Stream> promise, Stream.Listener listener) Sends the given PUSH_PROMISE frame.
java.lang.Object	removeAttribute(java.lang.String key)
void	reset(ResetFrame frame, Callback callback) Sends the given RST_STREAM frame.
void	setAttachment(java.lang.Object attachment) Attaches the given object to this stream for later retrieval.
void	setAttribute(java.lang.String key, java.lang.Object value)
void	setListener(Stream.Listener listener)
void	succeeded() Callback invoked when the operation completes.
java.lang.String	toString()
boolean	updateClose(boolean update, CloseState.Event event) Updates the close state of this stream.
int	updateRecvWindow(int delta) Updates the stream receive window by the given delta.
int	updateSendWindow(int delta) Updates the stream send window by the given delta.

Methods inherited from class org.eclipse.jetty.io.IdleTimeout

checkIdleTimeout, getIdleFor, getIdleTimeout, getIdleTimestamp, getScheduler, notIdle, onOpen, setIdleTimeout

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.http2.IStream

notIdle

Methods inherited from interface org.eclipse.jetty.http2.api.Stream

getIdleTimeout, setIdleTimeout

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

from, from

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

getInvocationType, getInvocationType, invokeNonBlocking, isNonBlockingInvocation

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dump, dumpObject, dumpObjects, dumpSelf

Constructor Detail

HTTP2Stream

public HTTP2Stream(Scheduler scheduler,
                   ISession session,
                   int streamId,
                   boolean local)

Method Detail

getId

public int getId()

Specified by:

getId in interface Stream

Returns:

the stream unique id

getAttachment

public java.lang.Object getAttachment()

Specified by:

getAttachment in interface IStream

Returns:

the object attached to this stream

See Also:

IStream.setAttachment(Object)

setAttachment

public void setAttachment(java.lang.Object attachment)

Description copied from interface: IStream

Attaches the given object to this stream for later retrieval.

Specified by:

setAttachment in interface IStream

Parameters:

attachment - the object to attach to this stream

isLocal

public boolean isLocal()

Specified by:

isLocal in interface IStream

Returns:

whether this stream is local or remote

getSession

public ISession getSession()

Specified by:

getSession in interface Stream

Specified by:

getSession in interface IStream

Returns:

the session this stream is associated to

headers

public void headers(HeadersFrame frame,
                    Callback callback)

Description copied from interface: Stream

Sends the given HEADERS frame representing a HTTP response.

Specified by:

headers in interface Stream

Parameters:

frame - the HEADERS frame to send

callback - the callback that gets notified when the frame has been sent

push

public void push(PushPromiseFrame frame,
                 Promise<Stream> promise,
                 Stream.Listener listener)

Description copied from interface: Stream

Sends the given PUSH_PROMISE frame.

Specified by:

push in interface Stream

Parameters:

frame - the PUSH_PROMISE frame to send

promise - the promise that gets notified of the pushed stream creation

listener - the listener that gets notified of stream events

data

public void data(DataFrame frame,
                 Callback callback)

Description copied from interface: Stream

Sends the given DATA frame.

Specified by:

data in interface Stream

Parameters:

frame - the DATA frame to send

callback - the callback that gets notified when the frame has been sent

reset

public void reset(ResetFrame frame,
                  Callback callback)

Description copied from interface: Stream

Sends the given RST_STREAM frame.

Specified by:

reset in interface Stream

Parameters:

frame - the RST_FRAME to send

callback - the callback that gets notified when the frame has been sent

getAttribute

public java.lang.Object getAttribute(java.lang.String key)

Specified by:

getAttribute in interface Stream

Parameters:

key - the attribute key

Returns:

an arbitrary object associated with the given key to this stream or null if no object can be found for the given key.

See Also:

Stream.setAttribute(String, Object)

setAttribute

public void setAttribute(java.lang.String key,
                         java.lang.Object value)

Specified by:

setAttribute in interface Stream

Parameters:

key - the attribute key

value - an arbitrary object to associate with the given key to this stream

See Also:

Stream.getAttribute(String), Stream.removeAttribute(String)

removeAttribute

public java.lang.Object removeAttribute(java.lang.String key)

Specified by:

removeAttribute in interface Stream

Parameters:

key - the attribute key

Returns:

the arbitrary object associated with the given key to this stream

See Also:

Stream.setAttribute(String, Object)

isReset

public boolean isReset()

Specified by:

isReset in interface Stream

Returns:

whether this stream has been reset

isClosed

public boolean isClosed()

Specified by:

isClosed in interface Stream

Returns:

whether this stream is closed, both locally and remotely.

isRemotelyClosed

public boolean isRemotelyClosed()

Specified by:

isRemotelyClosed in interface IStream

Returns:

whether the stream is closed remotely.

See Also:

Stream.isClosed()

isLocallyClosed

public boolean isLocallyClosed()

isOpen

public boolean isOpen()

Description copied from class: IdleTimeout

This abstract method should be called to check if idle timeouts should still be checked.

Specified by:

isOpen in class IdleTimeout

Returns:

True if the entity monitored should still be checked for idle timeouts

onIdleExpired

protected void onIdleExpired(java.util.concurrent.TimeoutException timeout)

Description copied from class: IdleTimeout

This abstract method is called when the idle timeout has expired.

Specified by:

onIdleExpired in class IdleTimeout

Parameters:

timeout - a TimeoutException

getListener

public Stream.Listener getListener()

Specified by:

getListener in interface IStream

Returns:

the Stream.Listener associated with this stream

See Also:

IStream.setListener(Stream.Listener)

setListener

public void setListener(Stream.Listener listener)

Specified by:

setListener in interface IStream

Parameters:

listener - the Stream.Listener associated with this stream

See Also:

IStream.getListener()

process

public void process(Frame frame,
                    Callback callback)

Description copied from interface: IStream

Processes the given frame, belonging to this stream.

Specified by:

process in interface IStream

Parameters:

frame - the frame to process

callback - the callback to complete when frame has been processed

updateClose

public boolean updateClose(boolean update,
                           CloseState.Event event)

Description copied from interface: IStream

Updates the close state of this stream.

Specified by:

updateClose in interface IStream

Parameters:

update - whether to update the close state

event - the event that caused the close state update

Returns:

whether the stream has been fully closed by this invocation

getSendWindow

public int getSendWindow()

getRecvWindow

public int getRecvWindow()

updateSendWindow

public int updateSendWindow(int delta)

Description copied from interface: IStream

Updates the stream send window by the given delta.

Specified by:

updateSendWindow in interface IStream

Parameters:

delta - the delta value (positive or negative) to add to the stream send window

Returns:

the previous value of the stream send window

updateRecvWindow

public int updateRecvWindow(int delta)

Description copied from interface: IStream

Updates the stream receive window by the given delta.

Specified by:

updateRecvWindow in interface IStream

Parameters:

delta - the delta value (positive or negative) to add to the stream receive window

Returns:

the previous value of the stream receive window

close

public void close()

Description copied from interface: IStream

Forcibly closes this stream.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface IStream

onClose

public void onClose()

Overrides:

onClose in class IdleTimeout

succeeded

public void succeeded()

Description copied from interface: Callback

Callback invoked when the operation completes.

Specified by:

succeeded in interface Callback

See Also:

Callback.failed(Throwable)

failed

public void failed(java.lang.Throwable x)

Description copied from interface: Callback

Callback invoked when the operation fails.

Specified by:

failed in interface Callback

Parameters:

x - the reason for the operation failure

dump

public java.lang.String dump()

Specified by:

dump in interface Dumpable

dump

public void dump(java.lang.Appendable out,
                 java.lang.String indent)
          throws java.io.IOException

Description copied from interface: Dumpable

Dump this object (and children) into an Appendable using the provided indent after any new lines. The indent should not be applied to the first object dumped.

Specified by:

dump in interface Dumpable

Parameters:

out - The appendable to dump to

indent - The indent to apply after any new lines.

Throws:

java.io.IOException - if unable to write to Appendable

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object