ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
com.android.tradefed.result.CollectingTestListener
com.android.tradefed.invoker.ShardListener


ITestInvocationListener ที่รวบรวมผลลัพธ์จากส่วนแบ่งการร้องขอ (หรือที่เรียกว่าการแบ่งการร้องขอเพื่อเรียกใช้บนทรัพยากรหลายรายการพร้อมกัน) และส่งต่อไปยังผู้ฟังรายอื่น

สรุป

ผู้สร้างสาธารณะ

ShardListener ( ITestInvocationListener main)

สร้าง ShardListener

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

getUnderlyingResultReporter ()
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) ไม่สามารถโทรกลับได้

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

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

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

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

void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

void testModuleEnded ()

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

void testModuleStarted ( IInvocationContext moduleContext)

รายงานการเริ่มต้นโมดูลที่กำลังทำงาน

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

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

void testRunFailed ( FailureDescription failure)

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

void testRunFailed (String failureMessage)

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

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

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

ผู้สร้างสาธารณะ

ShardListener

public ShardListener (ITestInvocationListener main)

สร้าง ShardListener

พารามิเตอร์
main ITestInvocationListener : ITestInvocationListener ควรส่งต่อผลลัพธ์ เพื่อป้องกันการชนกับ ShardListener อื่น ๆ ออบเจ็กต์นี้จะซิงโครไนซ์กับ main เมื่อส่งต่อผลลัพธ์ และผลลัพธ์จะถูกส่งเมื่อส่วนการร้องขอเสร็จสมบูรณ์เท่านั้น

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

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

ส่งคืน

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

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

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

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

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

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

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

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

สนับสนุน GranularResults

public boolean supportGranularResults ()

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

ส่งคืน
boolean

บันทึกการทดสอบ

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

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

ต้องเรียกก่อน ERROR(/ITestInvocationListener#invocationFailed(Throwable)) หรือ ERROR(/ITestInvocationListener#invocationEnded(long))

กรอบงาน TradeFederation จะเรียกใช้เมธอดนี้โดยอัตโนมัติ โดยจัดเตรียมบันทึกโฮสต์และบันทึกอุปกรณ์ (ถ้ามี)

พารามิเตอร์
dataName String : ชื่ออธิบาย ERROR(/String) ของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ คือผู้ดำเนินการต้องสามารถจัดการการโทรหลายรายการด้วย dataName เดียวกันได้

dataType LogDataType : LogDataType ของข้อมูล

dataStream InputStreamSource : InputStreamSource ของข้อมูล Implementers ควรเรียก createInputStream เพื่อเริ่มอ่านข้อมูล และตรวจสอบให้แน่ใจว่าได้ปิด InputStream ที่เป็นผลลัพธ์เมื่อเสร็จสิ้น ผู้โทรควรตรวจสอบให้แน่ใจว่าแหล่งที่มาของข้อมูลยังคงอยู่และสามารถเข้าถึงได้จนกว่าวิธีการ testLog จะเสร็จสมบูรณ์

บันทึกการทดสอบที่บันทึกไว้

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

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

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

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

public void testModuleEnded ()

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

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

public void testModuleStarted (IInvocationContext moduleContext)

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

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

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

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

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

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

public void testRunFailed (FailureDescription failure)

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

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

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

public void testRunFailed (String failureMessage)

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

พารามิเตอร์
failureMessage String : ERROR(/String) อธิบายสาเหตุของความล้มเหลวในการรัน

ทดสอบ RunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

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

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

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

startTime long : เวลาที่รันเริ่มต้น โดยวัดจาก ERROR(/System#currentTimeMillis())