تجزیه‌کننده‌ی GTestResult

public class GTestResultParser
extends MultiLineReceiver

شیء جاوا
↳ com.android.ddmlib.MultiLineReceiver
↳ com.android.tradefed.testtype.GTestResultParser

نتایج «حالت خروجی خام» تست‌های بومی با استفاده از GTest که از پوسته اجرا می‌شوند را تجزیه می‌کند و نتایج را به ITestInvocationListener اطلاع می‌دهد.

قالب نمونه خروجی مورد انتظار:

 [==========] Running 15 tests from 1 test case.
 [----------] Global test environment set-up.
 [----------] 15 tests from MessageTest
 [ RUN      ] MessageTest.DefaultConstructor
 [       OK ] MessageTest.DefaultConstructor (1 ms)
 [ RUN      ] MessageTest.CopyConstructor
 external/gtest/test/gtest-message_test.cc:67: Failure
 Value of: 5
 Expected: 2
 external/gtest/test/gtest-message_test.cc:68: Failure
 Value of: 1 == 1
 Actual: true
 Expected: false
 [  FAILED  ] MessageTest.CopyConstructor (2 ms)
  ...
 [ RUN      ] MessageTest.DoesNotTakeUpMuchStackSpace
 [       OK ] MessageTest.DoesNotTakeUpMuchStackSpace (0 ms)
 [----------] 15 tests from MessageTest (26 ms total)

 [----------] Global test environment tear-down
 [==========] 15 tests from 1 test case ran. (26 ms total)
 [  PASSED  ] 6 tests.
 [  FAILED  ] 9 tests, listed below:
 [  FAILED  ] MessageTest.CopyConstructor
 [  FAILED  ] MessageTest.ConstructsFromCString
 [  FAILED  ] MessageTest.StreamsCString
 [  FAILED  ] MessageTest.StreamsNullCString
 [  FAILED  ] MessageTest.StreamsString
 [  FAILED  ] MessageTest.StreamsStringWithEmbeddedNUL
 [  FAILED  ] MessageTest.StreamsNULChar
 [  FAILED  ] MessageTest.StreamsInt
 [  FAILED  ] MessageTest.StreamsBasicIoManip
 9 FAILED TESTS

که در آن از تگ‌های زیر برای نشان دادن رویدادهای خاص استفاده می‌شود:

 [==========]: the first occurrence indicates a new run started, including the number of tests
                  to be expected in this run
 [ RUN      ]: indicates a new test has started to run; a series of zero or more lines may
                  follow a test start, and will be captured in case of a test failure or error
 [       OK ]: the preceding test has completed successfully, optionally including the time it
                  took to run (in ms)
 [  FAILED  ]: the preceding test has failed, optionally including the time it took to run (in ms)
 [==========]: the preceding test run has completed, optionally including the time it took to run
                  (in ms)
تمام خطوط دیگر نادیده گرفته می‌شوند.

خلاصه

سازندگان عمومی

GTestResultParser (String testRunName, listeners)

GTestResultParser را ایجاد می‌کند.

GTestResultParser (String testRunName, listeners, boolean allowRustTestName)

GTestResultParser را ایجاد می‌کند.

روش‌های عمومی

void cancel ()

درخواست لغو اجرای آزمایشی را دارد.

void done ()

وقتی جلسه adb کامل شد، توسط والد فراخوانی می‌شود.

getFailedTests ()

لیستی از تست‌هایی که در طول اجرای تست فعلی ناموفق بوده‌اند را برمی‌گرداند.

boolean getPrependFileName ()
boolean isCancelled ()

اگر اجرای تست لغو شود، مقدار true را برمی‌گرداند.

boolean isTestRunIncomplete ()

اینکه آیا اجرای آزمایشی ناقص بوده یا خیر.

void processNewLines (String[] lines)

زمانی فراخوانی می‌شود که خطوط جدید توسط فرآیند راه دور دریافت می‌شوند.

void setPrependFileName (boolean prepend)

روش‌های محافظت‌شده

boolean isUnexpectedTestFound ()

برای تست واحد در معرض نمایش قرار داده شده است.

سازندگان عمومی

تجزیه‌کننده‌ی GTestResult 

public GTestResultParser (String testRunName, 
                 listeners)

GTestResultParser را ایجاد می‌کند.

پارامترها
testRunName String : نام اجرای آزمایشی که باید به ITestLifeCycleReceiver.testRunStarted(String, int) ارائه شود.

listeners : همزمان با اجرای تست‌ها، از نتایج تست مطلع می‌شود

تجزیه‌کننده‌ی GTestResult 

public GTestResultParser (String testRunName, 
                 listeners, 
                boolean allowRustTestName)

GTestResultParser را ایجاد می‌کند.

پارامترها
testRunName String : نام اجرای آزمایشی که باید به ITestLifeCycleReceiver.testRunStarted(String, int) ارائه شود.

listeners : همزمان با اجرای تست‌ها، از نتایج تست مطلع می‌شود

allowRustTestName boolean : اجازه می‌دهد نام تست‌ها از الگوی جداسازی '::' پیروی نکنند.

روش‌های عمومی

لغو 

public void cancel ()

درخواست لغو اجرای آزمایشی را دارد.

انجام شده 

public void done ()

وقتی جلسه adb کامل شد، توسط والد فراخوانی می‌شود.

دریافت تست‌های ناموفق 

public  getFailedTests ()

لیستی از تست‌هایی که در طول اجرای تست فعلی ناموفق بوده‌اند را برمی‌گرداند.

بازگشت‌ها

دریافت نام فایل 

public boolean getPrependFileName ()

بازگشت‌ها
boolean

لغو شد 

public boolean isCancelled ()

اگر اجرای تست لغو شود، مقدار true را برمی‌گرداند.

بازگشت‌ها
boolean

همچنین ببینید:

isTestRun ناتمام 

public boolean isTestRunIncomplete ()

اینکه آیا اجرای آزمایشی ناقص بوده یا خیر.

بازگشت‌ها
boolean درست است، اگر اجرای آزمایشی به دلیل مشکلات تجزیه یا خرابی‌ها ناقص بوده باشد.

پردازش‌های جدید 

public void processNewLines (String[] lines)

زمانی فراخوانی می‌شود که خطوط جدید توسط فرآیند راه دور دریافت می‌شوند.

تضمین می‌شود که خطوط وقتی به این روش داده می‌شوند، کامل باشند.

پارامترها
lines String : آرایه‌ای که شامل خطوط جدید است.

تنظیم نام فایل (setPrependFileName) 

public void setPrependFileName (boolean prepend)

پارامترها
prepend boolean

روش‌های محافظت‌شده

isUnexpectedTestFound 

protected boolean isUnexpectedTestFound ()

برای تست واحد در معرض نمایش قرار داده شده است.

بازگشت‌ها
boolean