ProtoResultReporter

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

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


ผู้รายงานผลลัพธ์สร้างโปรโตบัฟ 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) ไม่สามารถโทรกลับได้

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 framework

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

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

public void invocationFailed (FailureDescription failure)

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

จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework

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

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

public void invocationFailed (Throwable cause)

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

จะถูกเรียกใช้โดยอัตโนมัติโดย TradeFederation framework

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

เรียกใช้เริ่มต้น

public final void invocationStarted (IInvocationContext context)

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

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

พารามิเตอร์
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) ไม่สามารถโทรกลับได้ ดังนั้น การเรียกกลับนี้ช่วยให้สามารถเชื่อมโยงอย่างชัดเจนได้

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

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

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

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

พารามิเตอร์
invocationLogs TestRecordProto.TestRecord : โปรโตที่สรุปแล้วซึ่งเป็นตัวแทนของการเรียก

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

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

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

processStartInvocation

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

การจัดการโปรโตเร็กคอร์ดการทดสอบการเรียกใช้บางส่วนหลังจากเกิด invocationStarted(com.android.tradefed.invoker.IInvocationContext)

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

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 : โปรโตที่สรุปแล้วซึ่งเป็นตัวแทนของโมดูล

processTestModuleStarted

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 : โปรโตบางส่วนที่แสดงถึงการรัน

setGranularResults

public void setGranularResults (boolean granularResults)

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

setInlineRecordOfChild

public void setInlineRecordOfChildren (boolean inline)

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

สนับสนุน GranularResults

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 : เวลาที่การทดสอบสิ้นสุดลง โดยวัดจาก ERROR(/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)

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

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

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

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

public final void testRunFailed (FailureDescription failure)

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

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

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

public final void testRunFailed (String errorMessage)

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

พารามิเตอร์
errorMessage String : ERROR(/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 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 เดียวกันที่เรียกใช้หลายครั้ง จำนวนความพยายามเป็น 0 จัดทำดัชนีและควรเพิ่มขึ้นทุกครั้งที่มีการเรียกใช้ใหม่ เช่น การทดสอบมีการลองใหม่แบบละเอียด 3 ครั้ง ควรมีการรันทั้งหมด 4 ครั้งภายใต้ชื่อรันเดียวกัน และหมายเลขความพยายามคือตั้งแต่ 0 ถึง 3

startTime long : เวลาที่รันเริ่มต้น โดยวัดจาก ERROR(/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 : เวลาที่การทดสอบเริ่มต้น โดยวัดจาก ERROR(/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