BidirectionalStream.Builder

abstract class BidirectionalStream.Builder

‫Builder של BidirectionalStream. מאפשר להגדיר את הסטרים לפני שיוצרים אותו באמצעות build. נוצר על ידי newBidirectionalStreamBuilder.

סיכום

ערכים קבועים
const Int

רמת העדיפות הגבוהה ביותר לשידור.
const Int

העדיפות הכי נמוכה של הזרם.
const Int

עדיפות נמוכה לשידור.
const Int

עדיפות נמוכה מאוד של הזרם.
const Int

רמת עדיפות בינונית לשידור.

‫constructors ציבוריים

פונקציות ציבוריות
abstract BidirectionalStream.Builder!
addHeader(header: String!, value: String!)

מוסיף כותרת בקשה.
BidirectionalStream.Builder!
addRequestAnnotation(annotation: Any!)

משייך את אובייקט ההערה לבקשה הזו.
BidirectionalStream.Builder!
bindToNetwork(networkHandle: Long)

הפונקציה מקשרת את הבקשה לטיפול ברשת שצוין.
abstract BidirectionalStream!

יוצרת BidirectionalStream באמצעות הגדרות מ-Builder הזה.
abstract BidirectionalStream.Builder!
delayRequestHeadersUntilFirstFlush(
    delayRequestHeadersUntilFirstFlush: Boolean
)

השליחה של כותרות הבקשות מתעכבת עד שמפעילים את flush.
abstract BidirectionalStream.Builder!

מגדיר את ה-method של ה-HTTP לבקשה.
abstract BidirectionalStream.Builder!
setPriority(priority: Int)

מגדיר את העדיפות של הזרם, שצריכה להיות אחת מSTREAM_PRIORITY_* הערכים.
BidirectionalStream.Builder!

מגדיר תג android.net.TrafficStats לשימוש כשמדווחים על תנועת שקעים שנגרמת כתוצאה מהבקשה הזו.
BidirectionalStream.Builder!

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

ערכים קבועים

STREAM_PRIORITY_HIGHEST

const val STREAM_PRIORITY_HIGHEST = 4: Int

רמת העדיפות הגבוהה ביותר לשידור. הועבר אל setPriority.

STREAM_PRIORITY_IDLE

const val STREAM_PRIORITY_IDLE = 0: Int

העדיפות הכי נמוכה של הזרם. הועבר אל setPriority.

STREAM_PRIORITY_LOW

const val STREAM_PRIORITY_LOW = 2: Int

עדיפות נמוכה לשידור. הועבר אל setPriority.

STREAM_PRIORITY_LOWEST

const val STREAM_PRIORITY_LOWEST = 1: Int

עדיפות נמוכה מאוד של הזרם. הועבר אל setPriority.

STREAM_PRIORITY_MEDIUM

const val STREAM_PRIORITY_MEDIUM = 3: Int

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

‫constructors ציבוריים

בנאי

Builder()

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

addHeader

abstract fun addHeader(header: String!, value: String!): BidirectionalStream.Builder!

מוסיף כותרת בקשה. מחזירה builder כדי לאפשר שרשור.

פרמטרים
header: String!

שם הכותרת
value: String!

ערך הכותרת
החזרות
BidirectionalStream.Builder!

הכלי ליצירת מבצעים כדי להקל על שרשור מבצעים

addRequestAnnotation

fun addRequestAnnotation(annotation: Any!): BidirectionalStream.Builder!

משייך את אובייקט ההערה לבקשה הזו. אפשר להוסיף יותר מאישור אחד. הועבר אל RequestFinishedInfo.Listener, ראו getAnnotations.

פרמטרים
annotation: Any!

אובייקט להעברה אל RequestFinishedInfo.Listener עם RequestFinishedInfo.
החזרות
BidirectionalStream.Builder!

הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

bindToNetwork

fun bindToNetwork(networkHandle: Long): BidirectionalStream.Builder!

הפונקציה מקשרת את הבקשה לטיפול ברשת שצוין. ‫Cronet ישלח את הבקשה הזו רק באמצעות הרשת שמשויכת ל-handle הזה. אם הרשת הזו מתנתקת, הבקשה תיכשל. השגיאה המדויקת תהיה תלויה בשלב העיבוד של הבקשה בזמן שהרשת מתנתקת. אפשר לקבל כינויים לרשת דרך Network#getNetworkHandle. התכונה זמינה רק החל מ-Android Marshmallow.

פרמטרים
networkHandle: Long

ה-handle של הרשת שאליה רוצים לקשר את הבקשה. מציינים את UNBIND_NETWORK_HANDLE כדי לבטל את הקישור.
החזרות
BidirectionalStream.Builder!

הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

לבנות גרסת build

abstract fun build(): BidirectionalStream!

