Trình nghe Shard

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
   ↳ com.android.tradefed.result.collectingTestListener
     ↳ com.android.tradefed.Callr.ShardListener

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

Tóm tắt

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

ShardListener(ITestInvocationListener main)

Tạo ShardListener.

Phương thức 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ố lỗi .

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 setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

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

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

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

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

void testModuleEnded()

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

void testModuleStarted(IInvocationContext moduleContext)

Báo cáo việc bắt đầu một mô-đun đang chạy.

void testRunEnded(long elapsedTime, runMetrics)

Báo cáo kết thúc lần chạy thử nghiệm.

void testRunFailed(FailureDescription failure)

Không hoàn tất được quá trình chạy thử nghiệm báo cáo do lỗi theo mô tả của FailureDescription.

void testRunFailed(String failureMessage)

Không hoàn tất được quá trình chạy thử nghiệm báo cáo do xảy ra lỗi nghiêm trọng.

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

Báo cáo thời điểm bắt đầu chạy kiểm thử.

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

Trình nghe Shard

public ShardListener (ITestInvocationListener main)

Tạo ShardListener.

Tham số
main ITestInvocationListener: ITestInvocationListener kết quả sẽ được chuyển tiếp. Để ngăn chặn xung đột với các ShardListener khác, đối tượng này sẽ đồng bộ hoá 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 thức công khai

getunderRollResultReporter

public  getUnderlyingResultReporter ()

Giá trị trả về

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

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ử.

setSupportGranularKết quả

public void setSupportGranularResults (boolean enableGranularResults)

Tham số
enableGranularResults boolean

supportGranularKết quả

public boolean supportGranularResults ()

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

Giá trị trả về
boolean

nhật ký kiểm thử

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

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

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 và cung cấp nhật ký máy chủ lưu trữ và nếu có thì là logcat thiết bị.

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. Phương thức gọi phải đảm bảo giữ lại nguồn dữ liệu có sẵ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)

Tham số
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

thử nghiệmMô-đun đã kết thúc

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Báo cáo việc bắt đầu một mô-đun đang chạy. Lệnh gọi lại này được liên kết với testModuleEnded() và không bắt buộc trong trình tự. Chỉ được dùng trong lần chạy có sử dụng mô-đun: trình chạy dựa trên bộ sản phẩm.

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

testRun kết thúc

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Báo cáo kết thúc lần chạy thử nghiệm. FIXME: Chúng tôi không thể có hai Bản đồ<> giao diện khác loại, vì vậy, chúng tôi phải sử dụng HashMap ở đây.

Tham số
elapsedTime long: thời gian đã trôi qua theo báo cáo của thiết bị, tính bằng mili giây
runMetrics : các cặp khoá-giá trị được báo cáo khi kết thúc lượt chạy kiểm thử bằng Metric.

testRunFailed không thành công

public void testRunFailed (FailureDescription failure)

Không hoàn tất được quá trình chạy thử nghiệm báo cáo do lỗi theo mô tả của FailureDescription.

Tham số
failure FailureDescription: FailureDescription mô tả lỗi và ngữ cảnh của lỗi.

testRunFailed không thành công

public void testRunFailed (String failureMessage)

Không hoàn tất được quá trình chạy thử nghiệm báo cáo do xảy ra lỗi nghiêm trọng.

Tham số
failureMessage String: String mô tả lý do không chạy được.

Đã bắt đầu kiểm thử

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

Báo cáo thời điểm bắt đầu chạy kiểm thử.

Tham số
name String: tên chạy kiểm thử
numTests int: tổng số kiểm thử trong lần chạy kiểm 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ố tryNumber được lập chỉ mục 0 và sẽ tăng mỗi khi một lần chạy mới sẽ diễn ra. ví dụ: Một bài kiểm thử được thử lại ở cấp độ chi tiết 3 lần, và tổng cộng sẽ có 4 lần chạy trong cùng một runName và tryNumber là từ 0 đến 3.
startTime long: thời gian bắt đầu chạy, được đo bằng System.currentTimeMillis()