Merge "Added javadoc to apn retry \ throttling related methods"

import android.annotation.Nullable;

import android.annotation.SystemApi;

import android.net.LinkAddress;

import android.net.LinkProperties;

import android.os.Parcel;

import android.os.Parcelable;

import android.telephony.Annotation.DataFailureCause;

    }

    /**

     * @return The network suggested data retry duration in milliseconds. {@code Long.MAX_VALUE}

     * indicates data retry should not occur. {@link #RETRY_DURATION_UNDEFINED} indicates network

     * did not suggest any retry duration.

     * @return The network suggested data retry duration in milliseconds as specified in

     * 3GPP TS 24.302 section 8.2.9.1.  The APN associated to this data call will be throttled for

     * the specified duration unless {@link DataServiceCallback#onApnUnthrottled} is called.

     * {@code Long.MAX_VALUE} indicates data retry should not occur.

     * {@link #RETRY_DURATION_UNDEFINED} indicates network did not suggest any retry duration.

     */

    public long getRetryDurationMillis() {

        return mSuggestedRetryTime;

    }

    /**

     * Indicates that the specified APN is no longer throttled.

     * The APN is throttled for the duration specified in

     * {@link DataCallResponse#getRetryDurationMillis}.  Calling this method unthrottles that

     * APN.

     * <p/>

     * see: {@link DataCallResponse#getRetryDurationMillis}

     *

     * @param apn Access Point Name defined by the carrier.

     */