ผู้ส่งต่อผลลัพธ์
public class ResultForwarder
extends Object
implements ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.ResultForwarder |
ITestInvocationListener
ที่ส่งต่อผลการร้องขอไปยังรายการ Listener อื่นๆ
สรุป
ผู้สร้างสาธารณะ | |
---|---|
ResultForwarder ( listeners) ResultForwarder ( listeners) สร้าง | |
ResultForwarder ( ITestInvocationListener... listeners) ตัวสร้าง arg ตัวแปรสำรองสำหรับ |
ตัวสร้างที่ได้รับการป้องกัน | |
---|---|
ResultForwarder () สร้าง |
วิธีการสาธารณะ | |
---|---|
TestSummary | getSummary () อนุญาตให้ InvocationListener ส่งคืนข้อมูลสรุป |
void | invocationEnded (long elapsedTime) รายงานว่าการร้องขอสิ้นสุดลง ไม่ว่าจะสำเร็จหรือเนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationFailed ( FailureDescription failure) รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationFailed (Throwable cause) รายงานการร้องขอที่ไม่สมบูรณ์เนื่องจากเงื่อนไขข้อผิดพลาดบางอย่าง |
void | invocationStarted ( IInvocationContext context) รายงานการเริ่มต้นการเรียกทดสอบ |
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) ทางเลือกแทน |
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 | testModuleEnded () รายงานการสิ้นสุดของการรันโมดูล |
void | testModuleStarted ( IInvocationContext moduleContext) รายงานการเริ่มต้นโมดูลที่กำลังทำงาน |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) รายงานการสิ้นสุดการทดสอบการทำงาน |
void | testRunFailed ( FailureDescription failure) การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย |
void | testRunFailed (String errorMessage) เรียกใช้การทดสอบรายงานไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดร้ายแรง |
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 elapsedTime) รายงานการทดสอบหยุดทำงานก่อนที่จะเสร็จสิ้นเนื่องจากคำขอของผู้ใช้ |
void | testStarted ( TestDescription test, long startTime) ทางเลือกอื่นนอกเหนือจาก |
void | testStarted ( TestDescription test) รายงานการเริ่มต้นกรณีทดสอบแต่ละรายการ |
วิธีการป้องกัน | |
---|---|
getListeners () รับรายชื่อผู้ฟัง | |
void | setListeners ( ITestInvocationListener... listeners) ตั้งผู้ฟังหลังการก่อสร้าง |
void | setListeners ( listeners) setListeners ( listeners) ตั้งผู้ฟังหลังการก่อสร้าง |
ผู้สร้างสาธารณะ
ผู้ส่งต่อผลลัพธ์
public ResultForwarder (listeners)
สร้าง ResultForwarder
พารามิเตอร์ | |
---|---|
listeners | ITestInvocationListener ตัวจริงเพื่อส่งต่อผลลัพธ์ไปให้ |
ผู้ส่งต่อผลลัพธ์
public ResultForwarder (ITestInvocationListener... listeners)
ตัวสร้าง arg ตัวแปรสำรองสำหรับ ResultForwarder
พารามิเตอร์ | |
---|---|
listeners | ITestInvocationListener : ITestInvocationListener ของจริงเพื่อส่งต่อผลลัพธ์ไปให้ |
ตัวสร้างที่ได้รับการป้องกัน
ผู้ส่งต่อผลลัพธ์
protected ResultForwarder ()
สร้าง ResultForwarder
ด้วยการตั้งค่าผู้ฟังที่เลื่อนออกไป มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น
วิธีการสาธารณะ
รับบทสรุป
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 : สาเหตุ Throwable ของความล้มเหลว |
เรียกใช้เริ่มต้น
public void invocationStarted (IInvocationContext context)
รายงานการเริ่มต้นการเรียกทดสอบ
จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework ผู้รายงานต้องแทนที่วิธีนี้เพื่อรองรับการรายงานหลายอุปกรณ์
พารามิเตอร์ | |
---|---|
context | IInvocationContext : ข้อมูลเกี่ยวกับการเรียกใช้ |
ทดสอบ สมมติฐาน ความล้มเหลว
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)
จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการดีบักจากการเรียกทดสอบ
ต้องเรียกก่อนERROR(/ITestInvocationListener#invocationFailed(Throwable))
หรือ ERROR(/ITestInvocationListener#invocationEnded(long))
กรอบงาน TradeFederation จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยจัดเตรียมบันทึกโฮสต์และบันทึกอุปกรณ์ (ถ้ามี)พารามิเตอร์ | |
---|---|
dataName | String : ชื่ออธิบาย 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 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 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 : เวลาที่รันเริ่มต้น โดยวัดจาก System.currentTimeMillis() |
ทดสอบ RunStopped
public void testRunStopped (long elapsedTime)
รายงานการทดสอบหยุดทำงานก่อนที่จะเสร็จสิ้นเนื่องจากคำขอของผู้ใช้
สิ่งที่ต้องทำ: ยังไม่ได้ใช้ พิจารณาลบ
พารามิเตอร์ | |
---|---|
elapsedTime | long : อุปกรณ์รายงานเวลาที่ผ่านไป หน่วยเป็นมิลลิวินาที |
เริ่มการทดสอบแล้ว
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() |
เริ่มการทดสอบแล้ว
public void testStarted (TestDescription test)
รายงานการเริ่มต้นกรณีทดสอบแต่ละรายการ อินเทอร์เฟซรุ่นเก่า ควรใช้ testStarted(com.android.tradefed.result.TestDescription)
ทุกครั้งที่ทำได้
พารามิเตอร์ | |
---|---|
test | TestDescription : ระบุการทดสอบ |
วิธีการป้องกัน
รับผู้ฟัง
protectedgetListeners ()
รับรายชื่อผู้ฟัง มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น
ส่งคืน | |
---|---|
รายการ ITestInvocationListener s |
setListener
protected void setListeners (ITestInvocationListener... listeners)
ตั้งผู้ฟังหลังการก่อสร้าง มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น
พารามิเตอร์ | |
---|---|
listeners | ITestInvocationListener : ITestInvocationListener ของจริงเพื่อส่งต่อผลลัพธ์ไปให้ |
setListener
protected void setListeners (listeners)
ตั้งผู้ฟังหลังการก่อสร้าง มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น
พารามิเตอร์ | |
---|---|
listeners | ITestInvocationListener ตัวจริงเพื่อส่งต่อผลลัพธ์ไปให้ |