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 invocationSkipped(SkipReason reason)

รายงานการเรียกใช้ว่าข้าม

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) callbacks โดยตรงนั้นไม่สามารถทำได้

void setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

แสดงค่า True หากเครื่องมือรายงานรองรับผลลัพธ์แบบละเอียด หากไม่ แสดงค่า False

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)

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

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 ที่ควรส่งต่อผลลัพธ์ ออบเจ็กต์นี้จะซิงค์ใน main เมื่อส่งต่อผลลัพธ์เพื่อป้องกันไม่ให้มี ShardListener รายการอื่นทับซ้อนกัน และระบบจะส่งผลลัพธ์ก็ต่อเมื่อกลุ่มการเรียกใช้เสร็จสมบูรณ์เท่านั้น

เมธอดสาธารณะ

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

คิกรีเทิร์น

invocationEnded

public void invocationEnded (long elapsedTime)

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

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

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

invocationFailed

public void invocationFailed (FailureDescription failure)

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

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

พารามิเตอร์
failure FailureDescription: FailureDescription ที่อธิบายสาเหตุของการไม่สําเร็จ

invocationFailed

public void invocationFailed (Throwable cause)

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

เฟรมเวิร์ก TradeFederation จะเรียกใช้โดยอัตโนมัติ

พารามิเตอร์
cause Throwable: Throwable สาเหตุของการไม่สําเร็จ

invocationSkipped

public void invocationSkipped (SkipReason reason)

รายงานการเรียกใช้ว่าข้าม

พารามิเตอร์
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

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

supportGranularResults

public boolean supportGranularResults ()

แสดงค่า True หากเครื่องมือรายงานรองรับผลลัพธ์แบบละเอียด หากไม่ แสดงค่า False

คิกรีเทิร์น
boolean

testLog

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 จะเสร็จสมบูรณ์

testLogSaved

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

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

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleEnded

public void testModuleEnded ()

รายงานการสิ้นสุดการเรียกใช้ข้อบังคับ

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

รายงานการเริ่มต้นการทํางานของข้อบังคับ การเรียกกลับนี้เชื่อมโยงกับ testModuleEnded() และสามารถเลือกใช้ในลำดับหรือไม่ก็ได้ จะใช้ในระหว่างการเรียกใช้ที่ใช้ข้อบังคับเท่านั้น ซึ่งก็คือเครื่องมือรันไทม์ที่อิงตามชุด

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String failureMessage)

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

พารามิเตอร์
failureMessage String: String อธิบายสาเหตุของการเรียกใช้ที่ไม่สําเร็จ

testRunStarted

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

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

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

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

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

startTime long: เวลาเริ่มต้นการเรียกใช้ ซึ่งวัดผ่าน System.currentTimeMillis()