Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Trang này được dịch bởi Cloud Translation API.

ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.invoker.ShardMainResultForwarder

ResultForwarder kết hợp kết quả của các lệnh gọi kiểm thử được phân đoạn. Phương thức này chỉ báo cáo việc hoàn tất lệnh gọi cho trình nghe sau khi tất cả lệnh gọi được phân đoạn hoàn tất.

Lớp này không an toàn đối với luồng. Dự kiến, ứng dụng sẽ khoá lớp này khi gửi kết quả kiểm thử để ngăn lệnh gọi lại lệnh gọi không theo thứ tự.

Tóm tắt

Hàm khởi tạo công khai
`ShardMainResultForwarder( listeners, int expectedShards)` Tạo `ShardMainResultForwarder`.

Phương thức công khai
	`getListeners()` Lấy danh sách trình nghe.
`void`	`invocationEnded(long elapsedTime)` Báo cáo rằng lệnh gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.
`void`	`invocationEnded(long elapsedTime, IInvocationContext context)` Lệnh gọi lại chi tiết hơn để phân biệt mảnh nào đã hoàn tất.
`void`	`invocationFailed(FailureDescription failure)` Báo cáo một lệnh gọi chưa hoàn chỉnh do một số điều kiện lỗi.
`void`	`invocationFailed(Throwable cause)` Báo cáo một lệnh gọi chưa hoàn chỉnh do một số điều kiện lỗi.
`void`	`invocationSkipped(SkipReason reason)` Báo cáo một lệnh gọi là đã bỏ qua
`void`	`invocationStarted(IInvocationContext context)` Báo cáo thời điểm bắt đầu lệnh gọi kiểm thử.
`void`	`logAssociation(String dataName, LogFile logFile)` Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với một trường hợp kiểm thử, nhưng không thể thực hiện việc này trên lệnh gọi lại `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` trực tiếp.
`void`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` Chỉ chuyển tiếp testLog thay vì lưu nhật ký trước.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Được gọi khi nhật ký kiểm thử được lưu.

Hàm khởi tạo công khai

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

Tạo ShardMainResultForwarder.

Tham số
`listeners`	: danh sách `ITestInvocationListener` để chuyển tiếp kết quả khi tất cả các mảnh đã hoàn tất
`expectedShards`	`int`: số lượng phân mảnh

Phương thức công khai

getListeners

public  getListeners ()

Lấy danh sách trình nghe. Chỉ dành cho các lớp con sử dụng.

Giá trị trả về
	Danh sách `ITestInvocationListener`.

invocationEnded

public void invocationEnded (long elapsedTime)

Báo cáo rằng lệnh gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
`elapsedTime`	`long`: thời gian đã trôi qua của lệnh gọi tính bằng mili giây

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Lệnh gọi lại chi tiết hơn để phân biệt mảnh nào đã hoàn tất.

Tham số
`elapsedTime`	`long`
`context`	`IInvocationContext`

invocationFailed

public void invocationFailed (FailureDescription failure)

Báo cáo một lệnh gọi chưa hoàn chỉnh do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
`failure`	`FailureDescription`: `FailureDescription` mô tả nguyên nhân gây ra lỗi

invocationFailed

public void invocationFailed (Throwable cause)

Báo cáo một lệnh gọi chưa hoàn chỉnh do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
`cause`	`Throwable`: nguyên nhân `Throwable` gây ra lỗi

invocationSkipped

public void invocationSkipped (SkipReason reason)

Báo cáo một lệnh gọi là đã bỏ qua

Tham số
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Báo cáo thời điểm bắt đầu lệnh gọi kiểm thử.

Sẽ được khung TradeFederation tự động gọi. Trình báo cáo cần ghi đè phương thức này để hỗ trợ báo cáo nhiều thiết bị.

Tham số
`context`	`IInvocationContext`: thông tin về lệnh gọi

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với một trường hợp kiểm thử, nhưng không thể thực hiện việc này trên lệnh gọi lại testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) trực tiếp. Do đó, lệnh gọi lại này cho phép cung cấp một mối liên kết mạnh mẽ một cách rõ ràng.

Tham số
`dataName`	`String`: Tên của dữ liệu
`logFile`	`LogFile`: `LogFile` đã được ghi lại trước đó và phải được liên kết với trường hợp kiểm thử.

testLogForward

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Chỉ chuyển tiếp testLog thay vì lưu nhật ký trước.

Tham số
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Được gọi khi nhật ký kiểm thử được lưu.

Nên sử dụng thay cho ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

Tham số
`dataName`	`String`: tên mô tả `String` của dữ liệu. Ví dụ: "device_logcat". Lưu ý: dataName có thể không phải là duy nhất cho mỗi lệnh gọi. Tức là trình triển khai phải có khả năng xử lý nhiều lệnh gọi có cùng dataName
`dataType`	`LogDataType`: `LogDataType` của dữ liệu
`dataStream`	`InputStreamSource`: `InputStreamSource` của dữ liệu. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream thu được khi hoàn tất.
`logFile`	`LogFile`: `LogFile` chứa siêu dữ liệu của tệp đã lưu.