Đối tượng cung cấp quyền truy cập vào các giá trị vùng chứa.
Bạn phải tạo đối tượng vùng chứa thông qua openContainer(String, Container.Callback)
hoặc ContainerOpener
.
Sau khi tạo một vùng chứa, bạn có thể truy vấn vùng chứa đó về các giá trị khoá có thể phụ thuộc vào các quy tắc đã thiết lập cho vùng chứa đó.
Một vùng chứa sẽ được tự động làm mới định kỳ (12 giờ một lần), nhưng cũng có thể được làm mới theo cách thủ công bằng refresh()
.
Tóm tắt lớp lồng ghép
giao diện | Container.Callback | Lệnh gọi lại sẽ được gọi sau khi tài nguyên đã được tải thành công. | |
giao diện | Container.FunctionCallMacroHandler | Trình xử lý được ứng dụng cung cấp để tính toán giá trị của macro tùy chỉnh. | |
giao diện | Container.FunctionCallTagHandler | Trình xử lý do ứng dụng cung cấp để thực thi thẻ tuỳ chỉnh. | |
enum | Container.RefreshFailure | Những cách có thể không làm mới được. | |
enum | Container.RefreshType | Nguồn gốc của quá trình làm mới vùng chứa. |
Tóm tắt phương thức công khai
đồng bộ hoá khoảng trống |
close()
|
boolean |
getBoolean(Chuỗi khoá)
|
Chuỗi | |
gấp đôi |
getDouble(Chuỗi khoá)
|
đồng bộ hoá Container.FunctionCallMacroHandler |
getFunctionCallMacroHandler(Chuỗi customMacroName)
|
đã đồng bộ hoá Container.FunctionCallTagHandler |
getFunctionCallTagHandler(Chuỗi customTagName)
|
long | |
long |
getLong(Khoá chuỗi)
|
Chuỗi |
getString(Chuỗi khoá)
|
boolean |
Hàm isDefault()
|
đồng bộ hoá khoảng trống |
refresh()
|
đồng bộ hoá khoảng trống |
registerFunctionCallMacroHandler(Chuỗi customMacroName, Container.FunctionCallMacroHandler customMacroHandler)
|
đồng bộ hoá khoảng trống |
registerFunctionCallTagHandler(Chuỗi customTagName, Container.FunctionCallTagHandler customTagHandler)
|
Phương thức công khai
công khai khoảng trống được đồng bộ hoá đóng ()
Đóng vùng chứa này để không làm mới vùng chứa nữa. Bạn không nên sử dụng nhãn sau khi đóng.
công khai boolean getBoolean (Chuỗi khoá)
Trả về một giá trị boolean biểu thị giá trị cấu hình của khoá đã cho. Nếu vùng chứa không có giá trị cho khoá này, hàm false sẽ được trả về.
công khai Chuỗi getContainerId ()
Trả về mã vùng chứa.
công khai gấp đôi getDouble (Chuỗi khoá)
Trả về giá trị kép biểu thị giá trị cấu hình của khoá đã cho. Nếu vùng chứa không có giá trị cho khoá này, thì hàm sẽ trả về 0.
công khai đã đồng bộ hoá Container.FunctionCallMacroHandler getFunctionCallMacroHandler (String customMacroName)
Trả về trình xử lý macro đã đăng ký cho macro lệnh gọi hàm đã cho.
công khai đã đồng bộ hoá Container.FunctionCallTagHandler getFunctionCallTagHandler (String customTagName)
Trả về trình xử lý thẻ đã đăng ký cho thẻ lệnh gọi hàm nhất định.
công khai dài getLastRefreshTime ()
Trả về thời gian gần đây nhất (tính bằng mili giây kể từ nửa đêm ngày 1 tháng 1 năm 1970 (giờ UTC)) mà vùng chứa này được làm mới từ mạng.
công khai dài getLong (Chuỗi khoá)
Trả về một giá trị long đại diện cho giá trị cấu hình của khoá đã cho. Nếu vùng chứa không có giá trị cho khoá này, thì hàm sẽ trả về 0.
công khai Chuỗi getString (String key)
Trả về một chuỗi biểu thị giá trị cấu hình cho khoá đã cho. Nếu vùng chứa không có giá trị cho khoá này, thì một chuỗi trống sẽ được trả về.
công khai boolean isDefault ()
Trả về xem đây là vùng chứa mặc định hay vùng chứa được làm mới từ máy chủ.
công khai khoảng trống được đồng bộ hoá làm mới ()
Yêu cầu làm mới vùng chứa này từ mạng. Lệnh gọi này không đồng bộ, do đó, quá trình làm mới sẽ diễn ra trên một luồng khác.
Sau khi gọi refresh(), bạn cần đợi ít nhất 15 phút để cố gắng gọi lại phương thức này. Nếu không, lệnh gọi tiếp theo có thể không hoạt động.
công khai đồng bộ hoá khoảng trống registerFunctionCallMacroHandler (Chuỗi customMacroName, Container.FunctionCallMacroHandler customMacroHandler)
Đăng ký trình xử lý macro đã cho để xử lý một macro lệnh gọi hàm nhất định.
Các tham số
customMacroName | tên của macro đang được đăng ký |
customMacroHandler | trình xử lý. Nếu giá trị rỗng, hãy huỷ đăng ký mọi trình xử lý hiện có cho macro đó. |
công khai khoảng trống được đồng bộ hoá registerFunctionCallTagHandler (Chuỗi customTagName, Container.FunctionCallTagHandler customTag)
Đăng ký trình xử lý thẻ để xử lý một thẻ gọi hàm nhất định.
Các tham số
customTagName | tên của thẻ đang được đăng ký |
customTagHandler | trình xử lý. Nếu rỗng, hãy huỷ đăng ký mọi trình xử lý hiện có cho thẻ đó. |