DnsOptions.StaleDnsOptions.Builder

public DnsOptions.StaleDnsOptions.Builder allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

מגדירה אם להחזיר תוצאות שמקורן ברשתות אחרות או לא. בדרך כלל, Cronet מנקה את מטמון ה-DNS לחלוטין כשעוברים בין חיבורים, למשל בין שתי רשתות Wi-Fi או מ-Wi-Fi ל-4G.

public DnsOptions.StaleDnsOptions build()

יוצרת ומחזירה את מופע StaleDnsOptions הסופי, על סמך הערכים ב-builder הזה.

@RequiresApi(value = VERSION_CODES.O)
public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeout(@NonNull Duration freshLookupTimeout)

בדיוק כמו במכשיר setFreshLookupTimeoutMillis, אבל באמצעות java.time.Duration.

public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

ההגדרה הזו קובעת את משך הזמן (באלפיות שנייה) להמתנה עד שיתקבל החזר מבקשת DNS, לפני שימוש בתוצאה לא עדכנית במקום זאת. אם הערך הוא אפס, התוצאות המיושנות מוחזרות באופן מיידי, אבל בקשת ה-DNS ממשיכה ברקע כדי לעדכן את המטמון.

@RequiresApi(value = VERSION_CODES.O)
public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelay(@NonNull Duration maxExpiredDelay)

בדיוק כמו במכשיר setMaxExpiredDelayMillis, אבל באמצעות java.time.Duration.

public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

מגדיר כמה זמן (באלפיות שנייה) אחרי תאריך התפוגה יתבצע שימוש בתוצאות שתוקף שלהן פג. הגדרת הערך לאפס פירושה שאפשר להשתמש ברשומות שפג תוקפן ללא הגבלה.

public DnsOptions.StaleDnsOptions.Builder useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

ההגדרה קובעת אם לאפשר שימוש בתוצאות DNS לא עדכניות אם מקודד הרשת לא מצליח לפענח את שם המארח.

בהתאם לתרחיש השימוש, אם Cronet מזהה במהירות כשל חדש, יכול להיות שעדיף להשתמש בכשל הזה כי מבחינה טכנית הוא התוצאה העדכנית ביותר, והייתה לנו תוצאה עדכנית כזו במהירות. לחלופין, יכול להיות שעדיף לקבל תוצאה כלשהי (גם אם היא לא עדכנית) מאשר לקבל כשל.