|
23 | 23 | import javax.annotation.Nullable;
|
24 | 24 |
|
25 | 25 | /**
|
26 |
| - * EventListener for analytic events for an OkHttpClient instance. |
| 26 | + * Listener for metrics events. Extend this class to monitor the quantity, size, and duration of |
| 27 | + * your application's HTTP calls. |
| 28 | + * |
| 29 | + * <h3>Warning: This is a non-final API.</h3> |
| 30 | + * |
| 31 | + * <p><strong>As of OkHttp 3.9, this feature is an unstable preview: the API is subject to change, |
| 32 | + * and the implementation is incomplete. We expect that OkHttp 3.10 or 3.11 will finalize this API. |
| 33 | + * Until then, expect API and behavior changes when you update your OkHttp dependency.</strong> |
27 | 34 | *
|
28 | 35 | * <p>All start/connect/acquire events will eventually receive a matching end/release event,
|
29 | 36 | * either successful (non-null parameters), or failed (non-null throwable). The first common
|
@@ -275,6 +282,14 @@ public void callEnd(Call call) {
|
275 | 282 | public void callFailed(Call call, IOException ioe) {
|
276 | 283 | }
|
277 | 284 |
|
| 285 | + /** |
| 286 | + * <h3>Warning: This is a non-final API.</h3> |
| 287 | + * |
| 288 | + * <p><strong>As of OkHttp 3.9, this feature is an unstable preview: the API is subject to change, |
| 289 | + * and the implementation is incomplete. We expect that OkHttp 3.10 or 3.11 will finalize this |
| 290 | + * API. Until then, expect API and behavior changes when you update your OkHttp |
| 291 | + * dependency.</strong> |
| 292 | + */ |
278 | 293 | public interface Factory {
|
279 | 294 | /**
|
280 | 295 | * Creates an instance of the {@link EventListener} for a particular {@link Call}. The returned
|
|
0 commit comments