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) สร้าง |
วิธีการสาธารณะ | |
---|---|
getUnderlyingResultReporter () | |
void | invocationEnded (long elapsedTime) รายงานว่าการร้องขอสิ้นสุดลง ไม่ว่าจะสำเร็จหรือเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationFailed ( FailureDescription failure) รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationFailed (Throwable cause) รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationStarted ( IInvocationContext context) รายงานการเริ่มต้นการเรียกทดสอบ |
void | logAssociation (String dataName, LogFile 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) การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย |
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 เมื่อส่งต่อผลลัพธ์ และผลลัพธ์จะถูกส่งเมื่อส่วนการร้องขอเสร็จสมบูรณ์เท่านั้น |
วิธีการสาธารณะ
getUnderlyingResultReporter
publicgetUnderlyingResultReporter ()
ส่งคืน | |
---|---|
สิ้นสุดการร้องขอ
public void invocationEnded (long elapsedTime)
รายงานว่าการร้องขอสิ้นสุดลง ไม่ว่าจะสำเร็จหรือเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation frameworkพารามิเตอร์ | |
---|---|
elapsedTime | long : เวลาที่ผ่านไปของการเรียกใช้ในหน่วย ms |
การร้องขอล้มเหลว
public void invocationFailed (FailureDescription failure)
รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework
พารามิเตอร์ | |
---|---|
failure | FailureDescription : FailureDescription ที่อธิบายสาเหตุของความล้มเหลว |
การร้องขอล้มเหลว
public void invocationFailed (Throwable cause)
รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง
จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation frameworkพารามิเตอร์ | |
---|---|
cause | Throwable : สาเหตุ ERROR(/Throwable) ของความล้มเหลว |
เรียกใช้เริ่มต้น
public void invocationStarted (IInvocationContext context)
รายงานการเริ่มต้นการเรียกทดสอบ
จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework ผู้รายงานต้องแทนที่วิธีนี้เพื่อรองรับการรายงานหลายอุปกรณ์
พารามิเตอร์ | |
---|---|
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 : ชื่อของข้อมูล |
logFile | LogFile : LogFile ที่ถูกบันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ |
setSupportGranularResults
public void setSupportGranularResults (boolean enableGranularResults)
พารามิเตอร์ | |
---|---|
enableGranularResults | boolean |
สนับสนุน GranularResults
public boolean supportGranularResults ()
คืนค่า True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด มิฉะนั้นจะเป็นเท็จ
ส่งคืน | |
---|---|
boolean |
บันทึกการทดสอบ
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการดีบักจากการเรียกทดสอบ
ต้องเรียกก่อนERROR(/ITestInvocationListener#invocationFailed(Throwable))
หรือ ERROR(/ITestInvocationListener#invocationEnded(long))
กรอบงาน TradeFederation จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยจัดเตรียมบันทึกโฮสต์และบันทึกอุปกรณ์ (ถ้ามี)พารามิเตอร์ | |
---|---|
dataName | String : ชื่ออธิบาย ERROR(/String) ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ คือผู้ดำเนินการต้องสามารถจัดการการโทรหลายรายการด้วย dataName เดียวกันได้ |
dataType | LogDataType : LogDataType ของข้อมูล |
dataStream | InputStreamSource : InputStreamSource ของข้อมูล Implementers ควรเรียก createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบให้แน่ใจว่าได้ปิด InputStream ที่เป็นผลลัพธ์เมื่อเสร็จสิ้น ผู้โทรควรตรวจสอบให้แน่ใจว่าแหล่งที่มาของข้อมูลยังคงอยู่และสามารถเข้าถึงได้จนกว่าวิธีการ testLog จะเสร็จสมบูรณ์ |
บันทึกการทดสอบที่บันทึกไว้
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 ของโมดูล |
การทดสอบรันสิ้นสุดแล้ว
public void testRunEnded (long elapsedTime,runMetrics)
รายงานการสิ้นสุดการทดสอบการทำงาน FIXME: เราไม่สามารถมีอินเทอร์เฟซ Map<> สองรายการที่มีประเภทต่างกันได้ ดังนั้นเราต้องใช้ HashMap ที่นี่
พารามิเตอร์ | |
---|---|
elapsedTime | long : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที |
runMetrics | Metric |
การทดสอบรันล้มเหลว
public void testRunFailed (FailureDescription failure)
การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription
พารามิเตอร์ | |
---|---|
failure | FailureDescription : FailureDescription อธิบายความล้มเหลวและบริบท |
การทดสอบรันล้มเหลว
public void testRunFailed (String failureMessage)
เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
พารามิเตอร์ | |
---|---|
failureMessage | String : ERROR(/String) อธิบายสาเหตุของความล้มเหลวในการรัน |
ทดสอบ RunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
รายงานการเริ่มต้นการทดสอบการทำงาน
พารามิเตอร์ | |
---|---|
name | String : ชื่อการทดสอบการทำงาน |
numTests | int : จำนวนการทดสอบทั้งหมดในการทดสอบการทำงาน |
attemptNumber | int : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่เรียกใช้หลายครั้ง จำนวนความพยายามเป็น 0 จัดทำดัชนีและควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองใหม่แบบละเอียด 3 ครั้ง ควรมีการรันทั้งหมด 4 ครั้งภายใต้ชื่อรันเดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3 |
startTime | long : เวลาที่รันเริ่มต้น โดยวัดจาก ERROR(/System#currentTimeMillis()) |