เครื่องมือส่งต่อผลลัพธ์

public class ResultForwarder
extends Object implements ITestInvocationListener

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

ITestInvocationListener ที่ส่งต่อผลลัพธ์การเรียกใช้ไปยังรายชื่อ Listener คนอื่นๆ

สรุป

ช่างก่อสร้างสาธารณะ

ResultForwarder( listeners)

สร้าง ResultForwarder

ResultForwarder(ITestInvocationListener... listeners)

ตัวสร้างอาร์กิวเมนต์ของตัวแปรสำรองสำหรับ ResultForwarder

เครื่องมือสร้างที่มีการป้องกัน

ResultForwarder()

สร้าง ResultForwarder ที่มีการตั้งค่า Listener ที่มีการเลื่อนเวลา

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

TestSummary getSummary()

อนุญาตให้ InvocationListener แสดงผลสรุปได้

void invocationEnded(long elapsedTime)

รายงานว่าคำขอสิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเนื่องจากข้อผิดพลาดบางอย่าง

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

รายงานการเรียกใช้ว่าข้าม

void invocationStarted(IInvocationContext context)

รายงานจุดเริ่มต้นของการเรียกใช้การทดสอบ

void testAssumptionFailure(TestDescription test, String trace)

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

void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

void testEnded(TestDescription test, long endTime, testMetrics)

ใช้แทน ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) ที่เราสามารถระบุเวลาสิ้นสุดได้ โดยตรง

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

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

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 testSkipped(TestDescription test, SkipReason reason)

มีการเรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่ไม่คาดคิด

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)

กำหนด Listener หลังการสร้าง

void setListeners( listeners)

กำหนด Listener หลังการสร้าง

ช่างก่อสร้างสาธารณะ

เครื่องมือส่งต่อผลลัพธ์

public ResultForwarder ( listeners)

สร้าง ResultForwarder

พารามิเตอร์
listeners : ITestInvocationListener จริงที่จะส่งต่อผลลัพธ์ไปยัง

เครื่องมือส่งต่อผลลัพธ์

public ResultForwarder (ITestInvocationListener... listeners)

ตัวสร้างอาร์กิวเมนต์ของตัวแปรสำรองสำหรับ ResultForwarder

พารามิเตอร์
listeners ITestInvocationListener: ITestInvocationListener จริงที่จะส่งต่อผลลัพธ์ไปยัง

เครื่องมือสร้างที่มีการป้องกัน

เครื่องมือส่งต่อผลลัพธ์

protected ResultForwarder ()

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

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

getสรุป

public TestSummary getSummary ()

อนุญาตให้ InvocationListener แสดงผลสรุปได้

คิกรีเทิร์น
TestSummary TestSummary สรุปการเรียกใช้หรือ Null

สิ้นสุดการเรียกใช้

public void invocationEnded (long elapsedTime)

รายงานว่าคำขอสิ้นสุดลงแล้ว ไม่ว่าจะสำเร็จหรือเนื่องจากข้อผิดพลาดบางอย่าง

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

พารามิเตอร์
elapsedTime long: เวลาที่ผ่านไปของการเรียกใช้ หน่วยเป็นมิลลิวินาที

การเรียกใช้ล้มเหลว

public void invocationFailed (FailureDescription failure)

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

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

พารามิเตอร์
failure FailureDescription: FailureDescription ที่อธิบายสาเหตุของความล้มเหลว

การเรียกใช้ล้มเหลว

public void invocationFailed (Throwable cause)

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

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation

พารามิเตอร์
cause Throwable: สาเหตุ Throwable ของความล้มเหลว

ข้ามการเรียกใช้

public void invocationSkipped (SkipReason reason)

รายงานการเรียกใช้ว่าข้าม

พารามิเตอร์
reason SkipReason

เริ่มคำขอแล้ว

public void invocationStarted (IInvocationContext context)

รายงานจุดเริ่มต้นของการเรียกใช้การทดสอบ

จะถูกเรียกโดยอัตโนมัติโดยเฟรมเวิร์ก TradeFederation ผู้รายงานต้องลบล้าง เพื่อรองรับการรายงานอุปกรณ์หลายเครื่อง

พารามิเตอร์
context IInvocationContext: ข้อมูลเกี่ยวกับคำขอ

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

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 จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยมอบบันทึกของโฮสต์ และ Logcat ของอุปกรณ์ (หากมี)

