ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
   ↳ com.android.tradefed.result.ResultForwarder
     ↳ com.android.tradefed.invoker.ShardMainResultForwarder

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

คลาสนี้ไม่ปลอดภัยสำหรับเธรด เราคาดว่าไคลเอ็นต์จะล็อกคลาสนี้เมื่อส่งผลการทดสอบเพื่อป้องกันไม่ให้มีการเรียกใช้การเรียกกลับตามลําดับ

สรุป

ตัวสร้างแบบสาธารณะ

ShardMainResultForwarder( listeners, int expectedShards)

สร้าง ShardMainResultForwarder

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

getListeners()

ดูรายชื่อผู้ฟัง

void invocationEnded(long elapsedTime)

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

void invocationEnded(long elapsedTime, IInvocationContext context)

การเรียกกลับที่ละเอียดยิ่งขึ้นเพื่อแยกความแตกต่างว่าข้อมูลส่วนใดเสร็จสิ้นแล้ว

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 testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)

ส่งต่อเฉพาะ testLog แทนที่จะบันทึกบันทึกก่อน

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

เรียกใช้เมื่อบันทึกบันทึกการทดสอบ

ตัวสร้างแบบสาธารณะ

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

สร้าง ShardMainResultForwarder

พารามิเตอร์
listeners : รายการ ITestInvocationListener สำหรับส่งต่อผลลัพธ์เมื่อมีการแบ่งกลุ่มทั้งหมดแล้ว
expectedShards int: จํานวนชาร์ด

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

getListeners

public  getListeners ()

ดูรายชื่อผู้ฟัง มีไว้สำหรับใช้โดยคลาสย่อยเท่านั้น

คิกรีเทิร์น
รายการ ITestInvocationListener

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

การเรียกกลับที่ละเอียดยิ่งขึ้นเพื่อแยกความแตกต่างว่าข้อมูลส่วนใดเสร็จสิ้นแล้ว

พารามิเตอร์
elapsedTime long

context IInvocationContext

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

testLogForward

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

ส่งต่อเฉพาะ testLog แทนที่จะบันทึกบันทึกก่อน

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

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

เรียกใช้เมื่อบันทึกบันทึกการทดสอบ

ควรใช้แทน ITestInvocationListener.testLog(String, LogDataType, InputStreamSource)

พารามิเตอร์
dataName String: String ชื่อที่สื่อความหมายของข้อมูล เช่น "device_logcat" หมายเหตุ dataName อาจไม่ซ้ำกันต่อการเรียกใช้ 1 ครั้ง เช่น ผู้ติดตั้งใช้งานต้องจัดการกับการเรียกใช้หลายครั้งที่มี dataName เดียวกันได้
dataType LogDataType: LogDataType ของข้อมูล
dataStream InputStreamSource: InputStreamSource ของข้อมูล ผู้ใช้งานควรเรียกใช้ createInputStream เพื่อเริ่มอ่านข้อมูล และอย่าลืมปิด InputStream ที่ได้เมื่ออ่านเสร็จแล้ว
logFile LogFile: LogFile ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้