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.

[Charles, 2014/09/20 00:47:34]

You should enforce this by checking the calling thread ID

[mef, 2014/09/22 17:12:13]

Hmm, about executor, it doesn't seem to require thread affinity, does it? Do we
need to somehow limit that?

[Charles, 2014/09/22 21:22:54]

You can make sure that it's executing on the thread that the current callback is
being executed on, or pre-start that the object was constructed on. As I
understand it, the network stack guarantees that no two callbacks will ever run
concurrently.

  */
 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.
      *
      * <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.
-     * @param listener
      */
-    public void start(UrlRequestListener listener);
+    public void start();
 
     /**
      * Can be called at any time.
      */
     public void cancel();
 
     /**
      *
      * @return True if the request has been cancelled by the embedder.
      * TBD(mmenke): False in all other cases (Including errors).
@@ skipping 23 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.
      */
 }