พารามิเตอร์
dataName String: ชื่อที่สื่อความหมายถึง String ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจซ้ำกันต่อการเรียกใช้ คือผู้ติดตั้งใช้งานจะต้องสามารถ การโทรหลายครั้งโดยใช้ dataName เดียวกัน
dataType LogDataType: LogDataType ของข้อมูล
dataStream InputStreamSource: InputStreamSource ของข้อมูล ผู้ปฏิบัติงานควรโทรติดต่อ createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบว่าได้ปิด InputStream เมื่อเสร็จสมบูรณ์ ผู้โทรควรตรวจสอบว่าแหล่งข้อมูลยังคงอยู่ ปรากฏและเข้าถึงได้จนกว่าเมธอด testLog จะเสร็จสมบูรณ์

โมดูลทดสอบสิ้นสุดแล้ว

public void testModuleEnded ()

รายงานเมื่อสิ้นสุดการเรียกใช้โมดูล

testModuleStarted แล้ว

public void testModuleStarted (IInvocationContext moduleContext)

รายงานช่วงเริ่มต้นของโมดูลที่ทำงานอยู่ Callback นี้เชื่อมโยงกับ testModuleEnded() และไม่บังคับในลำดับ โดยจะใช้ระหว่างการวิ่งที่ใช้ โมดูล: โปรแกรมวิ่งชุดโปรแกรม

พารามิเตอร์
moduleContext IInvocationContext: IInvocationContext ของโมดูล

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

public void testRunEnded (long elapsedTime, 
                 runMetrics)

สิ้นสุดการทดสอบรายงาน แก้ไข: เราไม่สามารถมีแผนที่ 2 แบบ<> ที่มีอินเทอร์เฟซหลายประเภท ดังนั้น เราต้องใช้ HashMap ตรงนี้

พารามิเตอร์
elapsedTime long: เวลาที่อุปกรณ์รายงานเป็นมิลลิวินาทีที่ผ่านไป
runMetrics : คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบด้วย Metric

testRunFailed

public void testRunFailed (FailureDescription failure)

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

พารามิเตอร์
failure FailureDescription: FailureDescription ที่อธิบายความล้มเหลวและบริบท

testRunFailed

public void testRunFailed (String errorMessage)

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

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

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

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

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

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

public void testRunStarted (String runName, 
                int testCount)

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

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

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

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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

พารามิเตอร์
runName String: ชื่อการดำเนินการทดสอบ
testCount int: จำนวนการทดสอบทั้งหมดในการทดสอบ
attemptNumber int: หมายเลขคำสั่งซื้อ ซึ่งระบุความพยายามที่แตกต่างกันของ RunName เดียวกัน ซึ่งทำงานหลายครั้ง ค่าความพยายามNumber เป็น 0 และควรเพิ่มขึ้นทุกครั้งที่ การเรียกใช้ใหม่จะเกิดขึ้น เช่น ทำการทดสอบแบบละเอียด 3 ครั้ง ควรมีการเรียกใช้ทั้งหมด 4 ครั้ง ภายใต้ RunName เดียวกัน และ TryNumber มีค่าตั้งแต่ 0 ถึง 3
startTime long: เวลาที่การเรียกใช้เริ่มต้น ซึ่งวัดผ่าน System.currentTimeMillis()

หยุดการทดสอบแล้ว

public void testRunStopped (long elapsedTime)

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

สิ่งที่ต้องทำ: ยังไม่ได้ใช้ในขณะนี้ ลองพิจารณาลบ

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

ข้ามการทดสอบแล้ว

public void testSkipped (TestDescription test, 
                SkipReason reason)

มีการเรียกใช้เมื่อข้ามการทดสอบและไม่ได้ดำเนินการด้วยเหตุผลที่ไม่คาดคิด จากนั้นจะดำเนินการทดสอบอีกครั้งเพื่อให้ดำเนินการได้อย่างถูกต้อง

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

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

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

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

getListener

protected  getListeners ()

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

คิกรีเทิร์น
รายการ ITestInvocationListener

setListener

protected void setListeners (ITestInvocationListener... listeners)

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

พารามิเตอร์
listeners ITestInvocationListener: ITestInvocationListener จริงที่จะส่งต่อผลลัพธ์ไปยัง

setListener

protected void setListeners ( listeners)

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

พารามิเตอร์
listeners : ITestInvocationListener จริงที่จะส่งต่อผลลัพธ์ไปยัง