CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener

ITestInvocationListener ที่จะรวบรวมผลการทดสอบทั้งหมด

แม้ว่าโครงสร้างข้อมูลที่ใช้ในออบเจ็กต์นี้จะปลอดภัยต่อการทำงานแบบหลายเธรด แต่ต้องเรียกใช้แฮนเดิล ITestInvocationListener ตามลำดับที่ถูกต้อง

สรุป

เครื่องมือสร้างสาธารณะ

CollectingTestListener()

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

IBuildInfo getBuildInfo()

เลิกใช้เมธอดนี้แล้ว ต้องพึ่งพา IBuildInfo จาก getInvocationContext()

TestRunResult getCurrentRunResults()

รับผลลัพธ์สำหรับการทดสอบที่กำลังดำเนินการ

int getExpectedTests()

แสดงผลจำนวนการทดสอบที่คาดไว้

IInvocationContext getInvocationContext()

แสดงบริบทการเรียกใช้ที่รายงานผ่าน invocationStarted(IInvocationContext)

List<TestRunResult> getMergedTestRunResults()

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

IInvocationContext getModuleContextForRunResult(String testRunName)

แสดงผล IInvocationContext ของโมดูลที่เชื่อมโยงกับผลลัพธ์

MultiMap<String, LogFile> getModuleLogFiles()

ส่งคืนสำเนาของแผนที่ที่มีไฟล์ที่บันทึกทั้งหมดซึ่งเชื่อมโยงกับโมดูล

MultiMap<String, LogFile> getNonAssociatedLogFiles()

ส่งคืนสำเนาของแผนที่ที่มีไฟล์ที่บันทึกทั้งหมดซึ่งไม่ได้เชื่อมโยงกับการทดสอบหรือโมดูล

int getNumAllFailedTestRuns()

แสดงผลจำนวนการทดสอบทั้งหมดที่อยู่ในสถานะล้มเหลว

int getNumAllFailedTests()

แสดงผลจำนวนการทดสอบทั้งหมดที่อยู่ในสถานะล้มเหลว (เฉพาะที่ล้มเหลวเท่านั้น การล้มเหลวของสมมติฐานจะไม่นับรวม)

int getNumTestsInState(TestStatus status)

แสดงผลจำนวนการทดสอบในสถานะที่ระบุสำหรับการเรียกใช้นี้

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

เพื่อความเข้ากันได้กับประเภทสถานะรุ่นเก่า

int getNumTotalTests()

แสดงผลจำนวนการทดสอบที่เสร็จสมบูรณ์ทั้งหมดสำหรับการเรียกใช้ทั้งหมด

IBuildInfo getPrimaryBuildInfo()

แสดงข้อมูลบิลด์หลักที่รายงานผ่าน invocationStarted(IInvocationContext)

Collection<TestRunResult> getRunResults()

เลิกใช้เมธอดนี้แล้ว ใช้ getMergedTestRunResults()

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

ส่ง TestRunResult กลับมาเพื่อลองอีกครั้ง

int getTestRunAttemptCount(String testRunName)

แสดงผลจำนวนครั้งที่พยายามสำหรับชื่อการทดสอบที่ระบุ

List<TestRunResult> getTestRunAttempts(String testRunName)

รับความพยายามทั้งหมดสำหรับ TestRunResult ของการทดสอบที่ระบุ

List<TestRunResult> getTestRunForAttempts(int attempt)

รับผลลัพธ์ทั้งหมดสำหรับการพยายามที่ระบุ

Collection<String> getTestRunNames()

แสดงชื่อทั้งหมดสำหรับการทดสอบทั้งหมด

boolean hasFailedTests()

แสดงผลหากการเรียกใช้มีการทดสอบที่ล้มเหลวหรือการทดสอบที่ล้มเหลวเนื่องจากสมมติฐาน

boolean hasTestRunResultsForName(String testRunName)

แสดงผลว่าชื่อการทดสอบที่ระบุมีผลลัพธ์หรือไม่

void invocationEnded(long elapsedTime)

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

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

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

