ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
com.android.tradefed.result.ResultForwarder
com.android.tradefed.inviver.ShardMainResultForwarder


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

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

สรุป

ผู้รับเหมาก่อสร้างสาธารณะ

ShardMainResultForwarder ( listeners, int expectedShards) 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) โดยตรง testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้

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

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

public void invocationEnded (long elapsedTime)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

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

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

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

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

context IInvocationContext

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

public void invocationFailed (FailureDescription failure)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

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

public void invocationFailed (Throwable cause)

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

จะถูกเรียกโดยอัตโนมัติโดยกรอบงาน TradeFederation

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

การร้องขอข้ามไป

public void invocationSkipped (SkipReason reason)

รายงานการร้องขอว่าข้ามไป

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

การร้องขอเริ่มต้นแล้ว

public void invocationStarted (IInvocationContext context)

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

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

พารามิเตอร์
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) โดยตรง testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) ไม่สามารถโทรกลับได้ ดังนั้นการเรียกกลับนี้ช่วยให้สามารถระบุการเชื่อมโยงที่แน่นแฟ้นได้อย่างชัดเจน

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

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

ทดสอบ LogForward

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

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

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

dataType LogDataType

dataStream InputStreamSource

testLogบันทึกไว้

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

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

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

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

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

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

logFile LogFile : LogFile ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้