סקירה כללית

מחלקה מסייעת לפתיחת קונטיינרים.

זוהי wrapper במסגרת השיטה openContainerById:callback: (TAGManager) למתקשרים שמספקת תמיכה בזמנים קצובים לתפוגה.

הדוגמה הבאה היא דוגמה שממתינה עד 0.1 שניות לטעינת הקונטיינר לפני שחוזרים למאגר ברירת המחדל:

     NSTimeInterval timeout = 0.1;
     TagManager *tagManager = [TagManager instance];
     TAGContainerFuture *future =
         [TAGContainerOpener openContainerWithId:@"GTM-XXXX"
                                      tagManager:tagManager
                                        openType:kTAGOpenTypePreferNonDefault
                                         timeout:&timeout];
     TAGContainer *container = [future get];

אם מבצע הקריאה החוזרת רוצה לקבל הודעה באופן אסינכרוני כשמאגר התגים זמין, אבל הוא רוצה לציין באופן ידני את הזמן הקצוב לתפוגה של 0.5 שניות, עליו לבצע את הקריאה החוזרת למחלקה המשנית TAGContainerOpenerNotifier, לבצע את הקריאה ל-openContainerWithId:tagManager:openType:timeout:notifier: (TAGContainerOpener) עם הזמן הקצוב לתפוגה שמוגדר ל-0.5, ולהוסיף את ההטמעה ל-containerAvailability.

פונקציות סטטיות של חברים ציבוריים
(מזהה< TAGContainerFuture >)	+ openContainerWithId:tagManager:openType:timeout:
	המתנה של עד `timeout` שניות לטעינה של מאגר (לא ברירת המחדל או עדכני, בהתאם ל-`openType` שצוין) ומחזירה `TAGContainerFuture`.
(מבוטל)	+ openContainerWithId:tagManager:openType:timeout:notifier:
	המתנה של עד `timeout` שניות לטעינה של מאגר (לא ברירת מחדל או חדש, בהתאם ל-`openType` שצוין) ושולחת התראה כשהמאגר זמין.
(NSTimeInterval)	+ defaultTimeout
	הפונקציה מחזירה את הזמן הקצוב לתפוגה שמוגדר כברירת מחדל לבקשת מאגר התגים.

מסמכי תיעוד בנושא פונקציות של חברים

+ (מזהה<TAGContainerFuture>) openContainerWithId:	(NSString *)	containerId
tagManager:	(TAGManager *)	tagManager
openType:	(TAGOpenType)	openType
פסק זמן:	(NSTimeInterval *)	זמן קצוב לתפוגה

המתנה של עד timeout שניות לטעינה של מאגר (לא ברירת המחדל או עדכני, בהתאם ל-openType שצוין) ומחזירה TAGContainerFuture.

אם הסוג הפתוח הוא kTAGOpenTypePreferNonDefault, נטען קונטיינר שלא מוגדר כברירת מחדל (נשמר או אוחזר מהרשת), והחסימה של TAGContainerFuture בוטלה ברגע שמתרחש אחד מהתנאים הבאים:

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

אם מתרחשת שגיאת רשת או שתוקף הטיימר פג, הפעולה get (TAGContainerFuture-p) עשויה להחזיר קונטיינר שמוגדר כברירת מחדל.

אם הסוג הפתוח הוא kTAGOpenTypePreferFresh, נטען קונטיינר חדש (נשמר או אוחזר מהרשת), והחסימה של TAGContainerFuture מתבטלת ברגע שמתרחש אחד מהתנאים הבאים:

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

אם מתרחשת שגיאת רשת או שתוקף הטיימר פג, הפקודה get (TAGContainerFuture-p) עשויה להכיל ברירות מחדל או מאגר תגים שנשמר ללא פעילות.

אם שולחים קריאה לאחת מה-methods של openContainer פעם שנייה עם ערך containerId נתון, יוחזר TAGContainerFuture שה-get (TAGContainerFuture-p) שלו יחזיר את אותו הקונטיינר שבו בוצעה הקריאה הראשונה.

פרמטרים:

containerId	מזהה ה-container (מאגר התגים שצריך לטעון).
tagManager	ה-TAGManager לקבלת מאגר התגים.
פסק זמן	מספר השניות המקסימלי שצריך להמתין לטעינת המכל מהחנות שנשמרה. אם הערך הוא nil, המערכת תשתמש ב-defaultTimeout.
openType	הבחירה איך לפתוח את הקונטיינר.

החזרות:: TAGContainerFuture ימתין עד timeout ויחזיר את הקונטיינר כשהוא יהיה זמין.

+ (ריק) openContainerWithId:	(NSString *)	containerId
tagManager:	(TAGManager *)	tagManager
openType:	(TAGOpenType)	openType
פסק זמן:	(NSTimeInterval *)	זמן קצוב לתפוגה
notifier:	(מזהה< TAGContainerOpenerNotifier >)	שירות הודעות

המתנה של עד timeout שניות לטעינה של מאגר (לא ברירת מחדל או חדש, בהתאם ל-openType שצוין) ושולחת התראה כשהמאגר זמין.

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

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

אם מתרחשת שגיאת רשת או שתוקף הטיימר פג, המאגר שמועבר לשירות המיידע הוא מאגר תגים שמוגדר כברירת מחדל.

אם הסוג הפתוח הוא kTAGOpenTypePreferFresh, מאגר חדש (נשמר או אוחזר מהרשת) נטען ומועבר לשירות ההתראות. תישלח קריאה לשירות המיידע ברגע שמתקיים אחד מהתנאים הבאים:

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

אם מתרחשת שגיאת רשת או שתוקף הטיימר פג, המאגר שמועבר לשירות ההתראות עשוי להכיל ברירות מחדל או מאגר שמור שלא פעיל.

אם קוראים לאחת מה-methods של openContainer פעם שנייה עם containerId נתון, אותו קונטיינר שיוחזר מהקריאה הקודמת יועבר לשירות המיידע ברגע שהוא יהיה זמין.

פרמטרים:

containerId	מזהה ה-container (מאגר התגים שצריך לטעון).
tagManager	ה-TAGManager ששימש לקבלת מאגר התגים.
openType	הבחירה איך לפתוח את הקונטיינר.
פסק זמן	מספר השניות המקסימלי שצריך להמתין לטעינת המכל מהחנות שנשמרה. אם הערך הוא nil, המערכת תשתמש ב-defaultTimeout.
מודיע	התראה אופציונלית שתיקרא כשהמאגר יהיה זמין. היא תופעל עם מאגר התגים החדש, אם הוא זמין וייטען לפני הזמן הקצוב לתפוגה. אחרת, הוא ייקרא עם מכל לא חדש. חשוב לזכור שיכול להיות שיתבצע קריאה לשירות ההתראות משרשור אחר.

+ (NSTimeInterval) defaultTimeout

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

החזרות:: ברירת המחדל של הזמן הקצוב לתפוגה בשניות.

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

סקירה כללית

פונקציות סטטיות של חברים ציבוריים

מסמכי תיעוד בנושא פונקציות של חברים

הפניה לכיתה של TAGContainerOpener