Download doclava when building for Android and use to build cronet Javadocs

components/cronet/android/api/src/org/chromium/net/UrlRequest.java

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 package org.chromium.net;
 
 import android.support.annotation.IntDef;
 import android.util.Log;
 import android.util.Pair;
 
@@ skipping 122 matching lines @@
         /**
          * Disables cache for the request. If context is not set up to use cache,
          * this call has no effect.
          * @return the builder to facilitate chaining.
          */
         public Builder disableCache() {
             mDisableCache = true;
             return this;
         }
 
-        /** @deprecated not really deprecated but hidden. */
+        /** @hide */
         @IntDef({
                 REQUEST_PRIORITY_IDLE, REQUEST_PRIORITY_LOWEST, REQUEST_PRIORITY_LOW,
                 REQUEST_PRIORITY_MEDIUM, REQUEST_PRIORITY_HIGHEST,
         })
         @Retention(RetentionPolicy.SOURCE)
-        @SuppressWarnings("DepAnn")
         public @interface RequestPriority {}
 
         /**
          * Lowest request priority. Passed to {@link #setPriority}.
          */
         public static final int REQUEST_PRIORITY_IDLE = 0;
         /**
          * Very low request priority. Passed to {@link #setPriority}.
          */
         public static final int REQUEST_PRIORITY_LOWEST = 1;
@@ skipping 55 matching lines @@
 
         /**
          * Associates the annotation object with this request. May add more than one.
          * Passed through to a {@link CronetEngine.RequestFinishedListener},
          * see {@link CronetEngine.UrlRequestInfo#getAnnotations}.
          *
          * @param annotation an object to pass on to the
          * {@link CronetEngine.RequestFinishedListener} with a {@link CronetEngine.UrlRequestInfo}.
          * @return the builder to facilitate chaining.
          *
-         * @deprecated not really deprecated but hidden for now as it's a prototype.
+         * @hide as it's a prototype.
          */
-        @Deprecated
         public Builder addRequestAnnotation(Object annotation) {
             if (annotation == null) {
                 throw new NullPointerException("Invalid metrics annotation.");
             }
             if (mRequestAnnotations.isEmpty()) {
                 mRequestAnnotations = new ArrayList<Object>();
             }
             mRequestAnnotations.add(annotation);
             return this;
         }
@@ skipping 132 matching lines @@
          * @param info Response information. May be {@code null} if no response was
          *         received.
          */
         public void onCanceled(UrlRequest request, UrlResponseInfo info) {}
     }
 
     /**
      * Request status values returned by {@link #getStatus}.
      */
     public static class Status {
-        /** @deprecated not really deprecated but hidden. */
+        /** @hide */
         @IntDef({
                 INVALID, IDLE, WAITING_FOR_STALLED_SOCKET_POOL, WAITING_FOR_AVAILABLE_SOCKET,
                 WAITING_FOR_DELEGATE, WAITING_FOR_CACHE, DOWNLOADING_PROXY_SCRIPT,
                 RESOLVING_PROXY_FOR_URL, RESOLVING_HOST_IN_PROXY_SCRIPT, ESTABLISHING_PROXY_TUNNEL,
                 RESOLVING_HOST, CONNECTING, SSL_HANDSHAKE, SENDING_REQUEST, WAITING_FOR_RESPONSE,
                 READING_RESPONSE,
         })
         @Retention(RetentionPolicy.SOURCE)
-        @SuppressWarnings("DepAnn")
         public @interface StatusValues {}
 
         /**
          * This state indicates that the request is completed, canceled, or is not
          * started.
          */
         public static final int INVALID = -1;
         /**
          * This state corresponds to a resource load that has either not yet begun
          * or is idle waiting for the consumer to do something to move things along
@@ skipping 172 matching lines @@
 
     /**
      * Sets the HTTP method verb to use for this request. Must be done before
      * request has started.
      *
      * <p>The default when this method is not called is "GET" if the request has
      * no body or "POST" if it does.
      *
      * @param method "GET", "HEAD", "DELETE", "POST" or "PUT".
      * @deprecated Use {@link Builder#setHttpMethod}.
+     * @hide
      */
     @Deprecated public void setHttpMethod(String method);
 
     /**
      * Adds a request header. Must be done before request has started.
      *
      * @param header header name.
      * @param value header value.
      * @deprecated Use {@link Builder#setPriority}.
+     * @hide
      */
     @Deprecated public void addHeader(String header, String value);
 
     /**
      * Sets upload data provider. Must be done before request has started. May only be
      * invoked once per request. Switches method to "POST" if not explicitly
      * set. Starting the request will throw an exception if a Content-Type
      * header is not set.
      *
      * @param uploadDataProvider responsible for providing the upload data.
      * @param executor All {@code uploadDataProvider} methods will be invoked
      *     using this {@code Executor}. May optionally be the same
      *     {@code Executor} the request itself is using.
      * @deprecated Use {@link Builder#setUploadDataProvider}.
+     * @hide
      */
     @Deprecated
     public void setUploadDataProvider(UploadDataProvider uploadDataProvider, Executor executor);
 
     /**
      * Starts the request, all callbacks go to {@link Callback}. May only be called
      * once. May not be called if {@link #cancel} has been called.
      */
     public void start();
 
@@ skipping 43 matching lines @@
      * finished (completed, canceled, or failed).
      * @return {@code true} if the request was successfully started and is now
      *         finished (completed, canceled, or failed).
      */
     public boolean isDone();
 
     /**
      * Disables cache for the request. If context is not set up to use cache,
      * this call has no effect.
      * @deprecated Use {@link Builder#disableCache}.
+     * @hide
      */
     // TODO(pauljensen): When all callers shifted to Builder.disableCache(),
     // remove this method and instead add constructor argument and make
     // CronetUrlRequest.mDisableCache final.
     @Deprecated public void disableCache();
 
     /**
      * Queries the status of the request.
      * @param listener a {@link StatusListener} that will be invoked with
      *         the request's current status. {@code listener} will be invoked
      *         back on the {@link Executor} passed in when the request was
      *         created.
      */
     public void getStatus(final StatusListener listener);
 
     // Note:  There are deliberately no accessors for the results of the request
     // here. Having none removes any ambiguity over when they are populated,
     // particularly in the redirect case.
 }