یک شی که دسترسی به مقادیر کانتینر را فراهم می کند. اشیاء Container باید از طریق openContainer(String, Container.Callback)
یا ContainerOpener
ایجاد شوند. هنگامی که یک کانتینر ایجاد می شود، می توان آن را برای مقادیر کلیدی که ممکن است به قوانین تعیین شده برای کانتینر بستگی داشته باشد، جستجو کرد. یک کانتینر به طور خودکار به صورت دوره ای (هر 12 ساعت) رفرش می شود، اما همچنین می تواند به صورت دستی با refresh()
رفرش شود.
خلاصه کلاس تودرتو
رابط | Container.Callback | پس از بارگیری موفقیت آمیز منبع، پاسخ به تماس فراخوانی می شود. | |
رابط | Container.FunctionCallMacroHandler | هندلری که توسط برنامه برای محاسبه مقدار یک ماکرو سفارشی ارائه شده است. | |
رابط | Container.FunctionCallTagHandler | Handler که توسط برنامه برای اجرای یک برچسب سفارشی ارائه شده است. | |
enum | Container.RefreshFailure | راه هایی که در آن یک به روز رسانی می تواند شکست بخورد. | |
enum | Container.RefreshType | منشا تازه سازی ظرف. |
خلاصه روش عمومی
خالی هماهنگ شده | بستن () |
بولی | getBoolean ( کلید رشته ) |
رشته | |
دو برابر | getDouble ( کلید رشته ) |
همزمان Container.FunctionCallMacroHandler | getFunctionCallMacroHandler ( رشته سفارشیMacroName ) |
همزمان Container.FunctionCallTagHandler | getFunctionCallTagHandler ( رشته customTagName ) |
طولانی | |
طولانی | getLong ( کلید رشته ) |
رشته | getString ( کلید رشته ) |
بولی | isDefault () |
خالی هماهنگ شده | تازه کردن () |
خالی هماهنگ شده | registerFunctionCallMacroHandler ( رشته customMacroName ، Container.FunctionCallMacroHandler customMacroHandler ) |
خالی هماهنگ شده | registerFunctionCallTagHandler ( رشته customTagName , Container.FunctionCallTagHandler customTagHandler ) |
روش های عمومی
بسته شدن خالی همگام سازی عمومی ()
این ظرف را ببندید تا دیگر تازه نشود. بعد از بسته شدن نباید از آن استفاده کرد.
بولی عمومی getBoolean ( کلید رشته )
یک بولی نشان دهنده مقدار پیکربندی برای کلید داده شده برمی گرداند. اگر ظرف مقداری برای این کلید نداشته باشد، false برگردانده می شود.
رشته عمومی getContainerId ()
شناسه کانتینر را برمیگرداند.
public double getDouble ( کلید رشته )
دو برابری را برمیگرداند که نشاندهنده مقدار پیکربندی برای کلید داده شده است. اگر ظرف هیچ مقداری برای این کلید نداشته باشد، 0 برگردانده می شود.
همگام سازی عمومی Container.FunctionCallMacroHandler getFunctionCallMacroHandler ( رشته سفارشیMacroName )
کنترل کننده ماکرو ثبت شده برای ماکرو فراخوانی تابع داده شده را برمی گرداند.
همگام سازی عمومی Container.FunctionCallTagHandler getFunctionCallTagHandler ( رشته customTagName )
کنترل کننده برچسب ثبت شده برای تگ فراخوانی تابع داده شده را برمی گرداند.
عمومی طولانی getLastRefreshTime ()
آخرین باری را برمیگرداند (در میلیثانیه از نیمهشب، ۱ ژانویه ۱۹۷۰ UTC) که این ظرف از شبکه بهروزرسانی شده است.
public long getLong ( کلید رشته )
طولی را برمی گرداند که نشان دهنده مقدار پیکربندی کلید داده شده است. اگر ظرف هیچ مقداری برای این کلید نداشته باشد، 0 برگردانده می شود.
رشته عمومی getString ( کلید رشته )
رشته ای را برمی گرداند که نشان دهنده مقدار پیکربندی کلید داده شده است. اگر ظرف هیچ مقداری برای این کلید نداشته باشد، یک رشته خالی برگردانده می شود.
بولین عمومی isDefault ()
برمیگرداند که آیا این یک ظرف پیشفرض است یا یک ظرف بازخوانی شده از سرور.
بازخوانی خالی همگام سازی عمومی ()
درخواست می کند که این ظرف از شبکه به روز شود. این تماس ناهمزمان است، بنابراین بهروزرسانی در رشته دیگری انجام میشود.
پس از فراخوانی refresh()، باید حداقل 15 دقیقه صبر کنید تا دوباره این متد را فراخوانی کنید، در غیر این صورت، تماس بعدی ممکن است بدون عملیات باشد.
همگامسازی عمومی void registerFunctionCallMacroHandler ( رشته customMacroName ، Container.FunctionCallMacroHandler customMacroHandler )
کنترل کننده ماکرو داده شده را برای مدیریت یک ماکرو فراخوانی تابع مشخص ثبت می کند.
مولفه های
customMacroName | نام ماکرو ثبت شده |
customMacroHandler | کنترل کننده اگر تهی باشد، هر کنترل کننده موجود را برای آن ماکرو لغو ثبت می کند. |
همگام سازی عمومی void registerFunctionCallTagHandler ( رشته customTagName ، Container.FunctionCallTagHandler customTagHandler )
کنترل کننده برچسب را برای رسیدگی به تگ فراخوانی تابع مشخص ثبت می کند.
مولفه های
customTagName | نام برچسبی که در حال ثبت است |
customTagHandler | کنترل کننده در صورت تهی بودن، هر کنترل کننده موجود را برای آن تگ لغو ثبت می کند. |