void invocationStarted(IInvocationContext context)

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

boolean isDisabled()

แสดงค่า True หากปิดใช้ออบเจ็กต์ทั้งหมด (ข้ามทั้งการตั้งค่าและการล้างข้อมูล)

void logAssociation(String dataName, LogFile logFile)

ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างใกล้ชิด แต่ไม่สามารถดำเนินการดังกล่าวในtestLogSaved(String,LogDataType,InputStreamSource,LogFile) การเรียกกลับโดยตรงได้

void setBuildInfo(IBuildInfo buildInfo)

เลิกใช้เมธอดนี้แล้ว ไม่จำเป็นต้องใช้ในการทดสอบอีกต่อไป

void setDisable(boolean isDisabled)

กำหนดว่าควรปิดใช้วัตถุหรือไม่

void setMergeStrategy(MergeStrategy strategy)

ตั้งค่า MergeStrategy ที่จะใช้เมื่อผสานผลลัพธ์

void testAssumptionFailure(TestDescription test, String trace)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ

void testAssumptionFailure(TestDescription test, FailureDescription failure)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ

void testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

ทางเลือกแทน testEnded(TestDescription,Map) ซึ่งเราสามารถระบุเวลาสิ้นสุด ได้โดยตรง

void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)

รายงานจุดสิ้นสุดของการดำเนินการของกรณีทดสอบแต่ละรายการ

void testFailed(TestDescription test, FailureDescription failure)

รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ

void testFailed(TestDescription test, String trace)

รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ

void testIgnored(TestDescription test)

เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore

void testModuleEnded()

รายงานการสิ้นสุดการเรียกใช้โมดูล

void testModuleStarted(IInvocationContext moduleContext)

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

void testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)

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

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String errorMessage)

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

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

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

void testRunStarted(String name, int numTests)

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

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

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

void testRunStopped(long elapsedTime)

การทดสอบรายงานหยุดก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้

void testSkipped(TestDescription test, SkipReason reason)

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

void testStarted(TestDescription test, long startTime)

ทางเลือกแทน testStarted(TestDescription) ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ ร่วมกับ testEnded(TestDescription,long,Map) เพื่อการวัดที่แม่นยำ

void testStarted(TestDescription test)

รายงานจุดเริ่มต้นของกรณีทดสอบแต่ละรายการ

วิธีการที่ได้รับการป้องกัน

final void clearModuleLogFiles()

ช่วยให้ล้างไฟล์โมดูลได้เพื่อไม่ให้ไฟล์เหล่านี้ค้างอยู่นานเกินไป

final void clearResultsForName(String testRunName)

ช่วยให้ล้างผลลัพธ์สำหรับชื่อการเรียกใช้ที่ระบุได้

final void clearTestRunResults()

ช่วยให้ล้างผลการทดสอบทั้งหมดได้เพื่อไม่ให้เก็บผลการทดสอบไว้นานเกินไป

void setIsAggregrateMetrics(boolean aggregate)

สลับตัวเลือก "เมตริกโดยรวม"

เครื่องมือสร้างสาธารณะ

CollectingTestListener

public CollectingTestListener ()

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

getBuildInfo

public IBuildInfo getBuildInfo ()

เลิกใช้เมธอดนี้แล้ว
ใช้ IBuildInfo จาก getInvocationContext()

แสดงข้อมูลการสร้าง

การคืนสินค้า
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

รับผลลัพธ์สำหรับการทดสอบที่กำลังดำเนินการ

