ผู้ส่งต่อผลลัพธ์

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.Object
com.android.tradefed.result.ResultForwarder


ITestInvocationListener ที่ส่งต่อผลการร้องขอไปยังรายการ Listener อื่นๆ

สรุป

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

ResultForwarder ( listeners) ResultForwarder ( listeners)

สร้าง ResultForwarder

ResultForwarder ( ITestInvocationListener... listeners)

ตัวสร้าง arg ตัวแปรสำรองสำหรับ ResultForwarder

ตัวสร้างที่ได้รับการป้องกัน

ResultForwarder ()

สร้าง 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)

ทางเลือกแทน 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 testModuleEnded ()

รายงานการสิ้นสุดของการรันโมดูล

void testModuleStarted ( IInvocationContext moduleContext)

รายงานการเริ่มต้นโมดูลที่กำลังทำงาน

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

รายงานการสิ้นสุดการทดสอบการทำงาน

void testRunFailed ( FailureDescription failure)

การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

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)

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

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 : ระบุการทดสอบ

วิธีการป้องกัน

รับผู้ฟัง

protected  getListeners ()

รับรายชื่อผู้ฟัง มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น

ส่งคืน
รายการ ITestInvocationListener s

setListener

protected void setListeners (ITestInvocationListener... listeners)

ตั้งผู้ฟังหลังการก่อสร้าง มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น

พารามิเตอร์
listeners ITestInvocationListener : ITestInvocationListener ของจริงเพื่อส่งต่อผลลัพธ์ไปให้

setListener

protected void setListeners ( listeners)

ตั้งผู้ฟังหลังการก่อสร้าง มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น

พารามิเตอร์
listeners : ITestInvocationListener ตัวจริงเพื่อส่งต่อผลลัพธ์ไปให้