Lựa chọn

public abstract @interface Option
implements Annotation

com.android.tradefed.config.Option


Chú thích một trường là đại diện cho lựa 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ả thân thiện với người dùng về lựa chọn này.

Option.Importance importance()

Tầm quan trọng của lựa chọn.

boolean isTimeVal()

Liệu lựa chọn có biểu thị 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 riêng bắt buộc cho lựa chọn này.

boolean requiredForRerun()

Liệu có cần lựa chọn này để biên dịch chỉ dẫn chạy lại một bài kiểm thử hay không.

char shortName()

Tên viết tắt không bắt buộc cho lựa chọn.

OptionUpdateRule updateRule()

Kiểm soát hành vi khi một lựa chọn được chỉ định nhiều lần.

Hằng số

NO_SHORT_NAME

public static final char NO_SHORT_NAME

Giá trị hằng số: 48 (0x00000030)

Phương thức công khai

mô tả

public String description ()

Nội dung mô tả thân thiện với người dùng về lựa chọn này.

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 lựa chọn được coi là "quan trọng" sẽ xuất hiện trong đầu ra 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 lựa chọn có biểu thị một giá trị thời gian hay không.

Nếu đây là giá trị thời gian, thì các hậu tố dành riêng cho thời gian sẽ được phân tích cú pháp. Trường này PHẢIlong hoặc Long thì cờ này mới hợp lệ. Nếu không, hệ thống sẽ gửi một ConfigurationException.

Đơ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 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 đượ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 đều 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 những điều kiện sau đây là đúng đối với một trường bắt buộc sau khi các lựa 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 Collection trống.

Giá trị trả về
boolean

tên

public String name ()

Tên riêng bắt buộc cho lựa chọn này.

Thao tác này sẽ ánh xạ đến một đối số dòng lệnh có tiền tố là 2 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 ()

Liệu có cần lựa chọn này để biên dịch chỉ dẫn chạy lại một bà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 bài kiểm thử và đưa thông báo vào kết quả. Hướng dẫn phải bao gồm tất cả các lựa 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 lựa 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 lựa chọn. Thao tác này sẽ ánh xạ đế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 để biểu thị rằng lựa 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 lựa chọn được chỉ định nhiều lần. Xin lưu ý rằng quy tắc này hoàn toàn bị bỏ qua đối với các lựa chọn là Collection hoặc Map.

Giá trị trả về
OptionUpdateRule