ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

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


ITestInvocationListener ที่รวบรวมผลลัพธ์จากส่วนแบ่งการเรียกใช้ (หรือที่เรียกว่าการแยกการเรียกใช้เพื่อเรียกใช้ทรัพยากรหลายรายการพร้อมกัน) และส่งต่อไปยังผู้ฟังรายอื่น

สรุป

ผู้สร้างสาธารณะ

ShardListener ( ITestInvocationListener main)

สร้าง ShardListener

วิธีการสาธารณะ

void invocationEnded (long elapsedTime)

รายงานว่าการร้องขอได้สิ้นสุดลง ไม่ว่าจะสำเร็จหรือเกิดจากเงื่อนไขข้อผิดพลาดบางประการ

void invocationFailed ( FailureDescription failure)

รายงานการเรียกที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง

void invocationFailed (Throwable cause)

รายงานการเรียกที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง

void invocationStarted ( IInvocationContext context)

รายงานการเริ่มต้นการเรียกใช้การทดสอบ

void logAssociation (String dataName, LogFile logFile)

ในบางกรณี บันทึกจะต้องมีความเกี่ยวข้องอย่างยิ่งกับกรณีทดสอบ แต่มีโอกาสที่จะทำเช่นนั้นบน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

คืนค่า True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด มิฉะนั้นจะเป็นเท็จ

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

จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการดีบักจากการเรียกใช้การทดสอบ

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

void testModuleEnded ()

รายงานการสิ้นสุดการรันโมดูล

void testModuleStarted ( IInvocationContext moduleContext)

รายงานการเริ่มต้นของโมดูลที่ทำงานอยู่

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

รายงานสิ้นสุดการทดสอบการทำงาน

void testRunFailed ( FailureDescription failure)

การเรียกใช้การทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

void testRunFailed (String failureMessage)

เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากข้อผิดพลาดร้ายแรง

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

รายงานการเริ่มต้นของการทดสอบรัน

ผู้สร้างสาธารณะ

ShardListener

public ShardListener (ITestInvocationListener main)

สร้าง ShardListener

พารามิเตอร์
main ITestInvocationListener : ITestInvocationListener ผลลัพธ์ควรถูกส่งต่อ เพื่อป้องกันการชนกับ ShardListener อื่น ออบเจ็กต์นี้จะซิงโครไนซ์กับ main เมื่อส่งต่อผลลัพธ์ และผลลัพธ์จะถูกส่งต่อเมื่อชาร์ดการร้องขอเสร็จสมบูรณ์เท่านั้น

วิธีการสาธารณะ

การร้องขอสิ้นสุด

public void invocationEnded (long elapsedTime)

รายงานว่าการร้องขอได้สิ้นสุดลง ไม่ว่าจะสำเร็จหรือเกิดจากเงื่อนไขข้อผิดพลาดบางประการ

จะถูกเรียกโดยอัตโนมัติโดยกรอบงานของ TradeFederation

พารามิเตอร์
elapsedTime long : เวลาที่ผ่านไปของการร้องขอใน ms

invocationFailed

public void invocationFailed (FailureDescription failure)

รายงานการเรียกที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง

จะถูกเรียกโดยอัตโนมัติโดยกรอบงานของ TradeFederation

พารามิเตอร์
failure FailureDescription : FailureDescription อธิบายสาเหตุของความล้มเหลว

invocationFailed

public void invocationFailed (Throwable cause)

รายงานการเรียกที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง

จะถูกเรียกโดยอัตโนมัติโดยกรอบงานของ TradeFederation

พารามิเตอร์
cause Throwable ได้ : สาเหตุของความล้มเหลวที่ Throwable ได้

invocationStarted

public void invocationStarted (IInvocationContext context)

รายงานการเริ่มต้นการเรียกใช้การทดสอบ

จะถูกเรียกโดยอัตโนมัติโดยกรอบงานของ TradeFederation ผู้รายงานจำเป็นต้องแทนที่วิธีนี้เพื่อรองรับการรายงานอุปกรณ์หลายเครื่อง

พารามิเตอร์
context IInvocationContext : ข้อมูลเกี่ยวกับการร้องขอ

บันทึกสมาคม

public void logAssociation (String dataName, 
                LogFile logFile)