โปรดทราบว่าผลลัพธ์อาจไม่สมบูรณ์ เราขอแนะนําให้ทดสอบค่าของ TestRunResult.isRunComplete() และ/หรือ (@link TestRunResult#isRunFailure()} ตามความเหมาะสม ก่อนประมวลผลผลลัพธ์

การคืนสินค้า
TestRunResult TestRunResult แสดงข้อมูลที่รวบรวมระหว่างการทดสอบครั้งล่าสุด

getExpectedTests

public int getExpectedTests ()

แสดงผลจำนวนการทดสอบที่คาดไว้ อาจแตกต่างจาก getNumTotalTests() หาก การทดสอบบางรายการไม่ได้ทำงาน

การคืนสินค้า
int

getInvocationContext

public IInvocationContext getInvocationContext ()

แสดงบริบทการเรียกใช้ที่รายงานผ่าน invocationStarted(IInvocationContext)

การคืนสินค้า
IInvocationContext

getMergedTestRunResults

public List<TestRunResult> getMergedTestRunResults ()

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

หากมีผลการทดสอบหลายรายการ ระบบจะผสานรวมการทดสอบแต่ละครั้ง โดยผลการทดสอบล่าสุด จะเขียนทับผลการทดสอบของการทดสอบครั้งก่อนๆ ระบบจะจัดเรียงการทดสอบตามหมายเลขการทดสอบ

ระบบจะผสานเมตริกสําหรับความพยายามเดียวกันตามค่ากําหนดที่ aggregate-metrics ตั้งไว้ เมตริกสุดท้ายจะเป็นเมตริกของความพยายามครั้งสุดท้าย

การคืนสินค้า
List<TestRunResult>

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

แสดงผล IInvocationContext ของโมดูลที่เชื่อมโยงกับผลลัพธ์

พารามิเตอร์
testRunName String: ชื่อที่ {testRunStarted(String,int) ระบุ
การคืนสินค้า
IInvocationContext IInvocationContext ของโมดูลสำหรับชื่อการทดสอบที่ระบุ null หากไม่มีผลลัพธ์สำหรับชื่อนั้น

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

ส่งคืนสำเนาของแผนที่ที่มีไฟล์ที่บันทึกทั้งหมดซึ่งเชื่อมโยงกับโมดูล

การคืนสินค้า
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

ส่งคืนสำเนาของแผนที่ที่มีไฟล์ที่บันทึกทั้งหมดซึ่งไม่ได้เชื่อมโยงกับการทดสอบหรือโมดูล

การคืนสินค้า
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

แสดงผลจำนวนการทดสอบทั้งหมดที่อยู่ในสถานะล้มเหลว

การคืนสินค้า
int

getNumAllFailedTests

public int getNumAllFailedTests ()

แสดงผลจำนวนการทดสอบทั้งหมดที่อยู่ในสถานะล้มเหลว (เฉพาะที่ล้มเหลวเท่านั้น การล้มเหลวของสมมติฐานจะไม่นับรวม)

การคืนสินค้า
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

แสดงผลจำนวนการทดสอบในสถานะที่ระบุสำหรับการเรียกใช้นี้

พารามิเตอร์
status TestStatus

การคืนสินค้า
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

เพื่อความเข้ากันได้กับประเภทสถานะรุ่นเก่า

พารามิเตอร์
ddmlibStatus TestResult.TestStatus

การคืนสินค้า
int

getNumTotalTests

public int getNumTotalTests ()

แสดงผลจำนวนการทดสอบที่เสร็จสมบูรณ์ทั้งหมดสำหรับการเรียกใช้ทั้งหมด

การคืนสินค้า
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

แสดงข้อมูลบิลด์หลักที่รายงานผ่าน invocationStarted(IInvocationContext) บิลด์หลักคือบิลด์ที่ผู้ให้บริการบิลด์รายแรก ของการกำหนดค่าที่กำลังทำงานส่งคืน แสดงผลเป็น Null หากไม่มีบริบท (ไม่มีบิลด์สำหรับกรณีทดสอบ)

การคืนสินค้า
IBuildInfo

getRunResults

public Collection<TestRunResult> getRunResults ()

เลิกใช้เมธอดนี้แล้ว
ใช้ getMergedTestRunResults()

แสดงผลลัพธ์สำหรับการทดสอบทั้งหมด

การคืนสินค้า
Collection<TestRunResult>

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

ส่ง TestRunResult เพื่อลองอีกครั้ง

พารามิเตอร์
testRunName String: ชื่อที่ {testRunStarted(String,int) ระบุ
attempt int: รหัสความพยายาม
การคืนสินค้า
TestRunResult TestRunResult สำหรับชื่อและรหัสการพยายามที่ระบุ หรือ null หากไม่มี

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

แสดงผลจำนวนครั้งที่พยายามสำหรับชื่อการทดสอบที่ระบุ

พารามิเตอร์
testRunName String: ชื่อที่ {testRunStarted(String,int) ระบุ
การคืนสินค้า
int

getTestRunAttempts

public List<TestRunResult> getTestRunAttempts (String testRunName)

รับความพยายามทั้งหมดสำหรับ TestRunResult ของการทดสอบที่ระบุ

พารามิเตอร์
testRunName String: ชื่อที่ {testRunStarted(String,int) ระบุ
การคืนสินค้า
List<TestRunResult> TestRunResult ทั้งหมดสำหรับการทดสอบที่กำหนด โดยเรียงตามความพยายาม

getTestRunForAttempts

public List<TestRunResult> getTestRunForAttempts (int attempt)

รับผลลัพธ์ทั้งหมดสำหรับการพยายามที่ระบุ

พารามิเตอร์
attempt int: ความพยายามที่เราต้องการผลลัพธ์
การคืนสินค้า
List<TestRunResult> TestRunResult ทั้งหมดสำหรับการพยายามครั้งหนึ่งๆ

getTestRunNames

public Collection<String> getTestRunNames ()

แสดงชื่อทั้งหมดสำหรับการทดสอบทั้งหมด

การทดสอบเหล่านี้อาจทำงานหลายครั้งโดยมีการพยายามที่แตกต่างกัน

การคืนสินค้า
Collection<String>

hasFailedTests

public boolean hasFailedTests ()

แสดงผลหากการเรียกใช้มีการทดสอบที่ล้มเหลวหรือการทดสอบที่ล้มเหลวเนื่องจากสมมติฐาน

การคืนสินค้า
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

แสดงผลว่าชื่อการทดสอบที่ระบุมีผลลัพธ์หรือไม่

พารามิเตอร์
testRunName String: ชื่อที่ {testRunStarted(String,int) ระบุ
การคืนสินค้า
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

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: ข้อมูลเกี่ยวกับการเรียกใช้

isDisabled

public boolean isDisabled ()

แสดงค่า True หากปิดใช้ออบเจ็กต์ทั้งหมด (ข้ามทั้งการตั้งค่าและการล้างข้อมูล) มิเช่นนั้นจะเป็น "เท็จ"

การคืนสินค้า
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

ในบางกรณี บันทึกต้องเชื่อมโยงกับกรณีทดสอบอย่างใกล้ชิด แต่ไม่สามารถดำเนินการดังกล่าวในtestLogSaved(String,LogDataType,InputStreamSource,LogFile) การเรียกกลับโดยตรงได้ ดังนั้น Callback นี้จึงช่วยให้เชื่อมโยงได้อย่างชัดเจน

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

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

เลิกใช้เมธอดนี้แล้ว
ไม่จำเป็นสำหรับการทดสอบอีกต่อไป

ตั้งค่าข้อมูลบิลด์ ควรใช้สำหรับการทดสอบเท่านั้น

พารามิเตอร์
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

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

พารามิเตอร์
isDisabled boolean: สถานะที่ควรตั้งค่าออบเจ็กต์

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

ตั้งค่า MergeStrategy ที่จะใช้เมื่อผสานผลลัพธ์

พารามิเตอร์
strategy MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
trace String: สแต็กเทรซของความล้มเหลว

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

เรียกใช้เมื่อการทดสอบแบบอะตอมแจ้งว่ามีการสมมติเงื่อนไขที่เป็นเท็จ

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
failure FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

ทางเลือกแทน testEnded(TestDescription,Map) ซึ่งเราสามารถระบุเวลาสิ้นสุด ได้โดยตรง รวมกับ testStarted(TestDescription,long) เพื่อการวัดที่แม่นยำ

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
endTime long: เวลาที่การทดสอบสิ้นสุดลง ซึ่งวัดผ่าน System.currentTimeMillis()
testMetrics HashMap: Map ของเมตริกที่ปล่อยออกมา

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

รายงานจุดสิ้นสุดของการดำเนินการของกรณีทดสอบแต่ละรายการ

หากไม่ได้เรียกใช้ testFailed(TestDescription, FailureDescription) การทดสอบนี้จะผ่าน นอกจากนี้ยังแสดงผลเมตริกคีย์/ค่า ที่อาจมีการปล่อยออกมาในระหว่างการดำเนินการของกรณีทดสอบด้วย

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
testMetrics HashMap: Map ของเมตริกที่ปล่อยออกมา

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ

จะเรียกใช้ระหว่าง testStarted และ testEnded

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
failure FailureDescription: FailureDescription อธิบายความล้มเหลวและบริบทของความล้มเหลวนั้น

testFailed

public void testFailed (TestDescription test, 
                String trace)

รายงานความล้มเหลวของกรณีทดสอบแต่ละรายการ

จะเรียกใช้ระหว่าง testStarted และ testEnded

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
trace String: สแต็กเทรซของความล้มเหลว

testIgnored

public void testIgnored (TestDescription test)

เรียกใช้เมื่อจะไม่ทำการทดสอบ โดยทั่วไปเนื่องจากมีการใส่คำอธิบายประกอบเมธอดทดสอบด้วย org.junit.Ignore

พารามิเตอร์
test TestDescription: ระบุการทดสอบ

testModuleEnded

public void testModuleEnded ()

รายงานการสิ้นสุดการเรียกใช้โมดูล

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

รายงานสิ้นสุดการทดสอบ FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

พารามิเตอร์
elapsedTime long: อุปกรณ์รายงานเวลาที่ผ่านไปเป็นมิลลิวินาที
runMetrics HashMap: คู่คีย์-ค่าที่รายงานเมื่อสิ้นสุดการทดสอบด้วย Metric

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

พารามิเตอร์
errorMessage String: String อธิบายเหตุผลที่การเรียกใช้ล้มเหลว

testRunStarted

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

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

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

testRunStarted

public void testRunStarted (String name, 
                int numTests)

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

พารามิเตอร์
name String: ชื่อการทดสอบ
numTests int: จำนวนการทดสอบทั้งหมดในการทดสอบ

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()

testRunStopped

public void testRunStopped (long elapsedTime)

การทดสอบรายงานหยุดก่อนที่จะเสร็จสมบูรณ์เนื่องจากคำขอของผู้ใช้

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

ทางเลือกแทน testStarted(TestDescription) ซึ่งเรายังระบุเวลาที่เริ่มการทดสอบ ร่วมกับ testEnded(TestDescription,long,Map) เพื่อการวัดที่แม่นยำ

พารามิเตอร์
test TestDescription: ระบุการทดสอบ
startTime long: เวลาที่การทดสอบเริ่มต้น วัดผ่าน System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

รายงานจุดเริ่มต้นของกรณีทดสอบแต่ละรายการ อินเทอร์เฟซรุ่นเก่าควรใช้ testStarted(TestDescription) เมื่อเป็นไปได้

พารามิเตอร์
test TestDescription: ระบุการทดสอบ

วิธีการที่ได้รับการป้องกัน

clearModuleLogFiles

protected final void clearModuleLogFiles ()

ช่วยให้ล้างไฟล์โมดูลได้เพื่อไม่ให้ไฟล์เหล่านี้ค้างอยู่นานเกินไป

clearResultsForName

protected final void clearResultsForName (String testRunName)

ช่วยให้ล้างผลลัพธ์สำหรับชื่อการเรียกใช้ที่ระบุได้ ควรใช้ในบางกรณีเท่านั้น เช่น ผู้รวบรวมผลลัพธ์

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

clearTestRunResults

protected final void clearTestRunResults ()

ช่วยให้ล้างผลการทดสอบทั้งหมดได้เพื่อไม่ให้เก็บผลการทดสอบไว้นานเกินไป

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

สลับตัวเลือก "เมตริกรวม"

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