אובייקט שמספק גישה לערכים של מאגר.
יש ליצור אובייקטים של מאגר באמצעות openContainer(String, Container.Callback) או
ContainerOpener.
אחרי שיוצרים מאגר, אפשר לשלוח אליו שאילתה לגבי ערכי מפתח שתלויים בכללים שנקבעו לקונטיינר.
מאגר התגים מתרענן מדי פעם באופן אוטומטי (כל 12 שעות), אבל אפשר גם לרענן אותו באופן ידני באמצעות refresh().
סיכום של הכיתה המוצבת
| משופר | Container.Callback | הקריאה החוזרת תופעל אחרי שהמשאב ייטען בהצלחה. | |
| משופר | Container.FunctionCallMacroHandler | רכיב ה-handler שסופק על ידי האפליקציה לחישוב הערך של מאקרו מותאם אישית. | |
| משופר | Container.FunctionCallTagHandler | אפליקציית handler שסופקה על ידי האפליקציה לצורך הפעלת תג מותאם אישית. | |
| טיפוסים בני מנייה (enum) | Container.RefreshFailure | דרכים שבהן רענון יכול להיכשל. | |
| טיפוסים בני מנייה (enum) | Container.RefreshType | מקור הרענון של הקונטיינר. | |
סיכום אמצעי תשלום ציבורי
| מסונכרן בטל |
close()
|
| boolean |
getBoolean(מפתח מחרוזת)
|
| מחרוזת | |
| כפולה |
getDouble(מפתח מחרוזת)
|
| מסונכרן Container.FunctionCallMacroHandler |
getFunctionCallMacroHandler(המחרוזת customMacroName)
|
| מסונכרן Container.FunctionCallTagHandler |
getFunctionCallTagHandler(מחרוזת customTagName)
|
| long | |
| long |
getLong(מפתח מחרוזת)
|
| מחרוזת |
getString(מפתח מחרוזת)
|
| boolean | |
| מסונכרן בטל |
refresh()
|
| מסונכרן בטל | |
| מסונכרן בטל |
registerFunctionCallTagHandler(מחרוזת customTagName, Container.FunctionCallTagHandler customTagHandler)
|
שיטות ציבוריות
ציבורי פג תוקף מסונכרן סגירה ()
סוגר את המאגר כדי שלא יתבצע רענון שלו יותר. לאחר הסגירה, אין להשתמש בו.
Public בוליאני getBoolean (מחרוזת מפתח)
מחזירה ערך בוליאני שמייצג את ערך התצורה של המפתח הנתון. אם לקונטיינר אין ערך למפתח הזה, יוחזר FALSE.
Public מחרוזת getContainerId ()
מחזירה את מזהה המאגר.
Public כפול getDouble (מחרוזת מפתח)
מחזירה כפולה שמייצגת את ערך התצורה של המפתח הנתון. אם הקונטיינר לא מכיל ערך למפתח הזה, יוחזר 0.
ציבורי מסונכרן Container.FunctionCallMacroHandler getFunctionCallMacroHandler (String customMacroName)
מחזירה את ה-handler של המאקרו שרשום למאקרו נתון להפעלת פונקציה.
Public מסונכרן Container.FunctionCallTagHandler getFunctionCallTagHandler (String customTagName)
מחזירה את ה-handler של התגים שרשום עבור תג הקריאה לפונקציה הנתון.
ציבורי ארוך getLastRefreshTime ()
מחזירה את הזמן האחרון (באלפיות שנייה מאז חצות, ה-1 בינואר 1970 UTC) שבו התבצע רענון של מאגר זה מהרשת.
Public ארוך getLong (מחרוזת מפתח)
מחזירה ערך ארוך שמייצג את ערך התצורה של המפתח הנתון. אם הקונטיינר לא מכיל ערך למפתח הזה, יוחזר 0.
Public מחרוזת getString (מחרוזת מפתח)
מחזירה מחרוזת המייצגת את ערך התצורה של המפתח הנתון. אם לקונטיינר אין ערך למפתח הזה, תוחזר מחרוזת ריקה.
Public בוליאנית isDefault ()
מחזירה אם זהו מאגר ברירת מחדל או כזה שרענן מהשרת.
ציבורי מסונכרן וריק רענון ()
המערכת שולחת בקשה לרענון של המאגר הזה מהרשת. השיחה הזו אסינכרונית, לכן הרענון יתבצע בשרשור אחר.
אחרי הקריאה ל-רענן() , עליך להמתין לפחות 15 דקות לפני שמנסים לקרוא לשיטה הזו שוב. אחרת, יכול להיות שהקריאה הבאה לא תהיה פעולה תקינה.
ציבורי מסונכרן void registerFunctionCallMacroHandler (מחרוזת customMacroName, Container.FunctionCallMacroHandler customMacroName)
רושם את ה-handler הנתון של המאקרו הרלוונטי לטיפול במאקרו נתון להפעלת פונקציה.
פרמטרים
| customMacroName | שם רכיב המאקרו שנרשם |
| customMacroHandler | ב-handler. אם null, מבטל את הרישום של כל handler קיים עבור המאקרו הזה. |
Public מסונכרן void registerFunctionCallTagHandler (מחרוזת customTagName, Container.FunctionCallTagHandler customTagHandler)
רושם את ה-handler של התגים כך שיטפל בתג נתון של קריאה לפונקציה.
פרמטרים
| customTagName | שם התג שנרשם |
| customTagHandler | ב-handler. אם הוא null, מבטל את הרישום של כל handler קיים בתג הזה. |