Initial implementation of Cronet Async API.

components/cronet/android/java/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;
 
 /**
  * HTTP request (GET, PUT or POST).
  * Note:  All methods must be called on the Executor passed in during creation.
  */
 public interface UrlRequest {
+    public static final int REQUEST_PRIORITY_IDLE = 0;
+
+    public static final int REQUEST_PRIORITY_LOWEST = 1;
+
+    public static final int REQUEST_PRIORITY_LOW = 2;
+
+    public static final int REQUEST_PRIORITY_MEDIUM = 3;
+
+    public static final int REQUEST_PRIORITY_HIGHEST = 4;
+
     /**
      * More setters go here.  They may only be called before start (Maybe
      * also allow during redirects).  Could optionally instead use arguments
      * to URLRequestFactory when creating the request.
      */
 
     /**
      * Sets the HTTP method verb to use for this request.

[mmenke, 2014/11/06 17:31:29]

All of these should mention they may not be called if the request has been
started (And maybe cancelled?  The latter case may not be worth mentioning)

[mef, 2014/11/06 22:51:47]

Done.

      *
      * <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".
      */
     public void setHttpMethod(String method);
 
     /**
      * Adds a request header. Must be done before request has started.
      *
      * @param header Header name
      * @param value Header value
      */
     public void addHeader(String header, String value);
 
     /**
      * Starts the request, all callbacks go to listener.

[mmenke, 2014/11/06 17:31:29]

May only be called once.  May not be called if cancel has been called on the
request.

[mef, 2014/11/06 22:51:47]

Done.

-     * @param listener
      */
-    public void start(UrlRequestListener listener);
+    public void start();
 
     /**
      * Can be called at any time.

[mmenke, 2014/11/06 17:31:29]

+"If the Executor passed to UrlRequest on construction runs tasks on a single
thread, and cancel is called on that thread, no listener methods will be invoked
after cancel is called.  Otherwise, at most one listener method may be made
after cancel has completed."

[mef, 2014/11/06 22:51:47]

Done.

      */
     public void cancel();
 
     /**
      *

[mmenke, 2014/11/06 17:31:29]

nit:  Remove blank line.

[mef, 2014/11/06 22:51:47]

Done.

      * @return True if the request has been cancelled by the embedder.
      * TBD(mmenke): False in all other cases (Including errors).
      */
     public boolean isCanceled();
 
     /**
      * Can be called at any time, but the request may continue behind the
      * scenes, depending on when it's called.  None of the listener's methods
      * will be called while paused, until and unless the request is resumed.
      * (Note:  This allows us to have more than one ByteBuffer in flight,
@@ skipping 15 matching lines @@
      */
     public void resume();
 
     /**
      * 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.
      */
 }