Trình chuyển tiếp ShardMainResult

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

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

ResultForwarder kết hợp kết quả của một lệnh gọi kiểm thử được phân đoạn. 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 phân đoạn hoàn tất.

Lớp này không an toàn cho 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 bị gọi sai 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, dù thành công hay do một số lỗi .

void invocationEnded(long elapsedTime, IInvocationContext context)

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

void invocationFailed(FailureDescription failure)

Báo cáo 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 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 lệnh 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 một trường hợp kiểm thử, nhưng phải có cơ hội thực hiện cứ vậy, trên testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) trực tiếp không thể gọi lại.

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

Trình chuyển tiếp ShardMainResult

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

Tạo ShardMainResultForwarder.

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

Phương thức công khai

getListener

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 các ITestInvocationListener.

gọi đã kết thúc

public void invocationEnded (long elapsedTime)

Báo cáo rằng lệnh gọi đã kết thúc, dù thành công hay do một số 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

gọi đã kết thúc

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

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

Tham số
elapsedTime long

context IInvocationContext

kích hoạt không thành công

public void invocationFailed (FailureDescription failure)

Báo cáo 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 lỗi

kích hoạt không thành công

public void invocationFailed (Throwable cause)

Báo cáo 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: Throwable nguyên nhân gây ra lỗi

Đã bỏ qua lệnh gọi

public void invocationSkipped (SkipReason reason)

Báo cáo lệnh gọi là bị bỏ qua

Tham số
reason SkipReason

đã gọi

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. Người báo cáo cần ghi đè phương pháp 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 phải có cơ hội thực hiện cứ vậy, trên testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) trực tiếp không thể gọi lại. 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 lại trước đó và nên đượ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

testLog đã lưu

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 được 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". Ghi chú dataName không được là duy nhất cho mỗi lệnh gọi. tức là người 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. Trình triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng kết quả InputStream khi hoàn tất.
logFile LogFile: LogFile chứa siêu dữ liệu của tệp đã lưu.