BidirectionalStream

public abstract void cancel()

取消串流。可在 start 之後隨時呼叫。取消作業完成後，系統會呼叫 onCanceled()，且不會再呼叫其他回呼方法。如果串流已完成或尚未開始，呼叫 cancel() 不會產生任何作用，且不會叫用 onCanceled()。如果在 BidirectionalStream 建構期間傳入的 Executor 在單一執行緒上執行工作，且 cancel() 是在該執行緒上呼叫，則在呼叫 cancel() 後，系統不會叫用任何接聽程式方法 (onCanceled() 除外)。否則，cancel() 完成後最多只能叫用一個回呼方法。

public abstract void flush()

清除待處理的寫入作業。這個方法不應在 onStreamReady() 之前叫用。如果是先前延遲的 write()，系統會在傳送緩衝區時叫用對應的 onWriteCompleted()。

public abstract boolean isDone()

如果串流已成功啟動並完成 (成功、取消或失敗)，則會傳回 true。

public abstract void read(ByteBuffer buffer)

將資料從串流讀取到提供的緩衝區。針對 Callback 的 onStreamReady()/ onResponseHeadersReceived() 和 onReadCompleted() 方法的每次叫用，最多只能呼叫一次。如果讀取資料，每次呼叫都會導致叫用其中一個 Callback 的 onReadCompleted() 方法；如果發生錯誤，則會叫用 onFailed() 方法。系統會嘗試從 buffer.position() 開始將資料讀取至 buffer。最多讀取 buffer.remaining() 個位元組。呼叫 onReadCompleted() 時，系統會更新 buffer.position()，指出讀取的資料量。

public abstract void start()

啟動串流，所有回呼都會傳送至傳遞給 BidirectionalStream.Builder 建構函式的 callback 引數。只能呼叫一次。

public abstract void write(ByteBuffer buffer, boolean endOfStream)

將要寫入串流的資料新增至緩衝區。只有在呼叫 flush() 後，系統才會傳送資料。每次呼叫都會導致系統叫用 Callback 的 onWriteCompleted() 方法 (如果傳送資料)，或 onFailed() 方法 (如果發生錯誤)。

系統開始嘗試從 buffer 寫入資料，起始時間為 buffer.position()。系統將寫入 buffer.remaining() 個位元組。只有在寫入完整的 ByteBuffer 時，才會叫用 onWriteCompleted()。