DnsOptions.StaleDnsOptions.Builder

public final class DnsOptions.StaleDnsOptions.Builder


أداة إنشاء StaleDnsOptions

ملخّص

الإجراءات العامة

DnsOptions.StaleDnsOptions.Builder
allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

تضبط هذه الطريقة ما إذا كان سيتم عرض النتائج الواردة من شبكات أخرى أم لا.

DnsOptions.StaleDnsOptions

تنشئ هذه الطريقة وتعرض مثيل StaleDnsOptions النهائي استنادًا إلى القيم في أداة الإنشاء هذه.

DnsOptions.StaleDnsOptions.Builder

هذه الطريقة مماثلة لطريقة setFreshLookupTimeoutMillis ولكنّها تستخدم java.time.Duration.

DnsOptions.StaleDnsOptions.Builder
setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

تضبط هذه الطريقة المدة (بالملّي ثانية) التي يجب انتظارها لكي يعرض طلب نظام أسماء النطاقات (DNS) نتيجة قبل استخدام نتيجة قديمة بدلاً منها.

DnsOptions.StaleDnsOptions.Builder

هذه الطريقة مماثلة لطريقة setMaxExpiredDelayMillis ولكنّها تستخدم java.time.Duration.

DnsOptions.StaleDnsOptions.Builder
setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

تضبط هذه الطريقة المدة (بالملّي ثانية) التي يمكن خلالها استخدام النتائج المنتهية الصلاحية بعد انتهاء صلاحيتها.

DnsOptions.StaleDnsOptions.Builder
useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

تضبط هذه الطريقة ما إذا كان سيتم السماح باستخدام نتائج نظام أسماء النطاقات القديمة عندما يتعذّر على أداة حلّ الشبكة حلّ اسم المضيف.

الإجراءات العامة

allowCrossNetworkUsage

public DnsOptions.StaleDnsOptions.Builder allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

تضبط هذه الطريقة ما إذا كان سيتم عرض النتائج الواردة من شبكات أخرى أم لا. في العادة، يمحو Cronet ذاكرة التخزين المؤقت لنظام أسماء النطاقات بالكامل عند تبديل الاتصالات، مثلاً بين شبكتَي Wi-Fi أو من شبكة Wi-Fi إلى شبكة الجيل الرابع.

المرتجعات
DnsOptions.StaleDnsOptions.Builder

أداة الإنشاء للربط

build

public DnsOptions.StaleDnsOptions build()

تنشئ هذه الطريقة وتعرض مثيل StaleDnsOptions النهائي استنادًا إلى القيم في أداة الإنشاء هذه.

setFreshLookupTimeout

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

هذه الطريقة مماثلة لطريقة setFreshLookupTimeoutMillis ولكنّها تستخدم java.time.Duration.

المرتجعات
DnsOptions.StaleDnsOptions.Builder

أداة الإنشاء للربط

setFreshLookupTimeoutMillis

public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

تضبط هذه الطريقة المدة (بالملّي ثانية) التي يجب انتظارها لكي يعرض طلب نظام أسماء النطاقات (DNS) نتيجة قبل استخدام نتيجة قديمة بدلاً منها. إذا تم ضبط القيمة على صفر، يتم عرض النتائج القديمة على الفور، ولكن يستمر طلب نظام أسماء النطاقات في الخلفية لتعديل ذاكرة التخزين المؤقت.

المرتجعات
DnsOptions.StaleDnsOptions.Builder

أداة الإنشاء للربط

setMaxExpiredDelay

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

هذه الطريقة مماثلة لطريقة setMaxExpiredDelayMillis ولكنّها تستخدم java.time.Duration.

المرتجعات
DnsOptions.StaleDnsOptions.Builder

أداة الإنشاء للربط

setMaxExpiredDelayMillis

public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

تضبط هذه الطريقة المدة (بالملّي ثانية) التي يمكن خلالها استخدام النتائج المنتهية الصلاحية بعد انتهاء صلاحيتها. إذا تم ضبط القيمة على صفر، يمكن استخدام السجلات المنتهية الصلاحية إلى أجل غير مسمّى.

المرتجعات
DnsOptions.StaleDnsOptions.Builder

أداة الإنشاء للربط

useStaleOnNameNotResolved

public DnsOptions.StaleDnsOptions.Builder useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

تضبط هذه الطريقة ما إذا كان سيتم السماح باستخدام نتائج نظام أسماء النطاقات القديمة عندما يتعذّر على أداة حلّ الشبكة حلّ اسم المضيف.

استنادًا إلى حالة الاستخدام، إذا رصد Cronet بسرعة عملية فشل جديدة، قد يكون من المستحسن استخدام الفشل لأنّه من الناحية الفنية النتيجة الأحدث، وقد حصلنا على هذه النتيجة الجديدة بسرعة. أو قد يكون من الأفضل الحصول على أي نتيجة (حتى لو كانت قديمة) بدلاً من الحصول على نتيجة فشل.

المرتجعات
DnsOptions.StaleDnsOptions.Builder

أداة الإنشاء للربط