BidirectionalStream.Callback

public void onCanceled(BidirectionalStream stream, UrlResponseInfo info)

如果串流透過 cancel 取消，系統會叫用這個方法。一旦叫用，就不會再叫用其他 BidirectionalStream.Callback 方法。預設實作不會採取任何行動。

public abstract void onFailed(
    BidirectionalStream stream,
    UrlResponseInfo info,
    CronetException error
)

如果串流在 start 後因任何原因失敗，系統就會叫用這個函式。HTTP/2 錯誤代碼會對應至 getCronetInternalErrorCode 代碼。一旦叫用，就不會再叫用其他 BidirectionalStream.Callback 方法。

public abstract void onReadCompleted(
    BidirectionalStream stream,
    UrlResponseInfo info,
    ByteBuffer buffer,
    boolean endOfStream
)

當資料讀取到傳遞至 read() 的緩衝區時，就會叫用這個函式。緩衝區可能只會填入部分資料。如要繼續閱讀，請撥打 read()。如果收到預告片前有待處理的讀取資料，可能會在 onResponseTrailersReceived() 後叫用。

public abstract void onResponseHeadersReceived(
    BidirectionalStream stream,
    UrlResponseInfo info
)

收到初始回應標頭時會叫用此函式。標頭可從 info.getAllHeaders() 取得。消費者可以呼叫 read() 開始朗讀。消費者可以呼叫 write() 開始寫入或關閉串流。

public void onResponseTrailersReceived(
    BidirectionalStream stream,
    UrlResponseInfo info,
    UrlResponseInfo.HeaderBlock trailers
)

在關閉串流前收到預告片時叫用。只有在伺服器傳送尾部時才會叫用，但伺服器可能不會傳送尾部。本機緩衝區中可能仍有讀取資料時會叫用。預設實作不會採取任何行動。

public abstract void onStreamReady(BidirectionalStream stream)

當串流準備好讀取和寫入時，系統會叫用此方法。消費者可以呼叫 read() 開始讀取資料。消費者可以呼叫 write() 開始寫入資料。

public abstract void onSucceeded(BidirectionalStream stream, UrlResponseInfo info)

當沒有要讀取或寫入的資料，且串流已在遠端和本機順利關閉時，系統會叫用這個方法。一旦叫用，就不會再叫用其他 BidirectionalStream.Callback 方法。

public abstract void onWriteCompleted(
    BidirectionalStream stream,
    UrlResponseInfo info,
    ByteBuffer buffer,
    boolean endOfStream
)

在傳送傳遞至 write() 的整個 ByteBuffer 時叫用。緩衝區的位置會更新為與緩衝區的限制相同。緩衝區的限制不會變更。如要繼續撰寫，請呼叫 write()。