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) ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างมาก แต่มีโอกาสที่จะทำเช่นนั้นใน |
void | processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) ใช้บันทึกการร้องขอเพื่อส่งบันทึกสุดท้ายของการร้องขอทีละรายการ |
void | processFinalProto (TestRecordProto.TestRecord finalRecord) การจัดการโปรโตขั้นสุดท้ายพร้อมผลลัพธ์ทั้งหมด |
void | processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) การจัดการโปรโตเร็กคอร์ดการทดสอบการเรียกใช้บางส่วนหลังจากเกิด |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) การจัดการโปรโตเรกคอร์ดกรณีทดสอบที่สรุปผลหลังจากเกิด |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) การจัดการโปรโตเรกคอร์ดกรณีทดสอบบางส่วนหลังจากเกิด |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) การจัดการโปรโตเร็กคอร์ดโมดูลที่สรุปผลหลังจากเกิด |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) มีการจัดการโปรโตเร็กคอร์ดโมดูลบางส่วนหลังจากเกิด |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) การจัดการโปรโตเรกคอร์ดการรันที่สิ้นสุดหลังจากเกิด |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) การจัดการโปรโตเรกคอร์ดการเรียกใช้การทดสอบบางส่วนหลังจากเกิด |
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) ทางเลือกแทน |
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) การรันการทดสอบรายงานล้มเหลวเนื่องจากความล้มเหลวที่อธิบายโดย |
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) ทางเลือกอื่นนอกเหนือจาก |
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 |