UploadDataProvider

public void close()

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.

public abstract long getLength()

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

public abstract void read(UploadDataSink uploadDataSink, ByteBuffer byteBuffer)

Liest Upload-Daten in byteBuffer. Nach Abschluss wird die Position des Puffers auf das Ende der gelesenen Byte 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 oder die andere 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) kann onReadSucceeded für den letzten Teil mit einem leeren Byte-Puffer aufgerufen werden.

public abstract void rewind(UploadDataSink uploadDataSink)

Spult 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. Wenn eine Ausnahme von der Methode ausgelöst wird, entspricht dies 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 einem Zeitlimit oder einer Netzwerkunterbrechung. Die Implementierung des Zurückspulens ist zwar im Allgemeinen optional, aber Anfragen, bei denen es erforderlich ist, schlagen fehl, wenn es nicht implementiert ist.