ShardListener
public class ShardListener
extends CollectingTestListener
implements ISupportGranularResults
java.lang.Object | ||
↳ | com.android.tradefed.result.การรวบรวมTestListener | |
↳ | com.android.tradefed.inviver.ShardListener |
ITestInvocationListener
ที่รวบรวมผลลัพธ์จากส่วนแบ่งการร้องขอ (หรือที่เรียกว่าการแยกการร้องขอเพื่อรันบนทรัพยากรหลายรายการพร้อมกัน) และส่งต่อไปยัง Listener อื่น
สรุป
ผู้รับเหมาก่อสร้างสาธารณะ | |
---|---|
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พารามิเตอร์ | |
---|---|
elapsedTime | long : เวลาที่ผ่านไปของการร้องขอในหน่วย ms |
การร้องขอล้มเหลว
public void invocationFailed (FailureDescription failure)
รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากมีข้อผิดพลาดบางประการ
จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation
พารามิเตอร์ | |
---|---|
failure | FailureDescription : FailureDescription ที่อธิบายสาเหตุของความล้มเหลว |
การร้องขอล้มเหลว
public void invocationFailed (Throwable cause)
รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากมีข้อผิดพลาดบางประการ
จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederationพารามิเตอร์ | |
---|---|
cause | Throwable : สาเหตุ Throwable ของความล้มเหลว |
การร้องขอเริ่มต้นแล้ว
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)
โดยตรง 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 |
สนับสนุนผลลัพธ์แบบละเอียด
public boolean supportGranularResults ()
ส่งคืน True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด หากไม่ใช่จะเป็นเท็จ
การส่งคืน | |
---|---|
boolean |
บันทึกการทดสอบ
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 จะเสร็จสิ้น |
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)
รายงานการสิ้นสุดการทดสอบการทำงาน การแก้ไข: เราไม่สามารถมีอินเทอร์เฟซ 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 ที่อธิบายสาเหตุของความล้มเหลวในการรัน |
ทดสอบ RunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
รายงานการเริ่มต้นการทดสอบการทำงาน
พารามิเตอร์ | |
---|---|
name | String : ชื่อการทดสอบการทำงาน |
numTests | int : จำนวนการทดสอบทั้งหมดในการทดสอบ |
attemptNumber | int : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่ทำงานหลายครั้ง tryNumber ได้รับการจัดทำดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองซ้ำแบบละเอียด 3 ครั้ง โดยควรมีการทดสอบทั้งหมด 4 ครั้งภายใต้ชื่อ runName เดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3 |
startTime | long : เวลาที่รันเริ่มต้น วัดผ่าน System.currentTimeMillis() |