com.lark.oapi.okhttp.internal.http2

类 Http2Stream

java.lang.Object

com.lark.oapi.okhttp.internal.http2.Http2Stream

public final class Http2Stream
extends Object

A logical bidirectional stream.

方法概要

限定符和类型	方法和说明
void	close(ErrorCode rstStatusCode, IOException errorException) Abnormally terminate this stream.
void	closeLater(ErrorCode errorCode) Abnormally terminate this stream.
void	enqueueTrailers(Headers trailers)
Http2Connection	getConnection()
ErrorCode	getErrorCode() Returns the reason why this stream was closed, or null if it closed normally or has not yet been closed.
int	getId()
Sink	getSink() Returns a sink that can be used to write data to the peer.
Source	getSource() Returns a source that reads data from the peer.
boolean	isLocallyInitiated() Returns true if this stream was created by this peer.
boolean	isOpen() Returns true if this stream is open.
Timeout	readTimeout()
Headers	takeHeaders() Removes and returns the stream's received response headers, blocking if necessary until headers have been received.
Headers	trailers() Returns the trailers.
void	writeHeaders(List<Header> responseHeaders, boolean outFinished, boolean flushHeaders) Sends a reply to an incoming stream.
Timeout	writeTimeout()

从类继承的方法 java.lang.Object

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

方法详细资料

getId

public int getId()

isOpen

public boolean isOpen()

Returns true if this stream is open. A stream is open until either:

• A SYN_RESET frame abnormally terminates the stream.
• Both input and output streams have transmitted all data and headers.

Note that the input stream may continue to yield data even after a stream reports itself as not open. This is because input data is buffered.

isLocallyInitiated

public boolean isLocallyInitiated()

Returns true if this stream was created by this peer.

getConnection

public Http2Connection getConnection()

takeHeaders

public Headers takeHeaders()
                    throws IOException

Removes and returns the stream's received response headers, blocking if necessary until headers have been received. If the returned list contains multiple blocks of headers the blocks will be delimited by 'null'.

抛出:

IOException

trailers

public Headers trailers()
                 throws IOException

Returns the trailers. It is only safe to call this once the source stream has been completely exhausted.

抛出:

IOException

getErrorCode

public ErrorCode getErrorCode()

Returns the reason why this stream was closed, or null if it closed normally or has not yet been closed.

writeHeaders

public void writeHeaders(List<Header> responseHeaders,
                         boolean outFinished,
                         boolean flushHeaders)
                  throws IOException

Sends a reply to an incoming stream.

参数:

outFinished - true to eagerly finish the output stream to send data to the remote peer. Corresponds to FLAG_FIN.

flushHeaders - true to force flush the response headers. This should be true unless the response body exists and will be written immediately.

抛出:

IOException

enqueueTrailers

public void enqueueTrailers(Headers trailers)

readTimeout

public Timeout readTimeout()

writeTimeout

public Timeout writeTimeout()

getSource

public Source getSource()

Returns a source that reads data from the peer.

getSink

public Sink getSink()

Returns a sink that can be used to write data to the peer.

抛出:

IllegalStateException - if this stream was initiated by the peer and a writeHeaders(java.util.List<com.lark.oapi.okhttp.internal.http2.Header>, boolean, boolean) has not yet been sent.

close

public void close(ErrorCode rstStatusCode,
                  @Nullable
                  IOException errorException)
           throws IOException

Abnormally terminate this stream. This blocks until the RST_STREAM frame has been transmitted.

抛出:

IOException

closeLater

public void closeLater(ErrorCode errorCode)

Abnormally terminate this stream. This enqueues a RST_STREAM frame and returns immediately.