Added javadoc to apn retry \ throttling related methods

Bug: 175092152
Test: N/A
Change-Id: I35a3b97f3e52eef68310a92178bb14495641c6e7
This commit is contained in:
Daniel Bright
2021-01-08 14:44:50 -08:00
parent 3c72f3de1f
commit 8cba5a0f7c
2 changed files with 11 additions and 4 deletions

View File

@@ -22,6 +22,7 @@ import android.annotation.NonNull;
import android.annotation.Nullable; import android.annotation.Nullable;
import android.annotation.SystemApi; import android.annotation.SystemApi;
import android.net.LinkAddress; import android.net.LinkAddress;
import android.net.LinkProperties;
import android.os.Parcel; import android.os.Parcel;
import android.os.Parcelable; import android.os.Parcelable;
import android.telephony.Annotation.DataFailureCause; import android.telephony.Annotation.DataFailureCause;
@@ -276,9 +277,11 @@ public final class DataCallResponse implements Parcelable {
} }
/** /**
* @return The network suggested data retry duration in milliseconds. {@code Long.MAX_VALUE} * @return The network suggested data retry duration in milliseconds as specified in
* indicates data retry should not occur. {@link #RETRY_DURATION_UNDEFINED} indicates network * 3GPP TS 24.302 section 8.2.9.1. The APN associated to this data call will be throttled for
* did not suggest any retry duration. * 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() { public long getRetryDurationMillis() {
return mSuggestedRetryTime; return mSuggestedRetryTime;

View File

@@ -250,7 +250,11 @@ public class DataServiceCallback {
} }
/** /**
* 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. * @param apn Access Point Name defined by the carrier.
*/ */