หน้านี้ได้รับการแปลโดย Cloud Translation API

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`	`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 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` ที่มีข้อมูลเมตาของไฟล์ที่บันทึกไว้