BidirectionalStream

abstract fun cancel(): Unit

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

abstract fun flush(): Unit

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

abstract fun isDone(): Boolean

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

abstract fun read(buffer: ByteBuffer!): Unit

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

abstract fun start(): Unit

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

abstract fun write(buffer: ByteBuffer!, endOfStream: Boolean): Unit

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

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