HostTest
public
class
HostTest
extends Object
implements
IAbiReceiver,
IBuildReceiver,
IConfigurationReceiver,
IDeviceTest,
IDiscoverTestClasses,
IRemoteTest,
IRuntimeHintProvider,
IShardableTest,
ITestAnnotationFilterReceiver,
ITestCollector,
ITestFilterReceiver
| java.lang.Object | |
| ↳ | com.android.tradefed.testtype.HostTest |
Một trình chạy kiểm thử cho các kiểm thử dựa trên máy chủ lưu trữ JUnit. Nếu kiểm thử cần chạy triển khai IDeviceTest, trình chạy này sẽ truyền một thông tin tham chiếu đến thiết bị.
Tóm tắt
Hằng số | |
|---|---|
String |
SET_OPTION_DESC
|
String |
SET_OPTION_NAME
|
Hàm khởi tạo công khai | |
|---|---|
HostTest()
|
|
Phương thức công khai | |
|---|---|
void
|
addAllExcludeAnnotation(Set<String> notAnnotations)
Thêm một |
void
|
addAllExcludeFilters(Set<String> filters)
Thêm |
void
|
addAllIncludeAnnotation(Set<String> annotations)
Thêm |
void
|
addAllIncludeFilters(Set<String> filters)
Thêm |
void
|
addExcludeAnnotation(String notAnnotation)
Thêm chú giải để loại trừ nếu một kiểm thử được đánh dấu bằng chú giải đó. |
void
|
addExcludeFilter(String filter)
Thêm bộ lọc để loại trừ các kiểm thử. |
void
|
addIncludeAnnotation(String annotation)
Thêm chú thích để đưa vào nếu một kiểm thử được đánh dấu bằng chú thích đó. |
void
|
addIncludeFilter(String filter)
Thêm bộ lọc để chọn những kiểm thử cần đưa vào. |
void
|
clearExcludeAnnotations()
Xoá tất cả chú thích loại trừ hiện đang được theo dõi. |
void
|
clearExcludeFilters()
Xoá tất cả các bộ lọc loại trừ hiện đang được theo dõi. |
void
|
clearIncludeAnnotations()
Xoá tất cả chú thích bao gồm hiện đang được theo dõi. |
void
|
clearIncludeFilters()
Xoá tất cả các bộ lọc bao gồm hiện đang được theo dõi. |
int
|
countTestCases()
Trả về số lượng trường hợp kiểm thử trên tất cả các lớp thuộc các kiểm thử |
IAbi
|
getAbi()
|
Set<String>
|
getClassNames()
|
ITestDevice
|
getDevice()
Lấy thiết bị đang được kiểm thử. |
Set<String>
|
getExcludeAnnotations()
Trả về |
Set<String>
|
getExcludeFilters()
Trả về |
Set<String>
|
getIncludeAnnotations()
Trả về |
Set<String>
|
getIncludeFilters()
Trả về |
long
|
getRuntimeHint()
Trả về thời gian chạy dự kiến của kiểm thử tính bằng mili giây. |
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
Chạy các kiểm thử và báo cáo kết quả cho trình nghe. |
void
|
setAbi(IAbi abi)
|
void
|
setBuild(IBuildInfo buildInfo)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
Bật hoặc tắt chế độ thu thập dữ liệu thử nghiệm |
void
|
setConfiguration(IConfiguration configuration)
Chèn |
void
|
setDevice(ITestDevice device)
Chèn thiết bị đang kiểm thử. |
static
void
|
setOptionToLoadedObject(Object testObj, List<String> keyValueOptions)
Trợ giúp cho Device Runner sử dụng để đặt các lựa chọn theo cách tương tự như HostTest, từ set-option. |
void
|
setTestInformation(TestInformation testInfo)
|
Collection<IRemoteTest>
|
split(Integer shardCount, TestInformation testInfo)
Chúng tôi chia theo từng cá nhân theo lớp hoặc phương thức kiểm thử. |
Phương thức được bảo vệ | |
|---|---|
HostTest
|
createHostTest(Class<?> classObj)
Trợ giúp tạo một thực thể HostTest khi phân đoạn. |
IBuildInfo
|
getBuild()
Lấy thông tin bản dựng mà HostTest nhận được. |
ClassLoader
|
getClassLoader()
Trả về trình tải lớp mặc định. |
final
List<Class<?>>
|
getClasses()
|
File
|
getJarFile(String jarName, TestInformation testInfo)
Kiểm tra một số vị trí thường có các cấu phần phần mềm cho nhiều trường hợp sử dụng để tìm jar của chúng tôi. |
boolean
|
hasJUnit4Annotation(Class<?> classObj)
Trợ giúp xác định xem chúng ta có đang xử lý lớp Kiểm thử bằng chú thích Junit4 hay không. |
Object
|
loadObject(Class<?> classObj)
tải đối tượng lớp và đặt thông tin kiểm thử (thiết bị, bản dựng). |
void
|
setClassName(String className)
Xoá rồi đặt tên lớp sẽ chạy. |
void
|
setMethodName(String methodName)
Đặt tên phương thức sẽ chạy. |
boolean
|
shouldTestRun(AnnotatedElement annotatedElement)
Kiểm tra xem một phần tử có chú thích có vượt qua bộ lọc hay không. |
Hằng số
SET_OPTION_DESC
public static final String SET_OPTION_DESC
Giá trị không đổi:
"Các lựa chọn sẽ được truyền xuống lớp đang kiểm thử, khoá và giá trị phải được phân tách bằng dấu hai chấm ":"; ví dụ: nếu lớp đang kiểm thử hỗ trợ "--iteration 1" từ dòng lệnh, thì lớp đó phải được truyền vào dưới dạng "--set-option iteration:1" hoặc "--set-option iteration:key=value" để truyền các lựa chọn vào bản đồ. Bạn có thể thoát các giá trị chứa ":" hoặc "=" bằng dấu gạch chéo ngược. Bạn có thể nhắm đến một lớp cụ thể bằng cách chỉ định lớp đó. " --set-option
SET_OPTION_NAME
public static final String SET_OPTION_NAME
Giá trị không đổi: "set-option"
Hàm khởi tạo công khai
HostTest
public HostTest ()
Phương thức công khai
addAllExcludeAnnotation
public void addAllExcludeAnnotation (Set<String> notAnnotations)
Thêm một Set chú thích để loại trừ nếu một kiểm thử được đánh dấu bằng chú thích đó.
| Tham số | |
|---|---|
notAnnotations |
Set |
addAllExcludeFilters
public void addAllExcludeFilters (Set<String> filters)
Thêm Set bộ lọc mà bạn muốn loại trừ khỏi các kiểm thử.
| Tham số | |
|---|---|
filters |
Set |
addAllIncludeAnnotation
public void addAllIncludeAnnotation (Set<String> annotations)
Thêm Set chú thích để đưa vào nếu một kiểm thử được đánh dấu bằng chú thích đó.
| Tham số | |
|---|---|
annotations |
Set |
addAllIncludeFilters
public void addAllIncludeFilters (Set<String> filters)
Thêm Set bộ lọc để đưa các kiểm thử vào.
| Tham số | |
|---|---|
filters |
Set |
addExcludeAnnotation
public void addExcludeAnnotation (String notAnnotation)
Thêm chú giải để loại trừ nếu một kiểm thử được đánh dấu bằng chú giải đó.
| Tham số | |
|---|---|
notAnnotation |
String |
addExcludeFilter
public void addExcludeFilter (String filter)
Thêm bộ lọc để loại trừ các kiểm thử.
| Tham số | |
|---|---|
filter |
String |
addIncludeAnnotation
public void addIncludeAnnotation (String annotation)
Thêm chú thích để đưa vào nếu một kiểm thử được đánh dấu bằng chú thích đó.
| Tham số | |
|---|---|
annotation |
String |
addIncludeFilter
public void addIncludeFilter (String filter)
Thêm bộ lọc để chọn những kiểm thử cần đưa vào.
| Tham số | |
|---|---|
filter |
String |
clearExcludeAnnotations
public void clearExcludeAnnotations ()
Xoá tất cả chú thích loại trừ hiện đang được theo dõi.
clearExcludeFilters
public void clearExcludeFilters ()
Xoá tất cả các bộ lọc loại trừ hiện đang được theo dõi.
clearIncludeAnnotations
public void clearIncludeAnnotations ()
Xoá tất cả chú thích bao gồm hiện đang được theo dõi.
clearIncludeFilters
public void clearIncludeFilters ()
Xoá tất cả các bộ lọc bao gồm hiện đang được theo dõi.
countTestCases
public int countTestCases ()
Trả về số lượng trường hợp kiểm thử trên tất cả các lớp thuộc các kiểm thử
| Giá trị trả về | |
|---|---|
int |
|
getClassNames
public Set<String> getClassNames ()
| Giá trị trả về | |
|---|---|
Set<String> |
|
getDevice
public ITestDevice getDevice ()
Lấy thiết bị đang được kiểm thử.
| Giá trị trả về | |
|---|---|
ITestDevice |
ITestDevice |
getExcludeAnnotations
public Set<String> getExcludeAnnotations ()
Trả về Set hiện tại của các chú thích cần loại trừ.
| Giá trị trả về | |
|---|---|
Set<String> |
|
getExcludeFilters
public Set<String> getExcludeFilters ()
Trả về Set hiện tại của các bộ lọc loại trừ.
| Giá trị trả về | |
|---|---|
Set<String> |
|
getIncludeAnnotations
public Set<String> getIncludeAnnotations ()
Trả về Set hiện tại của các chú thích cần đưa vào.
| Giá trị trả về | |
|---|---|
Set<String> |
|
getIncludeFilters
public Set<String> getIncludeFilters ()
Trả về Set hiện tại của các bộ lọc bao gồm.
| Giá trị trả về | |
|---|---|
Set<String> |
|
getRuntimeHint
public long getRuntimeHint ()
Trả về thời gian chạy dự kiến của kiểm thử tính bằng mili giây. Thời gian này được dùng để cân bằng tải việc thực thi phân mảnh
| Giá trị trả về | |
|---|---|
long |
|
chạy
public void run (TestInformation testInfo, ITestInvocationListener listener)
Chạy các kiểm thử và báo cáo kết quả cho trình nghe.
| Tham số | |
|---|---|
testInfo |
TestInformation: Đối tượng TestInformation chứa thông tin hữu ích để chạy các kiểm thử. |
listener |
ITestInvocationListener: ITestInvocationListener kết quả kiểm thử |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Bật hoặc tắt chế độ thu thập dữ liệu thử nghiệm
setConfiguration
public void setConfiguration (IConfiguration configuration)
Chèn IConfiguration đang dùng.
| Tham số | |
|---|---|
configuration |
IConfiguration |
setDevice
public void setDevice (ITestDevice device)
Chèn thiết bị đang kiểm thử.
| Tham số | |
|---|---|
device |
ITestDevice: ITestDevice cần sử dụng |
setOptionToLoadedObject
public static void setOptionToLoadedObject (Object testObj,
List<String> keyValueOptions)Trợ giúp cho Device Runner sử dụng để đặt các lựa chọn theo cách tương tự như HostTest, từ set-option.
| Tham số | |
|---|---|
testObj |
Object: đối tượng sẽ nhận các lựa chọn. |
keyValueOptions |
List: danh sách các lựa chọn được định dạng theo yêu cầu của HostTest set-option. |
setTestInformation
public void setTestInformation (TestInformation testInfo)
| Tham số | |
|---|---|
testInfo |
TestInformation |
chia hoá đơn
public Collection<IRemoteTest> split (Integer shardCount, TestInformation testInfo)
Chúng tôi chia theo từng cá nhân theo lớp hoặc phương thức kiểm thử.
| Tham số | |
|---|---|
shardCount |
Integer: số lượng phân đoạn đã thử. |
testInfo |
TestInformation: TestInformation chính |
| Giá trị trả về | |
|---|---|
Collection<IRemoteTest> |
một tập hợp các kiểm thử phụ sẽ được thực thi riêng biệt hoặc null nếu kiểm thử hiện không phân đoạn được |
Phương thức được bảo vệ
createHostTest
protected HostTest createHostTest (Class<?> classObj)
Trợ giúp tạo một thực thể HostTest khi phân đoạn. Ghi đè để trả về mọi thành phần con từ HostTest.
| Tham số | |
|---|---|
classObj |
Class |
| Giá trị trả về | |
|---|---|
HostTest |
|
getBuild
protected IBuildInfo getBuild ()
Lấy thông tin bản dựng mà HostTest nhận được.
| Giá trị trả về | |
|---|---|
IBuildInfo |
IBuildInfo |
getClassLoader
protected ClassLoader getClassLoader ()
Trả về trình tải lớp mặc định.
| Giá trị trả về | |
|---|---|
ClassLoader |
|
getClasses
protected final List<Class<?>> getClasses ()
| Giá trị trả về | |
|---|---|
List<Class<?>> |
|
| Gửi | |
|---|---|
IllegalArgumentException |
|
getJarFile
protected File getJarFile (String jarName,
TestInformation testInfo)Kiểm tra một số vị trí thường có các cấu phần phần mềm cho nhiều trường hợp sử dụng để tìm jar của chúng tôi.
| Tham số | |
|---|---|
jarName |
String |
testInfo |
TestInformation |
| Giá trị trả về | |
|---|---|
File |
|
| Gửi | |
|---|---|
FileNotFoundException |
|
hasJUnit4Annotation
protected boolean hasJUnit4Annotation (Class<?> classObj)
Trợ giúp xác định xem chúng ta có đang xử lý lớp Kiểm thử bằng chú thích Junit4 hay không.
| Tham số | |
|---|---|
classObj |
Class |
| Giá trị trả về | |
|---|---|
boolean |
|
loadObject
protected Object loadObject (Class<?> classObj)
tải đối tượng lớp và đặt thông tin kiểm thử (thiết bị, bản dựng).
| Tham số | |
|---|---|
classObj |
Class |
| Giá trị trả về | |
|---|---|
Object |
|
setClassName
protected void setClassName (String className)
Xoá rồi đặt tên lớp sẽ chạy.
| Tham số | |
|---|---|
className |
String |
setMethodName
protected void setMethodName (String methodName)
Đặt tên phương thức sẽ chạy.
Thao tác này dùng để chạy một phương thức kiểm thử cụ thể từ một lớp kiểm thử.
| Tham số | |
|---|---|
methodName |
String |
shouldTestRun
protected boolean shouldTestRun (AnnotatedElement annotatedElement)
Kiểm tra xem một phần tử có chú thích có vượt qua bộ lọc hay không. Được hiển thị để kiểm thử đơn vị.
| Giá trị trả về | |
|---|---|
boolean |
false nếu không nên chạy kiểm thử. |