UploadDataProvider

public void close()

Вызывается, когда этот UploadDataProvider больше не требуется для запроса, чтобы ресурсы (например, файл) можно было явно освободить.

public abstract long getLength()

Если загрузка выполняется без разбивки на блоки, возвращается длина загружаемого файла. Если загрузка выполняется с разбивкой на блоки, всегда возвращается -1.

public abstract void read(UploadDataSink uploadDataSink, ByteBuffer byteBuffer)

Метод `read` загружает данные в byteBuffer . После завершения операции позиция буфера обновляется до конца прочитанных байтов. Лимит буфера не изменяется. Каждый вызов этого метода должен сопровождаться одним вызовом метода uploadDataSink , синхронным или асинхронным: onReadSucceeded в случае успеха или onReadError в случае неудачи. Методы `read` и `rewind` не будут вызываться до тех пор, пока не будет вызван один из этих методов. Даже если связанный с ним UrlRequest будет отменен, один из этих методов все равно должен быть вызван, прежде чем ресурсы можно будет безопасно освободить. Выброс исключения также приведет к освобождению ресурсов и ошибке запроса.

Примечание: Для загрузки данных без разбивки на блоки onReadSucceeded следует производить только в том случае, если чтение прошло успешно и в byteBuffer был считан хотя бы один байт. Для загрузки данных с разбивкой на блоки (размер данных неизвестен) вызов функции onReadSucceeded допускается только для последнего блока с пустым буфером byteBuffer.

public abstract void rewind(UploadDataSink uploadDataSink)

Откатывает загружаемые данные к началу. Вызывается, когда Cronet требует, чтобы поставщик загружаемых данных находился в состоянии, аналогичном тому, как если бы вызов read еще не был произведен.

Чтобы сигнализировать о завершении операции, реализация этой функции должна вызывать метод onRewindSucceeded для подтверждения успеха или onRewindError в случае неудачи. Даже если связанный с ним UrlRequest отменен, необходимо вызвать один из этих методов, прежде чем ресурсы можно будет безопасно освободить. Выброс исключения из метода эквивалентен вызову onRewindError . Если перемотка назад не поддерживается (например, при чтении из одноразового потока), следует немедленно вызвать onRewindError .

Разработчик может с уверенностью предположить, что ни read , ни одновременный вызов rewind не будут выполнены до тех пор, пока он не уведомит приемник о завершении перемотки, как описано в предыдущем абзаце.

Этот метод используется внутри Cronet, если тело запроса необходимо загрузить несколько раз. Это может происходить в самых разных ситуациях, например, при перенаправлении или при повторных запросах после истечения таймаута или разрыва сетевого соединения. Следует отметить, что хотя реализация механизма перемотки обычно является необязательной, запросы, которые в конечном итоге потребуют его использования, завершатся с ошибкой, если механизм перемотки не будет реализован.