الحاوية

حاوية للفئة العامة

يشير ذلك المصطلح إلى كائن يوفّر الوصول إلى قيم الحاويات. يجب إنشاء كائنات الحاوية من خلال openContainer(String, Container.Callback) أو ContainerOpener. بعد إنشاء الحاوية، يمكن البحث عنها لمعرفة القيم الأساسية التي قد تعتمد على القواعد التي تمّ إنشاؤها للحاوية. تتم إعادة تحميل الحاوية تلقائيًا بشكل دوري (كل 12 ساعة)، ولكن يمكن أيضًا إعادة تحميلها يدويًا باستخدام السمة refresh().

ملخص الفئة المدمَجة

واحدة Container.Callback سيتم استدعاء معاودة الاتصال بعد تحميل المورد بنجاح. 
واحدة Container.FunctionCallMacroHandler المعالج الذي يوفره التطبيق لحساب قيمة وحدة ماكرو مخصصة. 
واحدة Container.FunctionCallTagHandler المعالج الذي يوفره التطبيق لتنفيذ علامة مخصصة. 
تعداد Container.RefreshFailure الطرق التي قد تفشل بها عملية إعادة التحميل
تعداد Container.RefreshType مصدر إعادة تحميل الحاوية

ملخّص الطريقة العلنية

متزامن فارغ
Close()
boolean
getBoolean(مفتاح سلسلة)
سلسلة
getContainerId()
مزدوج
getDouble(مفتاح سلسلة)
متزامنة Container.FunctionCallMacroHandler
getFunctionCallMacroHandler(سلسلة customMacroName)
متزامنة Container.FunctionCallTagHandler
getFunctionCallTagHandler(سلسلة customTagName)
شعر طويل
getLastRefreshTime()
شعر طويل
getLong(مفتاح السلسلة)
سلسلة
getString(سلسلة مفتاح)
boolean
isDefault()
متزامن فارغ
refresh()
متزامن فارغ
registerFunctionCallMacroHandler(سلسلة customMacroName وContainer.FunctionCallMacroHandler customMacroName)
متزامن فارغ
registerFunctionCallTagHandler(سلسلة customTagName وContainer.FunctionCallTagHandler customTagHandler)

الطرق العامة

عام فراغ متزامن إغلاق ()

وأغلق هذه الحاوية بحيث لا يتم تحديثها بعد الآن. وبعد إغلاقه، يجب عدم استخدامه.

public منطقي getBoolean (مفتاح سلسلة)

تعرض قيمة منطقية تمثّل قيمة الإعدادات للمفتاح المحدّد. وإذا لم تكن الحاوية تحتوي على قيمة لهذا المفتاح، سيتم عرض القيمة false.

public سلسلة getContainerId ()

تعرِض معرّف الحاوية.

عامة مزدوج getDouble (مفتاح سلسلة)

لعرض مزدوج تمثل قيمة الإعدادات للمفتاح المحدد. إذا لم تكن الحاوية تحتوي على قيمة لهذا المفتاح، سيتم عرض 0.

عامة تمت المزامنة Container.FunctionCallMacroHandler getFunctionCallMacroHandler (السلسلة customMacroName)

تعرض معالج الماكرو المسجّل لوحدة ماكرو استدعاء الدالة المحدّدة.

عامة تمت المزامنة Container.FunctionCallTagHandler getFunctionCallTagHandler (السلسلة customTagName)

تعرض معالِج العلامة المسجَّل لعلامة استدعاء الدالة المحدّدة.

عامة طويلة getLastRefreshTime ()

تعرض آخر مرة (بالملي ثانية منذ منتصف الليل، 1 كانون الثاني (يناير) 1970 بالتوقيت العالمي المنسَّق) التي تمت فيها إعادة تحميل هذه الحاوية من الشبكة.

public طويل getLong (مفتاح سلسلة)

لعرض قيمة طويلة تمثل قيمة الإعدادات للمفتاح المحدّد. إذا لم تكن الحاوية تحتوي على قيمة لهذا المفتاح، سيتم عرض 0.

public سلسلة getString (مفتاح سلسلة)

تعرض سلسلة تمثل قيمة الإعدادات للمفتاح المحدد. إذا لم تتضمّن الحاوية أي قيمة لهذا المفتاح، سيتم عرض سلسلة فارغة.

public منطقي isDefault ()

يعرض ما إذا كانت هذه حاوية تلقائية، أو حاوية تم تحديثها من الخادم.

عام فراغ متزامن إعادة تحميل ()

تطلب إعادة تحميل هذه الحاوية من الشبكة. هذه المكالمة غير متزامنة، لذا ستتم عملية التحديث في سلسلة محادثات أخرى.

بعد طلب إعادة التحميل() ، عليك الانتظار لمدة 15 دقيقة على الأقل لمحاولة طلب هذه الطريقة مرة أخرى، وإلا قد تكون الاستدعاءات اللاحقة "لا".

عامة قيمة غير متزامنة registerFunctionCallMacroHandler (سلسلة customMacroName, Container.FunctionCallMacroHandler customMacroName)

تسجل معالج الماكرو المحدد للتعامل مع ماكرو استدعاء دالة معين.

المَعلمات
customMacroName اسم وحدة الماكرو التي يتم تسجيلها
customMacroHandler المعالج. في حال ترك القيمة فارغة، يتم إلغاء تسجيل أي معالج حالي لهذه وحدة الماكرو.

عامة إلغاء متزامن registerFunctionCallTagHandler (سلسلة customTagName, Container.FunctionCallTagHandler customTagName)

تسجِّل معالج العلامات للتعامل مع علامة استدعاء دالة معيّنة.

المَعلمات
customTagName اسم العلامة التي يتم تسجيلها
customTagHandler المعالج. إذا كانت القيمة فارغة، يتم إلغاء تسجيل أي معالج حالي لتلك العلامة.