ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

คลาสย่อยทางอ้อมที่ทราบ StubTestRunListener, TestRunResult, TestRunToTestInvocationForwarder, XmlTestRunListener StubTestRunListener การใช้งาน Stub ของ ITestRunListener  TestRunResult เก็บผลลัพธ์จากการทดสอบครั้งเดียว  TestRunToTestInvocationForwarder ส่งต่อจาก ddmlib ITestRunListener ไปยัง ITestLifeCycleReceiver  XmlTestRunListener เขียนผลลัพธ์ JUnit ลงในไฟล์ XML ในรูปแบบที่สอดคล้องกับ XMLJUnitResultFormatter ของ Ant

---

รับการแจ้งเตือนเหตุการณ์ระหว่างการทดสอบเครื่องมือ

สร้างตาม org.junit.runner.notification.RunListener

ลำดับการเรียกใช้จะเป็นดังนี้

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• [testRunFailed]
• testRunEnded

สรุป

เมธอดสาธารณะ
abstract void	testAssumptionFailure(TestIdentifier test, String trace) เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ
abstract void	testEnded(TestIdentifier test, testMetrics) รายงานจุดสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ
abstract void	testFailed(TestIdentifier test, String trace) รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
abstract void	testIgnored(TestIdentifier test) เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore
abstract void	testRunEnded(long elapsedTime, runMetrics) รายงานเมื่อการทดสอบสิ้นสุด
abstract void	testRunFailed(String errorMessage) การทดสอบการเรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
abstract void	testRunStarted(String runName, int testCount) รายงานการเริ่มต้นการทดสอบ
abstract void	testRunStopped(long elapsedTime) เลิกใช้เมธอดนี้แล้ว ระบบจะไม่เรียกใช้การเรียกกลับนี้ หากต้องการลบ
abstract void	testStarted(TestIdentifier test) รายงานจุดเริ่มต้นของกรณีทดสอบแต่ละรายการ

เมธอดสาธารณะ

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ

พารามิเตอร์
test	TestIdentifier: ระบุการทดสอบ
trace	String: สแต็กเทรซของความล้มเหลว

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

รายงานจุดสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ

หากไม่ได้เรียกใช้ testFailed(TestIdentifier, String) การทดสอบนี้จะผ่าน นอกจากนี้ยังแสดงผลเมตริกคีย์/ค่า ที่อาจมีการปล่อยออกมาในระหว่างการดำเนินการกรณีทดสอบด้วย

พารามิเตอร์
test	TestIdentifier: ระบุการทดสอบ
testMetrics	: ERROR(/Map) ของเมตริกที่ปล่อยออกมาในระหว่างการดำเนินการของกรณีทดสอบ โดย android.app.Instrumentation#sendStatus ระบบจะรักษาลำดับการแทรก เว้นแต่คุณจะส่งคีย์เดียวกันหลายครั้ง โปรดทราบว่าระบบจะกรองคีย์มาตรฐานที่กำหนดไว้ใน IInstrumentationResultParser.StatusKeys ออกจากแผนที่นี้ Ddmlib อาจเพิ่ม เมตริกการทดสอบเพิ่มเติมที่กำหนดไว้ใน IInstrumentationResultParser.StatusKeys

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ

จะเรียกใช้ระหว่าง testStarted และ testEnded

พารามิเตอร์
test	TestIdentifier: ระบุการทดสอบ
trace	String: สแต็กเทรซของความล้มเหลว

testIgnored

public abstract void testIgnored (TestIdentifier test)

เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore

พารามิเตอร์
test	TestIdentifier: ระบุการทดสอบ

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

รายงานเมื่อการทดสอบสิ้นสุด

พารามิเตอร์
elapsedTime	long: อุปกรณ์รายงานเวลาที่ผ่านไปเป็นมิลลิวินาที
runMetrics	: ERROR(/Map) ของเมตริกที่ปล่อยออกมาในระหว่างการดำเนินการของกรณีทดสอบ โดย android.app.Instrumentation#addResults ระบบจะรักษาลำดับการแทรก เว้นแต่คุณจะส่งคีย์เดียวกันหลายครั้ง โปรดทราบว่าระบบจะกรองคีย์มาตรฐานที่กำหนดไว้ใน IInstrumentationResultParser.StatusKeys ออกจากแผนที่นี้ Ddmlib อาจเพิ่ม เมตริกการทดสอบเพิ่มเติมที่กำหนดไว้ใน IInstrumentationResultParser.StatusKeys

testRunFailed

public abstract void testRunFailed (String errorMessage)

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

พารามิเตอร์
errorMessage	String: String อธิบายเหตุผลที่การเรียกใช้ล้มเหลว

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

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

พารามิเตอร์
runName	String: ชื่อการทดสอบ
testCount	int: จำนวนการทดสอบทั้งหมดในการทดสอบการเรียกใช้

testRunStopped

public abstract void testRunStopped (long elapsedTime)

เลิกใช้เมธอดนี้แล้ว
ระบบจะไม่เรียกใช้การเรียกกลับนี้ จะถูกลบ

การทดสอบรายงานหยุดก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้

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

testStarted

public abstract void testStarted (TestIdentifier test)

รายงานจุดเริ่มต้นของกรณีทดสอบแต่ละรายการ

พารามิเตอร์
test	TestIdentifier: ระบุการทดสอบ