CronetProvider

abstract class CronetProvider

מחלקות משנה ישירות מוכרות
HttpEngineNativeProvider

הטמעה של ספק Cronet שנטען מההטמעה של HttpEngine מפלטפורמת Android.

JavaCronetProvider

הטמעה של CronetProvider שיוצרת CronetEngine.Builder כדי לבנות את ההטמעה מבוססת-Java של CronetEngine.


נוספה שיטת פקטורי (factory) ליצירת מופעים של CronetEngine.Builder. אפשר להשתמש במכונת CronetEngine.Builder כדי ליצור הטמעה ספציפית של CronetEngine. כדי לקבל את רשימת הפקודות הזמינות, מתקשרים אל CronetProvidergetAllProviderInfos.

הערה: הכיתה הזו מיועדת למשתמשים מתקדמים שרוצים לבחור הטמעה מסוימת של Cronet. רוב המשתמשים צריכים פשוט להשתמש ב-newCronetEngine.Builder.

סיכום

ערכים קבועים

const String!
PROVIDER_NAME_APP_PACKAGED = "App-Packaged-Cronet-Provider"

מחרוזת שמוחזרת על ידי getName עבור CronetProvider ומספקת הטמעה מקורית של Cronet שנארזת בתוך אפליקציה.

const String!
PROVIDER_NAME_FALLBACK = "Fallback-Cronet-Provider"

מחרוזת שמוחזרת על ידי getName עבור CronetProvider ומספקת הטמעה של Cronet על סמך ההטמעה של java.net.HttpURLConnection במערכת.

const String!
PROVIDER_NAME_HTTPENGINE_NATIVE = "HttpEngine-Native-Provider"

מחרוזת שמוחזרת על ידי getName עבור CronetProvider ומספקת הטמעה של Cronet על סמך ההטמעה של HttpEngine שקיימת בפלטפורמה.

‫Constructors מוגנים

פונקציות ציבוריות

abstract CronetEngine.Builder!

יוצרת מופע של CronetEngine.Builder ומחזירה אותו.

java-static (Mutable)List<CronetProvider!>!

הפונקציה מחזירה רשימה של כל ה-CronetProviders הזמינים, שלא ניתן לשנות אותה.

abstract String!

מחזירה את שם הספק.

abstract String!

הפונקציה מחזירה את גרסת הספק.

abstract Boolean

הפונקציה מחזירה את הערך true אם הספק מופעל ואפשר להשתמש בו כדי ליצור מופע של מנוע Cronet, ואת הערך false אם הספק לא מופעל.

String!

נכסים מוגנים

Context!

ערכים קבועים

PROVIDER_NAME_APP_PACKAGED

const val PROVIDER_NAME_APP_PACKAGED = "App-Packaged-Cronet-Provider": String!

מחרוזת שמוחזרת על ידי getName עבור CronetProvider ומספקת הטמעה מקורית של Cronet שנארזת בתוך אפליקציה. ההטמעה הזו מציעה ביצועים טובים משמעותית בהשוואה להטמעות של Cronet לגיבוי (ראו PROVIDER_NAME_FALLBACK).

PROVIDER_NAME_FALLBACK

const val PROVIDER_NAME_FALLBACK = "Fallback-Cronet-Provider": String!

מחרוזת שמוחזרת על ידי getName עבור CronetProvider ומספקת הטמעה של Cronet על סמך ההטמעה של java.net.HttpURLConnection במערכת. ההטמעה הזו מציעה ביצועים נחותים משמעותית בהשוואה להטמעות מקומיות של Cronet (ראו PROVIDER_NAME_APP_PACKAGED).

PROVIDER_NAME_HTTPENGINE_NATIVE

const val PROVIDER_NAME_HTTPENGINE_NATIVE = "HttpEngine-Native-Provider": String!

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

‫Constructors מוגנים

CronetProvider

protected CronetProvider(context: Context!)

פונקציות ציבוריות

createBuilder

abstract fun createBuilder(): CronetEngine.Builder!

יוצרת מופע של CronetEngine.Builder ומחזירה אותו.

הערה: הכיתה הזו מיועדת למשתמשים מתקדמים שרוצים לבחור הטמעה מסוימת של Cronet. רוב המשתמשים צריכים פשוט להשתמש ב-newCronetEngine.Builder.
החזרות
CronetEngine.Builder!

CronetEngine.Builder.

הקפצת הודעות שגיאה (throw)
java.lang.IllegalStateException

אם הספק לא מופעל (ראו isEnabled.

getAllProviders

java-static fun getAllProviders(context: Context!): (Mutable)List<CronetProvider!>!

הפונקציה מחזירה רשימה של כל ה-CronetProviders הזמינים, שלא ניתן לשנות אותה. הספקים מוחזרים ללא סדר מסוים. יכול להיות שחלק מהספקים שמוחזרים מושבתים, והמפעיל צריך להפעיל אותם. isEnabled.

החזרות
(Mutable)List<CronetProvider!>!

רשימת הספקים הזמינים.

getName

abstract fun getName(): String!

מחזירה את שם הספק. שמות הספקים המוכרים כוללים:

החזרות
String!

שם הספק.

getVersion

abstract fun getVersion(): String!

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

החזרות
String!

גרסת הספק.

isEnabled

abstract fun isEnabled(): Boolean

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

החזרות
Boolean

true אם הספק מופעל.

toString

fun toString(): String!

נכסים מוגנים

mContext

protected val mContextContext!