UploadDataProvider

fun close(): Unit

Wird aufgerufen, wenn dieser UploadDataProvider nicht mehr für eine Anfrage benötigt wird, damit Ressourcen (z. B. eine Datei) explizit freigegeben werden können.

abstract fun getLength(): Long

Gibt bei einem nicht aufgeteilten Upload die Länge des Uploads zurück. Muss bei einem aufgeteilten Upload immer -1 zurückgeben.

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

Liest Upload-Daten in byteBuffer. Nach Abschluss wird die Position des Puffers auf das Ende der gelesenen Bytes aktualisiert. Das Limit des Puffers wird nicht geändert. Auf jeden Aufruf dieser Methode muss ein einzelner Aufruf von uploadDataSink folgen, entweder synchron oder asynchron: onReadSucceeded bei Erfolg oder onReadError bei Fehler. Weder „Lesen“ noch „Zurückspulen“ werden aufgerufen, bis eine dieser Methoden aufgerufen wird. Auch wenn die zugehörige UrlRequest abgebrochen wird, muss eine der beiden Methoden aufgerufen werden, bevor Ressourcen sicher freigegeben werden können. Wenn eine Ausnahme ausgelöst wird, werden auch Ressourcen freigegeben und die Anfrage schlägt fehl.

Hinweis: Bei nicht aufgeteilten Uploads sollte onReadSucceeded nur aufgerufen werden, wenn das Lesen erfolgreich war und mindestens ein Byte in byteBuffer gelesen wurde. Bei aufgeteilten Uploads (die Größe der Daten ist unbekannt) ist es zulässig, onReadSucceeded für den letzten Teil mit einem leeren Byte-Puffer aufzurufen.

abstract fun rewind(uploadDataSink: UploadDataSink!): Unit

Setzt die Upload-Daten an den Anfang zurück. Wird aufgerufen, wenn Cronet erfordert, dass sich der Upload-Datenanbieter in einem Zustand befindet, als wäre read noch nie aufgerufen worden.

Um zu signalisieren, dass der Vorgang abgeschlossen ist, müssen Implementierungen dieser Funktion onRewindSucceeded aufrufen, um den Erfolg anzugeben, oder onRewindError bei einem Fehler. Auch wenn die zugehörige UrlRequest abgebrochen wird, muss eine der beiden Methoden aufgerufen werden, bevor Ressourcen sicher freigegeben werden können. Das Auslösen einer Ausnahme aus der Methode entspricht dem Aufruf von onRewindError. Wenn das Zurückspulen nicht unterstützt wird (z. B. beim Lesen aus einem einmaligen Stream), sollte onRewindError sofort aufgerufen werden.

Der Implementierer kann davon ausgehen, dass weder read noch ein gleichzeitiger rewind-Aufruf ausgegeben wird, bis er die Senke benachrichtigt, dass das Zurückspulen abgeschlossen ist, wie im vorherigen Absatz beschrieben.

Diese Methode wird intern von Cronet verwendet, wenn der Body mehrmals hochgeladen werden muss. Dies kann in vielen verschiedenen Situationen auftreten, z. B. beim Folgen von Weiterleitungen oder beim Wiederholen von Anfragen nach einer Zeitüberschreitung oder einer Netzwerkunterbrechung. Obwohl die Implementierung des Zurückspulens im Allgemeinen optional ist, schlagen Anfragen, bei denen es erforderlich ist, fehl, wenn es nicht implementiert ist.