Lựa chọn
public
abstract
@interface
Option
implements
Annotation
| com.android.tradefed.config.Option |
Chú thích một trường đại diện cho một tuỳ chọn IConfiguration.
Tóm tắt
Các hằng số | |
|---|---|
char |
NO_SHORT_NAME
|
Phương thức công khai | |
|---|---|
String
|
description()
Nội dung mô tả dễ hiểu về tuỳ chọn. |
Option.Importance
|
importance()
Tầm quan trọng của tuỳ chọn. |
boolean
|
isTimeVal()
Liệu tuỳ chọn có đại diện cho một giá trị thời gian hay không. |
boolean
|
mandatory()
Lựa chọn này là bắt buộc hay không bắt buộc. |
String
|
name()
Tên duy nhất bắt buộc cho tuỳ chọn này. |
boolean
|
requiredForRerun()
Lựa chọn này có cần thiết để biên dịch hướng dẫn chạy lại kiểm thử hay không. |
char
|
shortName()
Tên viết tắt không bắt buộc cho tuỳ chọn. |
OptionUpdateRule
|
updateRule()
Kiểm soát hành vi khi một tuỳ chọn được chỉ định nhiều lần. |
Hằng số
KHÔNG_SHORT_NAME
public static final char NO_SHORT_NAME
Giá trị không đổi: 48 (0x00000030)
Phương thức công khai
mô tả
public String description ()
Nội dung mô tả dễ hiểu về tuỳ chọn.
| Giá trị trả về | |
|---|---|
String |
|
tầm quan trọng
public Option.Importance importance ()
Tầm quan trọng của lựa chọn.
Một tuỳ chọn được coi là "quan trọng" sẽ xuất hiện trong kết quả trợ giúp rút gọn. Trợ giúp cho một lựa chọn không quan trọng sẽ chỉ xuất hiện trong văn bản trợ giúp đầy đủ.
| Giá trị trả về | |
|---|---|
Option.Importance |
|
isTimeVal
public boolean isTimeVal ()
Liệu tuỳ chọn có đại diện cho một giá trị thời gian hay không.
Nếu đây là giá trị thời gian, thì hậu tố theo thời gian sẽ được phân tích cú pháp. Trường long hoặc Long để cờ này hợp lệ. Nếu không, ConfigurationException sẽ được gửi.
Đơn vị mặc định là mili giây. Khung cấu hình sẽ chấp nhận s trong giây (1000 mili giây), m trong phút (60 giây), h trong giờ (60 phút) hoặc d trong ngày (24 giờ).
Bạn có thể kết hợp và so khớp các đơn vị, miễn là mỗi đơn vị xuất hiện tối đa một lần và miễn là tất cả các đơn vị xuất hiện đều được liệt kê theo thứ tự giảm dần về quy mô. Ví dụ: h chỉ có thể xuất hiện trước m và chỉ có thể xuất hiện sau d. Ví dụ cụ thể: "1d2h3m4s5ms" sẽ là một giá trị thời gian hợp lệ, cũng như "4" hoặc "4ms". Tất cả khoảng trắng được nhúng sẽ bị loại bỏ.
| Giá trị trả về | |
|---|---|
boolean |
|
bắt buộc
public boolean mandatory ()
Lựa chọn này là bắt buộc hay không bắt buộc.
Khung cấu hình sẽ gửi một ConfigurationException nếu một trong hai trường hợp sau đây là đúng với một trường bắt buộc sau khi các tuỳ chọn đã được phân tích cú pháp từ tất cả các nguồn:
- Trường này là
null. - Trường này là một
ERROR(/Collection)trống.
| Giá trị trả về | |
|---|---|
boolean |
|
tên
public String name ()
Tên duy nhất bắt buộc cho tuỳ chọn này.
Thao tác này sẽ liên kết đến một đối số dòng lệnh có tiền tố là hai ký tự "-".
Ví dụ: Option có tên "help" sẽ được chỉ định bằng "--help" trên dòng lệnh.
Tên không được chứa dấu hai chấm, ví dụ: ":".
| Giá trị trả về | |
|---|---|
String |
|
requiredForRerun
public boolean requiredForRerun ()
Lựa chọn này có cần thiết để biên dịch hướng dẫn chạy lại kiểm thử hay không.
Trình báo cáo kết quả có thể cố gắng biên dịch hướng dẫn về cách chạy lại một chương trình kiểm thử và đưa thông báo vào kết quả. Hướng dẫn này phải bao gồm tất cả các tuỳ chọn áp dụng cho một lần chạy lại kiểm thử. Thuộc tính này được dùng để cho biết liệu tuỳ chọn có được đưa vào hướng dẫn đó hay không.
| Giá trị trả về | |
|---|---|
boolean |
|
shortName
public char shortName ()
Tên viết tắt không bắt buộc cho tuỳ chọn. Thao tác này sẽ liên kết đến một đối số dòng lệnh có tiền tố là một dấu "-". Ví dụ: "-h", trong đó h = shortName. "0" được dành riêng để có nghĩa là lựa chọn không có shortName.
| Giá trị trả về | |
|---|---|
char |
|
Quy tắc cập nhật
public OptionUpdateRule updateRule ()
Kiểm soát hành vi khi một tuỳ chọn được chỉ định nhiều lần. Xin lưu ý rằng quy tắc này sẽ hoàn toàn bị bỏ qua đối với các tuỳ chọn là ERROR(/Collection) hoặc ERROR(/Map).
| Giá trị trả về | |
|---|---|
OptionUpdateRule |
|