โมดูลฟัง

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

---

Listener ที่แนบมากับแต่ละ IRemoteTest ของแต่ละโมดูลเพื่อรวบรวมรายการผลลัพธ์

สรุป

ผู้สร้างสาธารณะ
ModuleListener ( ITestInvocationListener listener, IInvocationContext moduleContext) ตัวสร้าง

วิธีการสาธารณะ
boolean	hasLastAttemptFailed () ส่งกลับว่าเซสชันการลองใหม่ครั้งล่าสุดของผู้ฟังล้มเหลวหรือไม่
void	logAssociation (String dataName, LogFile logFile) ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างมาก แต่มีโอกาสที่จะทำเช่นนั้นใน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้
void	setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation) ตั้งค่าว่าควรรายงานความพยายามแยกหรือไม่
void	setCollectTestsOnly (boolean collectTestsOnly) ตั้งค่าว่าเราจะรวบรวมเฉพาะการทดสอบหรือไม่
void	setMarkTestsSkipped (boolean skip) ทำเครื่องหมายว่าข้ามกรณีทดสอบทั้งหมดหรือไม่
void	setTestMappingSources ( testMappingSources) setTestMappingSources ( testMappingSources) ตั้งค่าแหล่งที่มาของการแมปทดสอบที่จะแทรกลงในเมตริก
void	testAssumptionFailure ( TestDescription test, String trace) เรียกใช้เมื่อการทดสอบปรมาณูระบุว่าเงื่อนไขเป็นเท็จ
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) เรียกใช้เมื่อการทดสอบปรมาณูระบุว่าเงื่อนไขเป็นเท็จ
void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) ทางเลือกแทน ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) รายงานการสิ้นสุดการดำเนินการของกรณีทดสอบแต่ละรายการ
void	testFailed ( TestDescription test, FailureDescription failure) รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
void	testFailed ( TestDescription test, String trace) รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ
void	testIgnored ( TestDescription test) เรียกว่าเมื่อการทดสอบจะไม่ถูกเรียกใช้ โดยทั่วไปเนื่องจากวิธีการทดสอบมีหมายเหตุประกอบด้วย org.junit.Ignore
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) รายงานการสิ้นสุดการทดสอบการทำงาน
void	testRunFailed ( FailureDescription failure) การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription
void	testRunFailed (String errorMessage) เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง
void	testRunStarted (String name, int numTests, int attemptNumber) รายงานการเริ่มต้นการทดสอบการทำงาน
void	testRunStarted (String name, int numTests, int attemptNumber, long startTime) รายงานการเริ่มต้นการทดสอบการทำงาน
void	testStarted ( TestDescription test, long startTime) ทางเลือกอื่นนอกเหนือจาก testStarted(com.android.tradefed.result.TestDescription) ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ รวมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) เพื่อการวัดที่แม่นยำ .

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

โมดูลฟัง

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

ตัวสร้าง

พารามิเตอร์
listener	ITestInvocationListener
moduleContext	IInvocationContext

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

มี LastAttempt ล้มเหลว

public boolean hasLastAttemptFailed ()

ส่งกลับว่าเซสชันการลองใหม่ครั้งล่าสุดของผู้ฟังล้มเหลวหรือไม่

ส่งคืน
boolean

เข้าสู่ระบบสมาคม

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 ที่ถูกบันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

ตั้งค่าว่าควรรายงานความพยายามแยกหรือไม่

พารามิเตอร์
isolation	CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

ตั้งค่าว่าเราจะรวบรวมเฉพาะการทดสอบหรือไม่

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

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

ทำเครื่องหมายว่าข้ามกรณีทดสอบทั้งหมดหรือไม่

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

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

ตั้งค่าแหล่งที่มาของการแมปทดสอบที่จะแทรกลงในเมตริก

พารามิเตอร์
testMappingSources

ทดสอบ สมมติฐาน ความล้มเหลว

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

ทดสอบ สมมติฐาน ความล้มเหลว

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

พารามิเตอร์
test	TestDescription : ระบุการทดสอบ
failure	FailureDescription : FailureDescription อธิบายความล้มเหลวและบริบท

การทดสอบสิ้นสุดแล้ว

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

ทางเลือกแทน ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) ซึ่งเราสามารถระบุเวลาสิ้นสุดได้โดยตรง รวมกับ testStarted(com.android.tradefed.result.TestDescription, long) เพื่อการวัดที่แม่นยำ

พารามิเตอร์
test	TestDescription : ระบุการทดสอบ
endTime	long : เวลาที่การทดสอบสิ้นสุดลง วัดผ่าน System.currentTimeMillis()
testMetrics	: ERROR(/Map) ของเมตริกที่ปล่อยออกมา

การทดสอบสิ้นสุดแล้ว

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

พารามิเตอร์
test	TestDescription : ระบุการทดสอบ
testMetrics	: ERROR(/Map) ของเมตริกที่ปล่อยออกมา

การทดสอบล้มเหลว

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

พารามิเตอร์
test	TestDescription : ระบุการทดสอบ
failure	FailureDescription : FailureDescription อธิบายความล้มเหลวและบริบท

การทดสอบล้มเหลว

public void testFailed (TestDescription test, 
                String trace)

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

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

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

ทดสอบละเว้น

public void testIgnored (TestDescription test)

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

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

บันทึกการทดสอบ

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

พารามิเตอร์
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

บันทึกการทดสอบที่บันทึกไว้

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

พารามิเตอร์
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

การทดสอบรันสิ้นสุดแล้ว

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 errorMessage)

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

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

ทดสอบ RunStarted

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

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

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

ทดสอบ 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 : เวลาที่รันเริ่มต้น โดยวัดจาก System.currentTimeMillis()

เริ่มการทดสอบแล้ว

public void testStarted (TestDescription test, 
                long startTime)

ทางเลือกอื่นนอกเหนือจาก testStarted(com.android.tradefed.result.TestDescription) ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ รวมกับ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) เพื่อการวัดที่แม่นยำ .

พารามิเตอร์
test	TestDescription : ระบุการทดสอบ
startTime	long : เวลาที่การทดสอบเริ่มต้น วัดผ่าน System.currentTimeMillis()