ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳ com.android.tradefed.result.CollectingTestListener
↳ com.android.tradefed.invoker.ShardListener

ITestInvocationListener thu thập kết quả từ phân đoạn lệnh gọi (còn gọi là phân tách lệnh gọi để chạy song song trên nhiều tài nguyên) và chuyển tiếp chúng đến một trình nghe khác.

Bản tóm tắt

Nhà thầu xây dựng công cộng

ShardListener ( ITestInvocationListener main)

Tạo ShardListener .

Phương pháp công khai

getUnderlyingResultReporter ()
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ố điều kiện lỗi.

void invocationFailed ( FailureDescription failure)

Báo cáo lệnh gọi không đầy đủ do một số tình trạng lỗi.

void invocationFailed (Throwable cause)

Báo cáo lệnh gọi không đầy đủ do một số tình trạng lỗi.

void invocationSkipped ( SkipReason reason)

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

void invocationStarted ( IInvocationContext context)

Báo cáo sự bắt đầu của lệnh gọi thử nghiệm.

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 thử nghiệm, nhưng cơ hội thực hiện điều đó trên testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Không thể gọi lại testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) .

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

Trả về Đúng nếu trình báo cáo hỗ trợ kết quả chi tiết, nếu không thì trả về sai.

void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

Cung cấp nhật ký liên quan hoặc dữ liệu gỡ lỗi từ lệnh gọi thử nghiệm.

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

void testModuleEnded ()

Báo cáo kết thúc chạy mô-đun.

void testModuleStarted ( IInvocationContext moduleContext)

Báo cáo sự bắt đầu của một mô-đun đang chạy.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Báo cáo kết thúc quá trình chạy thử.

void testRunFailed ( FailureDescription failure)

Báo cáo chạy thử không hoàn thành do lỗi được mô tả bởi FailureDescription .

void testRunFailed (String failureMessage)

Báo cáo không hoàn tất quá trình chạy thử do có lỗi nghiêm trọng.

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

Báo cáo việc bắt đầu chạy thử.

Nhà thầu xây dựng công cộng

ShardListener

public ShardListener (ITestInvocationListener main)

Tạo ShardListener .

Thông số
main ITestInvocationListener : ITestInvocationListener kết quả sẽ được chuyển tiếp. Để tránh xung đột với các ShardListener khác, đối tượng này sẽ đồng bộ hóa trên main khi chuyển tiếp kết quả. Và kết quả sẽ chỉ được gửi sau khi phân đoạn lệnh gọi hoàn tất.

Phương pháp công khai

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Trả lại

lời mờ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ố điều kiện lỗi.

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

Thông số
elapsedTime long : thời gian trôi qua của lệnh gọi tính bằng ms

lời gọi không thành công

public void invocationFailed (FailureDescription failure)

Báo cáo lệnh gọi không đầy đủ do một số tình trạng lỗi.

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

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

lời gọi không thành công

public void invocationFailed (Throwable cause)

Báo cáo lệnh gọi không đầy đủ do một số tình trạng lỗi.

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

Thông số
cause Throwable : nguyên nhân Throwable của sự cố

lời mờiBỏ qua

public void invocationSkipped (SkipReason reason)

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

Thông số
reason SkipReason

lời gọiBắt đầu

public void invocationStarted (IInvocationContext context)

Báo cáo sự bắt đầu của lệnh gọi thử nghiệm.

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

Thông số
context IInvocationContext : thông tin về lời gọi

logHiệp hội

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 thử nghiệm, nhưng cơ hội thực hiện điều đó trên testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Không thể gọi lại testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) . Do đó, lệnh gọi lại này cho phép cung cấp một liên kết mạnh mẽ một cách rõ ràng.

Thông số
dataName String : Tên 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 thử nghiệm.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Thông số
enableGranularResults boolean

hỗ trợGranularKết quả

public boolean supportGranularResults ()

Trả về Đúng nếu trình báo cáo hỗ trợ kết quả chi tiết, nếu không thì trả về sai.

Trả lại
boolean

nhật ký kiểm tra

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

Cung cấp nhật ký liên quan hoặc dữ liệu gỡ lỗi từ lệnh gọi thử nghiệm.

Phải được gọi trước ERROR(/ITestInvocationListener#invocationFailed(Throwable)) hoặc ERROR(/ITestInvocationListener#invocationEnded(long))

Khung TradeFederation sẽ tự động gọi phương thức này, cung cấp nhật ký máy chủ và logcat thiết bị, nếu có.

Thông 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ó khả năng xử lý nhiều cuộc gọi với cùng một tên dữ liệu

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. Người gọi phải đảm bảo nguồn dữ liệu vẫn hiện diện và có thể truy cập được cho đến khi phương thức testLog hoàn tất.

testLogĐã lưu

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

Thông số
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleĐã kết thúc

public void testModuleEnded ()

Báo cáo kết thúc chạy mô-đun.

testModuleBắt đầu

public void testModuleStarted (IInvocationContext moduleContext)

Báo cáo sự bắt đầu của một mô-đun đang chạy. Cuộc gọi lại này được liên kết với testModuleEnded() và là tùy chọn trong chuỗi. Nó chỉ được sử dụng trong quá trình chạy sử dụng các mô-đun: bộ chạy dựa trên bộ.

Thông số
moduleContext IInvocationContext : IInvocationContext của mô-đun.

thử nghiệmChạyĐã kết thúc

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Báo cáo kết thúc quá trình chạy thử. CỐ ĐỊNH: Chúng tôi không thể có hai giao diện Map<> với loại khác nhau, vì vậy chúng tôi phải sử dụng HashMap tại đây.

Thông số
elapsedTime long : thiết bị đã báo cáo thời gian đã trôi qua, tính bằng mili giây

runMetrics : các cặp khóa-giá trị được báo cáo khi kết thúc quá trình chạy thử nghiệm với Metric .

thử nghiệm Chạy không thành công

public void testRunFailed (FailureDescription failure)

Báo cáo chạy thử không hoàn thành do lỗi được mô tả bởi FailureDescription .

Thông số
failure FailureDescription : FailureDescription mô tả lỗi và bối cảnh của nó.

thử nghiệm Chạy không thành công

public void testRunFailed (String failureMessage)

Báo cáo không hoàn tất quá trình chạy thử do có lỗi nghiêm trọng.

Thông số
failureMessage String : String mô tả lý do chạy thất bại.

thử nghiệmRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Báo cáo việc bắt đầu chạy thử.

Thông số
name String : tên chạy thử

numTests int : tổng số bài kiểm tra trong lần chạy thử

attemptNumber int : số thứ tự, xác định các lần thử khác nhau của cùng một runName chạy nhiều lần. Số lần thử được lập chỉ mục bằng 0 và sẽ tăng lên mỗi lần chạy mới. ví dụ: Một thử nghiệm được thử lại chi tiết 3 lần, nó phải có tổng cộng 4 lần chạy với cùng một runName và số lần thử là từ 0 đến 3.

startTime long : thời gian bắt đầu chạy, được đo thông qua System.currentTimeMillis()