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 mảnh. Lớp 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ả các lệnh gọi được phân mảnh hoàn tất.

Lớp này không an toàn cho luồng. Khách hàng dự kiến sẽ khoá lớp này khi gửi kết quả kiểm thử để ngăn các lệnh gọi lại lệnh gọi được gọi không theo thứ tự.

Tóm tắt

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

ShardMainResultForwarder(List<ITestInvocationListener> listeners, int expectedShards)

Tạo ShardMainResultForwarder.

Phương thức công khai

List<ITestInvocationListener> getListeners()

Xem danh sách trình nghe.

void invocationEnded(long elapsedTime)

Báo cáo rằng lời gọi đã chấm dứt, 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 không hoàn tất do một số điều kiện lỗi.

void invocationFailed(Throwable cause)

Báo cáo một lệnh gọi không hoàn tất do một số điều kiện lỗi.

void invocationSkipped(SkipReason reason)

Báo cáo một lời gọi là bị 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 các 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 trực tiếp.testLogSaved(String,LogDataType,InputStreamSource,LogFile)

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 (List<ITestInvocationListener> listeners, 
                int expectedShards)

Tạo ShardMainResultForwarder.

Tham số
listeners List: danh sách ITestInvocationListener để chuyển tiếp kết quả đến khi tất cả các mảnh hoàn tất
expectedShards int: số mảnh

Phương thức công khai

getListeners

public List<ITestInvocationListener> getListeners ()

Xem danh sách trình nghe.

Giá trị trả về
List<ITestInvocationListener> Danh sách ITestInvocationListener.

invocationEnded

public void invocationEnded (long elapsedTime)

Báo cáo rằng lời gọi đã chấm dứt, 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 không hoàn tất 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 không hoàn tất 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ời gọi là bị 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 các 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 trực tiếp.testLogSaved(String,LogDataType,InputStreamSource,LogFile) Do đó, lệnh gọi lại này cho phép cung cấp mối liên kết chặt chẽ một cách rõ ràng.

Tham số
dataName String: Tên của dữ liệu
logFile LogFile: LogFile đã được ghi nhật ký 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 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à người triển khai phải có thể 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 kết quả khi hoàn tất.
logFile LogFile: LogFile chứa dữ liệu meta của tệp đã lưu.