ในบางกรณี บันทึกจะต้องมีความเกี่ยวข้องอย่างยิ่งกับกรณีทดสอบ แต่มีโอกาสที่จะทำเช่นนั้นบน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้ ดังนั้น การเรียกกลับนี้ช่วยให้สามารถให้การเชื่อมโยงที่แข็งแกร่งอย่างชัดเจน

พารามิเตอร์
dataName String : ชื่อของ data

logFile LogFile : LogFile ที่บันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

พารามิเตอร์
enableGranularResults boolean

การสนับสนุนแบบละเอียดผลลัพธ์

public boolean supportGranularResults ()

คืนค่า True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด มิฉะนั้นจะเป็นเท็จ

คืนสินค้า
boolean

testLog

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

จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการดีบักจากการเรียกใช้การทดสอบ

ต้องถูกเรียกก่อน ERROR(/ITestInvocationListener#invocationFailed(Throwable)) หรือ ERROR(/ITestInvocationListener#invocationEnded(long))

กรอบงานของ TradeFederation จะเรียกวิธีนี้โดยอัตโนมัติ โดยระบุบันทึกของโฮสต์และ Logcat ของอุปกรณ์หากมี

พารามิเตอร์
dataName String : ชื่อคำอธิบาย String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้แต่ละครั้ง กล่าวคือ ผู้ดำเนินการต้องสามารถจัดการการโทรหลายครั้งด้วย dataName . เดียวกัน

dataType LogDataType : LogDataType ของข้อมูล

dataStream InputStreamSource : InputStreamSource ของข้อมูล ผู้ดำเนินการควรเรียก createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบให้แน่ใจว่าได้ปิด InputStream ที่เป็นผลลัพธ์เมื่อเสร็จสิ้น ผู้โทรควรตรวจสอบให้แน่ใจว่าแหล่งข้อมูลยังคงมีอยู่และสามารถเข้าถึงได้จนกว่าวิธี testLog จะเสร็จสมบูรณ์

testLogSaved

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

พารามิเตอร์
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

ทดสอบโมดูลสิ้นสุด

public void testModuleEnded ()

รายงานการสิ้นสุดการรันโมดูล

ทดสอบโมดูลเริ่มแล้ว

public void testModuleStarted (IInvocationContext moduleContext)

รายงานการเริ่มต้นของโมดูลที่ทำงานอยู่ การเรียกกลับนี้เชื่อมโยงกับ testModuleEnded() และเป็นทางเลือกในลำดับ ใช้เฉพาะในระหว่างการวิ่งที่ใช้โมดูล: ชุดวิ่งตาม

พารามิเตอร์
moduleContext IInvocationContext : IInvocationContext ของโมดูล

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

รายงานสิ้นสุดการทดสอบการทำงาน แก้ไข: เราไม่สามารถมีอินเทอร์เฟซ Map<> สองรายการที่มีประเภทต่างกัน ดังนั้นเราจึงต้องใช้ HashMap ที่นี่

พารามิเตอร์
elapsedTime long : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที

runMetrics : คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบด้วย Metric

testRunFailed

public void testRunFailed (FailureDescription failure)

การเรียกใช้การทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

พารามิเตอร์
failure FailureDescription : FailureDescription อธิบายความล้มเหลวและบริบท

testRunFailed

public void testRunFailed (String failureMessage)

เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากข้อผิดพลาดร้ายแรง

พารามิเตอร์
failureMessage String : String ที่อธิบายสาเหตุของความล้มเหลวในการรัน

testRunStarted

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

รายงานการเริ่มต้นของการทดสอบรัน

พารามิเตอร์
name String : ชื่อการทดสอบรัน

numTests int : จำนวนการทดสอบทั้งหมดในการทดสอบรัน

attemptNumber int : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่ทำงานหลายครั้ง TryNumber ถูกสร้างดัชนี 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบเป็นการลองใหม่แบบละเอียด 3 ครั้ง ควรมีรันทั้งหมด 4 ครั้งภายใต้ชื่อ runName เดียวกัน และ tryNumber มีค่าตั้งแต่ 0 ถึง 3

startTime long : เวลาที่เริ่มการทำงาน วัดผ่าน System.currentTimeMillis()