UploadDataProvider

fun close(): Unit

當要求不再需要這個 UploadDataProvider 時呼叫，以便明確釋出資源 (例如檔案)。

abstract fun getLength(): Long

如果是非分塊上傳，則會傳回上傳長度。如果是分塊上傳，則一律必須傳回 -1。

abstract fun read(uploadDataSink: UploadDataSink!, byteBuffer: ByteBuffer!): Unit

將上傳資料讀取至 byteBuffer。完成後，緩衝區的位置會更新為所讀取位元組的結尾。緩衝區的限制不會變更。每次呼叫這個方法後，都必須呼叫一次 uploadDataSink (同步或非同步)：成功時呼叫 onReadSucceeded，失敗時呼叫 onReadError。在呼叫其中一個方法或另一個方法之前，系統不會呼叫讀取或倒轉。即使關聯的 UrlRequest 已取消，仍須先呼叫其中一個，才能安全釋出資源。擲回例外狀況也會導致資源釋出，且要求發生錯誤。

注意：如果上傳作業未分塊，只有在讀取成功，且至少有一個位元組已讀取至 byteBuffer 時，才應呼叫 onReadSucceeded。如果是分塊上傳 (資料大小不明)，則允許為最後一個分塊呼叫 onReadSucceeded，並使用空白位元組緩衝區。

abstract fun rewind(uploadDataSink: UploadDataSink!): Unit

將上傳資料倒轉至開頭。當 Cronet 需要上傳資料供應商處於等效狀態時 (如同從未呼叫 read)，系統就會叫用這個方法。

如要表示作業已完成，這項函式的實作項目必須呼叫 onRewindSucceeded (表示成功) 或 onRewindError (表示失敗)。即使關聯的 UrlRequest 已取消，仍須先呼叫其中一個，才能安全釋出資源。從方法擲回例外狀況等同於呼叫 onRewindError。如果不支援倒轉 (例如從一次性串流讀取資料)，這應該會立即呼叫 onRewindError。

實作人員可以放心假設，在通知接收器倒轉完成前，系統不會發出 read 或並行 rewind 呼叫，如上一段所述。

如果需要多次上傳主體，Cronet 會在內部使用這個方法。這可能發生在許多不同情況，例如追蹤重新導向，或在逾時或網路中斷後重試要求。請注意，雖然一般來說，實作倒轉功能是選用功能，但如果要求最終需要這項功能，就必須實作，否則要求會失敗。