Add new Cronet exception class for QUIC errors

components/cronet/android/api/src/org/chromium/net/UrlRequestException.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 java.io.IOException;
 
 /**
  * Exception passed to {@link UrlRequest.Callback#onFailed UrlRequest.Callback.onFailed()} when:
@@ skipping 55 matching lines @@
     /**
      * Error code indicating another type of error was encountered.
      * {@link #getCronetInternalErrorCode} can be consulted to get a more specific cause.
      */
     public static final int ERROR_OTHER = UrlRequestError.OTHER;
 
     // Error code, one of ERROR_*
     private final int mErrorCode;
     // Cronet internal error code.
     private final int mCronetInternalErrorCode;
+    // Cronet internal error details.
+    private final int mCronetInternalErrorDetails;
 
     /**
      * Constructs an exception with a specific error.
      *
      * @param message explanation of failure.
      * @param errorCode error code, one of {@link #ERROR_LISTENER_EXCEPTION_THROWN ERROR_*}.
      * @param cronetInternalErrorCode Cronet internal error code, one of
      * <a href=https://chromium.googlesource.com/chromium/src/+/master/net/base/net_error_list.h>
      * these</a>.
+     * @param cronetInternalErrorDetails Cronet internal error code details when the error code
+     * is QUIC_PROTOCOL_ERROR, from
+     * <a href=https://chromium.googlesource.com/chromium/src/+/master/net/quic/quic_protocol.h#503>
+     * this file</a>.
      */
-    public UrlRequestException(String message, int errorCode, int cronetInternalErrorCode) {
+    public UrlRequestException(String message, int errorCode, int cronetInternalErrorCode,
+            int cronetInternalErrorDetails) {
         super(message, null);
         mErrorCode = errorCode;
         mCronetInternalErrorCode = cronetInternalErrorCode;
+        mCronetInternalErrorDetails = cronetInternalErrorDetails;
     }
 
     /**
      * Constructs an exception that wraps {@code cause} thrown by a {@link UrlRequest.Callback}.
      *
      * @param message explanation of failure.
      * @param cause exception thrown by {@link UrlRequest.Callback} that's being wrapped.
      */
     public UrlRequestException(String message, Throwable cause) {
         super(message, cause);
         mErrorCode = ERROR_LISTENER_EXCEPTION_THROWN;
         mCronetInternalErrorCode = 0;
+        mCronetInternalErrorDetails = 0;
     }
 
     /**
      * Returns error code, one of {@link #ERROR_LISTENER_EXCEPTION_THROWN ERROR_*}.
      *
      * @return error code, one of {@link #ERROR_LISTENER_EXCEPTION_THROWN ERROR_*}.
      */
     public int getErrorCode() {
         return mErrorCode;
     }
 
     /**
      * Returns a Cronet internal error code. This may provide more specific error
      * diagnosis than {@link #getErrorCode}, but the constant values are not exposed to Java and
      * may change over time. See
      * <a href=https://chromium.googlesource.com/chromium/src/+/master/net/base/net_error_list.h>
      * here</a> for the lastest list of values.
      *
      * @return Cronet internal error code.
      */
     public int getCronetInternalErrorCode() {
         return mCronetInternalErrorCode;
     }
 
     /**
+     * Returns detailed information related to the Cronet internal error code. Currently this is a
+     * code from
+     * <a href=https://chromium.googlesource.com/chromium/src/+/master/net/quic/quic_protocol.h>
+     * QuicErrorCode</a> and is only meaningful if the Cronet internal error code is
+     * QUIC_PROTOCOL_ERROR.
+     */
+    public int getCronetInternalErrorDetails() {
+        return mCronetInternalErrorDetails;
+    }
+
+    /**
      * Returns {@code true} if retrying this request right away might succeed, {@code false}
      * otherwise. For example returns {@code true} when {@link #getErrorCode} returns
      * {@link #ERROR_NETWORK_CHANGED} because trying the request might succeed using the new
      * network configuration, but {@code false} when {@code getErrorCode()} returns
      * {@link #ERROR_INTERNET_DISCONNECTED} because retrying the request right away will
      * encounter the same failure (instead retrying should be delayed until device regains
      * network connectivity). Returns {@code false} when {@code getErrorCode()} returns
      * {@link #ERROR_LISTENER_EXCEPTION_THROWN}.
      *
      * @return {@code true} if retrying this request right away might succeed, {@code false}
@@ skipping 11 matching lines @@
                 return false;
             case ERROR_NETWORK_CHANGED:
             case ERROR_TIMED_OUT:
             case ERROR_CONNECTION_CLOSED:
             case ERROR_CONNECTION_TIMED_OUT:
             case ERROR_CONNECTION_RESET:
                 return true;
         }
     }
 }