SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

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

ใช้ ITestInvocationListener เพื่อระบุเป็น result_reporter และส่งต่อจากกระบวนการย่อยผลลัพธ์ของการทดสอบ การรันการทดสอบ การเรียกใช้การทดสอบ

สรุป

ผู้รับเหมาก่อสร้างสาธารณะ

SubprocessResultsReporter ()

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

void close ()

TestSummary getSummary ()

อนุญาตให้ InvocationListener ส่งคืนข้อมูลสรุป

void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationStarted ( IInvocationContext context)

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

void logAssociation (String dataName, LogFile logFile)

ในบางกรณี บันทึกจะต้องเชื่อมโยงอย่างมากกับกรณีทดสอบ แต่มีโอกาสที่จะทำเช่นนั้นใน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) โดยตรง testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้

void printEvent (String key, Object event)

ตัวช่วยในการพิมพ์คีย์เหตุการณ์แล้วตามด้วยวัตถุ json

void setOutputTestLog (boolean outputTestLog)

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

boolean supportGranularResults ()

ส่งคืน True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด หากไม่ใช่จะเป็นเท็จ

void testAssumptionFailure ( TestDescription testId, String trace)

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

void testAssumptionFailure ( TestDescription testId, FailureDescription failure)

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

void testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics)

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

void testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics)

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

void testFailed ( TestDescription testId, FailureDescription failure)

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

void testFailed ( TestDescription testId, String reason)

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

void testIgnored ( TestDescription testId)

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

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

จัดเตรียมบันทึกที่เกี่ยวข้องหรือข้อมูลการแก้ไขข้อบกพร่องจากการเรียกใช้การทดสอบ

void testModuleEnded ()

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

void testModuleStarted ( IInvocationContext moduleContext)

รายงานจุดเริ่มต้นของโมดูลที่ทำงานอยู่

void testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics)

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

void testRunFailed ( FailureDescription failure)

รายงานการทดสอบการทำงานล้มเหลวที่จะเสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

void testRunFailed (String reason)

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

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

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

void testStarted ( TestDescription testId, long startTime)

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

void testStarted ( TestDescription testId)

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

ผู้รับเหมาก่อสร้างสาธารณะ

SubprocessResultsReporter

public SubprocessResultsReporter ()

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

ปิด

public void close ()

รับสรุป

public TestSummary getSummary ()

อนุญาตให้ InvocationListener ส่งคืนข้อมูลสรุป

การส่งคืน
TestSummary TestSummary สรุปการรันหรือเป็นโมฆะ

การร้องขอสิ้นสุดแล้ว

public void invocationEnded (long elapsedTime)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

การร้องขอล้มเหลว

public void invocationFailed (FailureDescription failure)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

การร้องขอล้มเหลว

public void invocationFailed (Throwable cause)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

การร้องขอเริ่มต้นแล้ว

public void invocationStarted (IInvocationContext context)

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

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

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

สมาคมล็อก

public void logAssociation (String dataName, 
                LogFile logFile)

ในบางกรณี บันทึกจะต้องเชื่อมโยงอย่างมากกับกรณีทดสอบ แต่มีโอกาสที่จะทำเช่นนั้นใน testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) โดยตรง testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้ ดังนั้นการเรียกกลับนี้ช่วยให้สามารถระบุการเชื่อมโยงที่แน่นแฟ้นได้อย่างชัดเจน

พารามิเตอร์
dataName String : ชื่อของข้อมูล

logFile LogFile : LogFile ที่ถูกบันทึกไว้ก่อนหน้านี้และควรเชื่อมโยงกับกรณีทดสอบ

งานพิมพ์

public void printEvent (String key, 
                Object event)

ตัวช่วยในการพิมพ์คีย์เหตุการณ์แล้วตามด้วยวัตถุ json

พารามิเตอร์
key String

event Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

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

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

สนับสนุนผลลัพธ์แบบละเอียด

public boolean supportGranularResults ()

ส่งคืน True หากผู้รายงานสนับสนุนผลลัพธ์แบบละเอียด หากไม่ใช่จะเป็นเท็จ

การส่งคืน
boolean

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

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

trace String : การติดตามสแต็กของความล้มเหลว

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

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

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

failure FailureDescription : FailureDescription ที่อธิบายความล้มเหลวและบริบทของมัน

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

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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

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

endTime long : เวลาที่การทดสอบสิ้นสุด วัดผ่าน System.currentTimeMillis()

metrics : ERROR(/Map) ของตัวชี้วัดที่ปล่อยออกมา

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

public void testEnded (TestDescription testId, 
                 metrics)

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

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

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

metrics : ERROR(/Map) ของตัวชี้วัดที่ปล่อยออกมา

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

public void testFailed (TestDescription testId, 
                FailureDescription failure)

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

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

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

failure FailureDescription : FailureDescription ที่อธิบายความล้มเหลวและบริบทของมัน

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

public void testFailed (TestDescription testId, 
                String reason)

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

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

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

reason String : การติดตามสแต็กของความล้มเหลว

ทดสอบละเว้น

public void testIgnored (TestDescription testId)

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

พารามิเตอร์
testId 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 ()

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

ทดสอบโมดูลเริ่มต้นแล้ว

public void testModuleStarted (IInvocationContext moduleContext)

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

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

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

public void testRunEnded (long time, 
                 runMetrics)

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

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

runMetrics : คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบการทำงานด้วย Metric

testRunFailed

public void testRunFailed (FailureDescription failure)

รายงานการทดสอบการทำงานล้มเหลวที่จะเสร็จสมบูรณ์เนื่องจากความล้มเหลวที่อธิบายโดย FailureDescription

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

testRunFailed

public void testRunFailed (String reason)

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

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

ทดสอบ RunStarted

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

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

พารามิเตอร์
runName String : ชื่อการทดสอบการทำงาน

testCount int : จำนวนการทดสอบทั้งหมดในการทดสอบ

attemptNumber int : หมายเลขคำสั่งซื้อ ระบุความพยายามที่แตกต่างกันของ runName เดียวกันที่ทำงานหลายครั้ง tryNumber ได้รับการจัดทำดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองซ้ำแบบละเอียด 3 ครั้ง โดยควรมีการทดสอบทั้งหมด 4 ครั้งภายใต้ชื่อ runName เดียวกัน และหมายเลขความพยายามคือตั้งแต่ 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 เดียวกันที่ทำงานหลายครั้ง tryNumber ได้รับการจัดทำดัชนีเป็น 0 และควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองซ้ำแบบละเอียด 3 ครั้ง โดยควรมีการทดสอบทั้งหมด 4 ครั้งภายใต้ชื่อ runName เดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3

startTime long : เวลาที่รันเริ่มต้น วัดผ่าน System.currentTimeMillis()

testRunStopped

public void testRunStopped (long arg0)

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

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

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

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

public void testStarted (TestDescription testId, 
                long startTime)

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

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

startTime long : เวลาที่เริ่มการทดสอบ วัดผ่าน System.currentTimeMillis()

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

public void testStarted (TestDescription testId)

รายงานการเริ่มต้นของกรณีทดสอบแต่ละรายการ อินเทอร์เฟซรุ่นเก่า ควรใช้ testStarted(com.android.tradefed.result.TestDescription) ทุกครั้งที่เป็นไปได้

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