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ố

NO_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 tuỳ 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. Thông tin trợ giúp cho một tuỳ 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 này PHẢI là 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 cho giây (1000 mili giây), m cho phút (60 giây), h cho giờ (60 phút) hoặc d cho 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 các điều kiện sau đây đúng với 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:

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 đặt trước để chỉ tuỳ chọn không có shortName.

Giá trị trả về
char

updateRule

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