SubprocessResultsReporter
public class SubprocessResultsReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
ใช้ ITestInvocationListener
เพื่อระบุเป็น result_reporter และส่งต่อผลลัพธ์ของการทดสอบ การทดสอบรัน การทดสอบการเรียกใช้จากการประมวลผลย่อย
สรุป
ผู้สร้างสาธารณะ | |
---|---|
SubprocessResultsReporter () |
วิธีการสาธารณะ | |
---|---|
void | close () |
TestSummary | getSummary () อนุญาตให้ InvocationListener ส่งคืนข้อมูลสรุป |
void | invocationEnded (long elapsedTime) รายงานว่าการร้องขอสิ้นสุดลง ไม่ว่าจะสำเร็จหรือเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationFailed ( FailureDescription failure) รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationFailed (Throwable cause) รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationStarted ( IInvocationContext context) รายงานการเริ่มต้นการเรียกทดสอบ |
void | logAssociation (String dataName, LogFile logFile) ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างมาก แต่มีโอกาสที่จะทำเช่นนั้นใน |
void | printEvent (String key, Object event) ตัวช่วยในการพิมพ์รหัสเหตุการณ์จากนั้นวัตถุ json |
void | setOutputTestLog (boolean outputTestLog) ตั้งค่าว่าเราควรส่งออกการทดสอบที่บันทึกหรือไม่ |
boolean | supportGranularResults () คืนค่า True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด มิฉะนั้นจะเป็นเท็จ |
void | testAssumptionFailure ( TestDescription testId, String trace) เรียกใช้เมื่อการทดสอบปรมาณูระบุว่าเงื่อนไขเป็นเท็จ |
void | testAssumptionFailure ( TestDescription testId, FailureDescription failure) เรียกใช้เมื่อการทดสอบปรมาณูระบุว่าเงื่อนไขเป็นเท็จ |
void | testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics) ทางเลือกแทน |
void | testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics) รายงานการสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ |
void | testFailed ( TestDescription testId, FailureDescription failure) รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ |
void | testFailed ( TestDescription testId, String reason) รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ |
void | testIgnored ( TestDescription testId) เรียกว่าเมื่อการทดสอบจะไม่ถูกเรียกใช้ โดยทั่วไปเนื่องจากวิธีการทดสอบมีหมายเหตุประกอบด้วย org.junit.Ignore |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการดีบักจากการเรียกทดสอบ |
void | testModuleEnded () รายงานการสิ้นสุดของการรันโมดูล |
void | testModuleStarted ( IInvocationContext moduleContext) รายงานการเริ่มต้นโมดูลที่กำลังทำงาน |
void | testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics) รายงานการสิ้นสุดการทดสอบการทำงาน |
void | testRunFailed ( FailureDescription failure) การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย |
void | testRunFailed (String reason) เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง |
void | testRunStarted (String runName, int testCount, int attemptNumber) รายงานการเริ่มต้นการทดสอบการทำงาน |
void | testRunStarted (String runName, int testCount) รายงานการเริ่มต้นการทดสอบการทำงาน |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) รายงานการเริ่มต้นการทดสอบการทำงาน |
void | testRunStopped (long arg0) รายงานการทดสอบหยุดทำงานก่อนที่จะเสร็จสิ้นเนื่องจากคำขอของผู้ใช้ |
void | testStarted ( TestDescription testId, long startTime) ทางเลือกอื่นนอกเหนือจาก |
void | testStarted ( TestDescription testId) รายงานการเริ่มต้นกรณีทดสอบแต่ละรายการ |
ผู้สร้างสาธารณะ
SubprocessResultsReporter
public SubprocessResultsReporter ()
วิธีการสาธารณะ
ปิด
public void close ()
รับบทสรุป
public TestSummary getSummary ()
อนุญาตให้ InvocationListener ส่งคืนข้อมูลสรุป
ส่งคืน | |
---|---|
TestSummary | TestSummary สรุปการรัน หรือ null |
สิ้นสุดการร้องขอ
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 ที่ถูกบันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ |
พิมพ์เหตุการณ์
public void printEvent (String key, Object event)
ตัวช่วยในการพิมพ์รหัสเหตุการณ์จากนั้นวัตถุ json
พารามิเตอร์ | |
---|---|
key | String |
event | Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
ตั้งค่าว่าเราควรส่งออกการทดสอบที่บันทึกหรือไม่
พารามิเตอร์ | |
---|---|
outputTestLog | boolean |
สนับสนุน GranularResults
public boolean supportGranularResults ()
คืนค่า True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด มิฉะนั้นจะเป็นเท็จ
ส่งคืน | |
---|---|
boolean |
ทดสอบ สมมติฐาน ความล้มเหลว
public void testAssumptionFailure (TestDescription testId, String trace)
เรียกใช้เมื่อการทดสอบปรมาณูระบุว่าเงื่อนไขเป็นเท็จ
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |
trace | String : สแต็กเทรซของความล้มเหลว |
ทดสอบ สมมติฐาน ความล้มเหลว
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
เรียกใช้เมื่อการทดสอบปรมาณูระบุว่าเงื่อนไขเป็นเท็จ
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |
failure | FailureDescription : FailureDescription อธิบายความล้มเหลวและบริบท |
การทดสอบสิ้นสุดแล้ว
public void testEnded (TestDescription testId, long endTime,metrics)
ทางเลือกแทน ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง รวมกับ testStarted(com.android.tradefed.result.TestDescription, long)
เพื่อการวัดที่แม่นยำ
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |
endTime | long : เวลาที่การทดสอบสิ้นสุดลง โดยวัดจาก ERROR(/System#currentTimeMillis()) |
metrics | ERROR(/Map) ของเมตริกที่ปล่อยออกมา |
การทดสอบสิ้นสุดแล้ว
public void testEnded (TestDescription testId,metrics)
รายงานการสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ
หากไม่ได้เรียกใช้ testFailed(TestDescription, FailureDescription)
แสดงว่าการทดสอบนี้ผ่าน ส่งคืนเมตริกคีย์/ค่าใดๆ ที่อาจถูกปล่อยออกมาในระหว่างการดำเนินการกรณีทดสอบ
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |
metrics | ERROR(/Map) ของเมตริกที่ปล่อยออกมา |
การทดสอบล้มเหลว
public void testFailed (TestDescription testId, FailureDescription failure)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
จะถูกเรียกใช้ระหว่าง testStarted และ testEnded
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |
failure | FailureDescription : FailureDescription อธิบายความล้มเหลวและบริบท |
การทดสอบล้มเหลว
public void testFailed (TestDescription testId, String reason)
รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
จะถูกเรียกใช้ระหว่าง testStarted และ testEnded
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |
reason | String : สแต็กเทรซของความล้มเหลว |
ทดสอบละเว้น
public void testIgnored (TestDescription testId)
เรียกว่าเมื่อการทดสอบจะไม่ถูกเรียกใช้ โดยทั่วไปเนื่องจากวิธีการทดสอบมีหมายเหตุประกอบด้วย org.junit.Ignore
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |
บันทึกการทดสอบ
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 testModuleEnded ()
รายงานการสิ้นสุดของการรันโมดูล
ทดสอบโมดูลเริ่มต้นแล้ว
public void testModuleStarted (IInvocationContext moduleContext)
รายงานการเริ่มต้นโมดูลที่กำลังทำงาน การเรียกกลับนี้เชื่อมโยงกับ testModuleEnded()
และเป็นทางเลือกในลำดับ ใช้เฉพาะระหว่างการวิ่งที่ใช้โมดูล: นักวิ่งตามชุด
พารามิเตอร์ | |
---|---|
moduleContext | IInvocationContext : IInvocationContext ของโมดูล |
การทดสอบรันสิ้นสุดแล้ว
public void testRunEnded (long time,runMetrics)
รายงานการสิ้นสุดการทดสอบการทำงาน FIXME: เราไม่สามารถมีอินเทอร์เฟซ Map<> สองรายการที่มีประเภทต่างกันได้ ดังนั้นเราต้องใช้ HashMap ที่นี่
พารามิเตอร์ | |
---|---|
time | long : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที |
runMetrics | Metric |
การทดสอบรันล้มเหลว
public void testRunFailed (FailureDescription failure)
การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription
พารามิเตอร์ | |
---|---|
failure | FailureDescription : FailureDescription อธิบายความล้มเหลวและบริบท |
การทดสอบรันล้มเหลว
public void testRunFailed (String reason)
เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
พารามิเตอร์ | |
---|---|
reason | String : ERROR(/String) อธิบายสาเหตุของความล้มเหลวในการรัน |
ทดสอบ RunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
รายงานการเริ่มต้นการทดสอบการทำงาน
พารามิเตอร์ | |
---|---|
runName | String : ชื่อการทดสอบการทำงาน |
testCount | int : จำนวนการทดสอบทั้งหมดในการทดสอบการทำงาน |
attemptNumber | int : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่เรียกใช้หลายครั้ง จำนวนความพยายามเป็น 0 จัดทำดัชนีและควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองใหม่แบบละเอียด 3 ครั้ง ควรมีการรันทั้งหมด 4 ครั้งภายใต้ชื่อรันเดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3 |
ทดสอบ RunStarted
public void testRunStarted (String runName, int testCount)
รายงานการเริ่มต้นการทดสอบการทำงาน
พารามิเตอร์ | |
---|---|
runName | String : ชื่อการทดสอบการทำงาน |
testCount | int : จำนวนการทดสอบทั้งหมดในการทดสอบการทำงาน |
ทดสอบ RunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
รายงานการเริ่มต้นการทดสอบการทำงาน
พารามิเตอร์ | |
---|---|
runName | String : ชื่อการทดสอบการทำงาน |
testCount | int : จำนวนการทดสอบทั้งหมดในการทดสอบการทำงาน |
attemptNumber | int : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่เรียกใช้หลายครั้ง จำนวนความพยายามเป็น 0 จัดทำดัชนีและควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองใหม่แบบละเอียด 3 ครั้ง ควรมีการรันทั้งหมด 4 ครั้งภายใต้ชื่อรันเดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3 |
startTime | long : เวลาที่รันเริ่มต้น โดยวัดจาก ERROR(/System#currentTimeMillis()) |
ทดสอบ RunStopped
public void testRunStopped (long arg0)
รายงานการทดสอบหยุดทำงานก่อนที่จะเสร็จสิ้นเนื่องจากคำขอของผู้ใช้
สิ่งที่ต้องทำ: ยังไม่ได้ใช้ พิจารณาลบ
พารามิเตอร์ | |
---|---|
arg0 | long : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที |
เริ่มการทดสอบแล้ว
public void testStarted (TestDescription testId, long startTime)
ทางเลือกอื่นนอกเหนือจาก testStarted(com.android.tradefed.result.TestDescription)
ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ รวมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
เพื่อการวัดที่แม่นยำ .
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |
startTime | long : เวลาที่การทดสอบเริ่มต้น โดยวัดจาก ERROR(/System#currentTimeMillis()) |
เริ่มการทดสอบแล้ว
public void testStarted (TestDescription testId)
รายงานการเริ่มต้นกรณีทดสอบแต่ละรายการ อินเทอร์เฟซรุ่นเก่า ควรใช้ testStarted(com.android.tradefed.result.TestDescription)
ทุกครั้งที่ทำได้
พารามิเตอร์ | |
---|---|
testId | TestDescription : ระบุการทดสอบ |