Index: components/cronet/README.md |
diff --git a/components/cronet/README.md b/components/cronet/README.md |
index 22aca16a4a4363afc2a88044b36175365beaa327..eb7d81a399677366a626da387584ee0396e0783d 100644 |
--- a/components/cronet/README.md |
+++ b/components/cronet/README.md |
@@ -8,10 +8,10 @@ API as well as support for the [java.net.HttpURLConnection] API. |
This document gives a brief introduction to using these two Java APIs. |
### Basics |
-First you will need to implement the `UrlRequestListener` interface to handle |
+First you will need to extend `UrlRequestListener` to handle |
events during the lifetime of a request. For example: |
- class MyListener implements UrlRequestListener { |
+ class MyListener extends UrlRequestListener { |
@Override |
public void onReceivedRedirect(UrlRequest request, |
ResponseInfo responseInfo, String newLocationUrl) { |
@@ -77,11 +77,11 @@ Make a request like this: |
"https://www.example.com", listener, executor); |
request.start(); |
-In the above example, `MyListener` implements the `UrlRequestListener` |
-interface. The request is started asynchronously. When the response is ready |
-(fully or partially), and in the event of failures or redirects, |
-`listener`'s methods will be invoked on `executor`'s thread to inform the |
-client of the request state and/or response information. |
+In the above example, `MyListener` extends `UrlRequestListener`. The request |
+is started asynchronously. When the response is ready (fully or partially), and |
+in the event of failures or redirects, `listener`'s methods will be invoked on |
+`executor`'s thread to inform the client of the request state and/or response |
+information. |
### Downloading Data |
When Cronet fetches response headers from the server or gets them from the |
@@ -89,9 +89,7 @@ cache, `UrlRequestListener.onResponseStarted` will be invoked. To read the |
response body, the client should call `UrlRequest.read` and supply a |
[ByteBuffer] for Cronet to fill. Once a portion or all of |
the response body is read, `UrlRequestListener.onReadCompleted` will be invoked. |
-The client may consume the data, or copy the contents of the `byteBuffer` |
-elsewhere for use later. The data in `byteBuffer` is only guaranteed to be |
-valid for the duration of the `UrlRequestListener.onReadCompleted` callback. |
+The client may then read and consume the data within `byteBuffer`. |
Once the client is ready to consume more data, the client should call |
`UrlRequest.read` again. The process continues until |
`UrlRequestListener.onSucceeded` or `UrlRequestListener.onFailed` is invoked, |
@@ -103,8 +101,8 @@ which signals the completion of the request. |
request.setUploadDataProvider(myUploadDataProvider, executor); |
request.start(); |
-In the above example, `MyUploadDataProvider` implements the |
-`UploadDataProvider` interface. When Cronet is ready to send the request body, |
+In the above example, `MyUploadDataProvider` extends `UploadDataProvider`. |
+When Cronet is ready to send the request body, |
`myUploadDataProvider.read(UploadDataSink uploadDataSink, |
ByteBuffer byteBuffer)` will be invoked. The client will need to write the |
request body into `byteBuffer`. Once the client is done writing into |