יוצרת BidirectionalStream באמצעות הגדרות מ-Builder הזה. אחרי כן אפשר להפעיל את BidirectionalStream שהוחזר על ידי קריאה ל-start.

החזרות
BidirectionalStream!

ההגדרה האישית BidirectionalStream נוצרה באמצעות ההגדרה האישית Builder

delayRequestHeadersUntilFirstFlush

abstract fun delayRequestHeadersUntilFirstFlush(
    delayRequestHeadersUntilFirstFlush: Boolean
): BidirectionalStream.Builder!

השליחה של כותרות הבקשות מתעכבת עד שמפעילים את flush. בשלב הזה, הדגל הזה נלקח בחשבון רק כשמתנהל משא ומתן על פרוטוקול QUIC. אם הערך הוא true, פרוטוקול QUIC ישלח את מסגרת כותרת הבקשה יחד עם מסגרות הנתונים כמנה אחת, אם אפשר.

פרמטרים
delayRequestHeadersUntilFirstFlush: Boolean

אם הערך הוא true, שליחת כותרות הבקשה תתעכב עד לקריאה ל-flush().
החזרות
BidirectionalStream.Builder!

הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

setHttpMethod

abstract fun setHttpMethod(method: String!): BidirectionalStream.Builder!

מגדיר את ה-method של ה-HTTP לבקשה. מחזירה builder כדי לאפשר שרשור.

פרמטרים
method: String!

השיטה שבה צריך להשתמש בשביל הבקשה. ברירת המחדל היא 'POST'
החזרות
BidirectionalStream.Builder!

הכלי ליצירת מבצעים כדי להקל על שרשור מבצעים

setPriority

abstract fun setPriority(priority: Int): BidirectionalStream.Builder!

מגדיר את העדיפות של הזרם, שצריכה להיות אחת מSTREAM_PRIORITY_* הערכים. אם לא מפעילים את ה-method הזו, הסטרים מקבל עדיפות STREAM_PRIORITY_MEDIUM.

פרמטרים
priority: Int

העדיפות של הזרם, שצריכה להיות אחת מ- STREAM_PRIORITY_* הערכים.
החזרות
BidirectionalStream.Builder!

הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

setTrafficStatsTag

fun setTrafficStatsTag(tag: Int): BidirectionalStream.Builder!

מגדיר תג android.net.TrafficStats לשימוש כשמדווחים על תנועת שקעים שנגרמת כתוצאה מהבקשה הזו. מידע נוסף זמין בandroid.net.TrafficStats. אם לא מוגדר תג (למשל, אם לא מתבצעת קריאה לשיטה הזו), מערכת Android מתייחסת לתנועת הנתונים בשקע שנגרמת מהבקשה הזו כאילו ערך התג הוגדר כ-0.

הערה: הגדרת תג אוסרת על שיתוף של שקעים עם בקשות עם תגים אחרים, וזה עלול לפגוע בביצועים כי זה מונע שיתוף חיבורים. במילים אחרות, השימוש בשקעים מרובי-ערוצים (למשל HTTP/2 ו-QUIC) יתאפשר רק אם לכל הבקשות יש אותו תג שקע.

פרמטרים
tag: Int

ערך התג שמשמש לחישוב תנועת הסוקטים שנגרמת כתוצאה מהבקשה הזו. תגים בין 0xFFFFFF00 ל-0xFFFFFFFF שמורים ומשמשים באופן פנימי את שירותי המערכת כמו android.app.DownloadManager כשמבצעים תעבורה בשם אפליקציה.
החזרות
BidirectionalStream.Builder!

הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

setTrafficStatsUid

fun setTrafficStatsUid(uid: Int): BidirectionalStream.Builder!

מגדיר מזהה משתמש ספציפי לשימוש כשמדובר בתנועת גולשים בשקע שנגרמת כתוצאה מהבקשה הזו. מידע נוסף זמין בכתובת android.net.TrafficStats. מיועד לשימוש כשמבצעים פעולה בשם אפליקציה אחרת. למתקשר צריכה להיות הרשאת MODIFY_NETWORK_ACCOUNTING. כברירת מחדל, התנועה משויכת ל-UID של המתקשר.

הערה: הגדרת UID אוסרת על שיתוף של שקעים עם בקשות עם UID אחרים, מה שעשוי להשפיע לרעה על הביצועים כי הוא אוסר על שיתוף חיבורים. במילים אחרות, השימוש בשקעים מרובי-ערוצים (למשל HTTP/2 ו-QUIC) יתאפשר רק אם לכל הבקשות מוגדר אותו מזהה ייחודי.

פרמטרים
uid: Int

מזהה המשתמש (UID) לצירוף תנועת שקעים שנגרמת כתוצאה מהבקשה הזו.
החזרות
BidirectionalStream.Builder!

הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.