ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.Object
com.android.tradefed.result.proto.ProtoResultReporter


ผู้รายงานผลลัพธ์สร้าง Protobuf TestRecord โดยมีผลลัพธ์ทั้งหมดอยู่ภายใน ควรขยายเพื่อจัดการกับสิ่งที่ต้องทำกับโปรโตสุดท้ายใน processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)

สรุป

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

ProtoResultReporter ()

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

final void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

final void invocationStarted ( IInvocationContext context)

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

final 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 processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

ใช้บันทึกการร้องขอเพื่อส่งบันทึกสุดท้ายของการร้องขอทีละรายการ

void processFinalProto (TestRecordProto.TestRecord finalRecord)

การจัดการกับโปรโตสุดท้ายพร้อมผลลัพธ์ทั้งหมด

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

การจัดการโปรโตบันทึกการทดสอบการร้องขอบางส่วนหลังจาก invocationStarted(com.android.tradefed.invoker.IInvocationContext) เกิดขึ้น

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

การจัดการโปรโตบันทึกกรณีทดสอบสรุปผลหลังจากเกิด ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

การจัดการโปรโตบันทึกกรณีทดสอบบางส่วนหลังจาก testStarted(com.android.tradefed.result.TestDescription, long) เกิดขึ้น

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

การจัดการโปรโตบันทึกโมดูลสรุปผลหลังจากเกิดขึ้น testModuleEnded()

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

การจัดการโปรโตบันทึกโมดูลบางส่วนหลังจาก testModuleStarted(com.android.tradefed.invoker.IInvocationContext) เกิดขึ้น

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

การจัดการโปรโตบันทึกการรันสรุปผลหลังจากเกิด ERROR(/#testRunEnded(long,HashMap))

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

การจัดการโปรโตบันทึกการรันการทดสอบบางส่วนหลังจาก testRunStarted(String, int) เกิดขึ้น

void setGranularResults (boolean granularResults)
void setInlineRecordOfChildren (boolean inline)
boolean supportGranularResults ()

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

final void testAssumptionFailure ( TestDescription test, String trace)

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

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

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

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

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

final void testFailed ( TestDescription test, FailureDescription failure)

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

final void testFailed ( TestDescription test, String trace)

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

final void testIgnored ( TestDescription test)

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

final void testModuleEnded ()

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

final void testModuleStarted ( IInvocationContext moduleContext)

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

final void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

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

final void testRunFailed ( FailureDescription failure)

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

final void testRunFailed (String errorMessage)

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

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

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

final void testRunStarted (String runName, int testCount)

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

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

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

final void testStarted ( TestDescription test, long startTime)

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

final void testStarted ( TestDescription test)

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

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

TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

สร้างการอ้างอิงลูกสำหรับโมดูล

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

ProtoResultReporter

public ProtoResultReporter ()

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

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

public final 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 final void invocationStarted (IInvocationContext context)

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

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

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

สมาคมล็อก

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

กระบวนการ FinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

ใช้บันทึกการร้องขอเพื่อส่งบันทึกสุดท้ายของการร้องขอทีละรายการ

พารามิเตอร์
invocationLogs TestRecordProto.TestRecord : โปรโตสรุปที่แสดงถึงการเรียกใช้

กระบวนการFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

การจัดการกับโปรโตสุดท้ายพร้อมผลลัพธ์ทั้งหมด

พารามิเตอร์
finalRecord TestRecordProto.TestRecord : โปรโตสรุปพร้อมผลลัพธ์การเรียกใช้ทั้งหมด

กระบวนการStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

การจัดการโปรโตบันทึกการทดสอบการร้องขอบางส่วนหลังจาก invocationStarted(com.android.tradefed.invoker.IInvocationContext) เกิดขึ้น

พารามิเตอร์
invocationStartRecord TestRecordProto.TestRecord : โปรโตบางส่วนที่เติมข้อมูลหลังจาก invocationStart

invocationContext IInvocationContext : การร้องขอ IInvocationContext

กระบวนการTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

การจัดการโปรโตบันทึกกรณีทดสอบสรุปผลหลังจากเกิด ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))

พารามิเตอร์
testCaseRecord TestRecordProto.TestRecord : โปรโตสรุปที่แสดงถึงกรณีทดสอบ

กระบวนการTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

การจัดการโปรโตบันทึกกรณีทดสอบบางส่วนหลังจาก testStarted(com.android.tradefed.result.TestDescription, long) เกิดขึ้น

พารามิเตอร์
testCaseStartedRecord TestRecordProto.TestRecord : โปรโตบางส่วนที่แสดงถึงกรณีทดสอบ

กระบวนการทดสอบโมดูลสิ้นสุด

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

การจัดการโปรโตบันทึกโมดูลสรุปผลหลังจากเกิดขึ้น testModuleEnded()

พารามิเตอร์
moduleRecord TestRecordProto.TestRecord : โปรโตสรุปที่เป็นตัวแทนของโมดูล

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

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

การจัดการโปรโตบันทึกโมดูลบางส่วนหลังจาก testModuleStarted(com.android.tradefed.invoker.IInvocationContext) เกิดขึ้น

พารามิเตอร์
moduleStartRecord TestRecordProto.TestRecord : โปรโตบางส่วนที่เป็นตัวแทนของโมดูล

กระบวนการ TestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

การจัดการโปรโตบันทึกการรันสรุปผลหลังจากเกิด ERROR(/#testRunEnded(long,HashMap))

พารามิเตอร์
runRecord TestRecordProto.TestRecord : โปรโตสรุปที่แสดงถึงการวิ่ง

moduleInProgress boolean : แสดงว่าโมดูลกำลังดำเนินการอยู่หรือไม่

กระบวนการ TestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

การจัดการโปรโตบันทึกการรันการทดสอบบางส่วนหลังจาก testRunStarted(String, int) เกิดขึ้น

พารามิเตอร์
runStartedRecord TestRecordProto.TestRecord : โปรโตบางส่วนที่แสดงถึงการวิ่ง

กำหนดผลลัพธ์แบบละเอียด

public void setGranularResults (boolean granularResults)

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

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

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

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

public boolean supportGranularResults ()

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

การส่งคืน
boolean

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

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

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

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

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

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

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

public final 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 final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

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

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

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

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

ทดสอบละเว้น

public final void testIgnored (TestDescription test)

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

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

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

public final void testModuleEnded ()

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

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

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

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

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

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

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

public final 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 final void testStarted (TestDescription test)

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

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

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

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

สร้างการอ้างอิงลูกสำหรับโมดูล

พารามิเตอร์
record TestRecordProto.TestRecord

การส่งคืน
TestRecordProto.ChildReference