ResultDBReporter

public class ResultDBReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
↳	com.android.tradefed.result.resultdb.ResultDBReporter

---

Test sonuçlarını ResultDB'ye yükleyen sonuç raporlayıcı.

Özet

Alanlar
protected IInvocationContext	mContext
protected boolean	mEnableAlTestProperties

Herkese açık oluşturucular
ResultDBReporter()

Herkese açık yöntemler
TestSummary	getSummary() InvocationListener'ın özet döndürmesine izin verir.
void	invocationEnded(long elapsedTime) Çağırmanın başarıyla mı yoksa bir hata durumu nedeniyle mi sonlandırıldığını bildirir.
void	invocationFailed(FailureDescription failure) Bir hata durumu nedeniyle eksik bir çağırma bildirir.
void	invocationFailed(Throwable cause) Bir hata durumu nedeniyle eksik bir çağırma bildirir.
void	invocationSkipped(SkipReason reason) Bir çağırmayı atlandı olarak bildirir.
void	invocationStarted(IInvocationContext context) Test çağrısının başlangıcını bildirir.
boolean	isDisabled()
void	logAssociation(String dataName, LogFile logFile) Bazı durumlarda, günlüğün test senaryolarıyla güçlü bir şekilde ilişkilendirilmesi gerekir ancak doğrudan testLogSaved(String,LogDataType,InputStreamSource,LogFile) geri çağırmada bunu yapmak mümkün değildir.
void	setConfiguration(IConfiguration configuration) Kullanımdaki IConfiguration örneğini ekler.
void	setLogSaver(ILogSaver logSaver) Uygulayıcının dosyaları kaydetmesine izin vermek için ILogSaver ayarını yapın.
boolean	supportGranularResults() Raporlayıcı ayrıntılı sonuçları destekliyorsa True, aksi takdirde False değerini döndürür.
void	testAssumptionFailure(TestDescription test, String trace) Birim testi, yanlış olduğu varsayılan bir koşulu işaretlediğinde çağrılır.
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Birim testi, yanlış olduğu varsayılan bir koşulu işaretlediğinde çağrılır.
void	testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics) Bitiş zamanını doğrudan belirtebileceğimiz testEnded(TestDescription,Map) işlevinin alternatifi.
void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics) Tek bir test senaryosunun yürütülmesinin sonunu bildirir.
void	testFailed(TestDescription test, FailureDescription failure) Tek bir test senaryosunun başarısızlığını bildirir.
void	testFailed(TestDescription test, String trace) Tek bir test senaryosunun başarısızlığını bildirir.
void	testIgnored(TestDescription test) Genellikle bir test yöntemi org.junit.Ignore ile açıklama eklenmiş olduğundan bir test çalıştırılmayacağı zaman çağrılır.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Test çağrısından ilişkili günlük veya hata ayıklama verilerini sağlar.
void	testModuleEnded() Bir modül çalıştırmanın sonunu bildirir.
void	testModuleStarted(IInvocationContext moduleContext) Çalışan bir modülün başlangıcını bildirir.
void	testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics) Test çalıştırmasının sonunu bildirir.
void	testRunFailed(FailureDescription failure) Raporlar, FailureDescription tarafından açıklanan bir hata nedeniyle test çalıştırmasını tamamlayamadı.
void	testRunFailed(String errorMessage) Raporlar test çalıştırması, ölümcül bir hata nedeniyle tamamlanamadı.
void	testRunStarted(String runName, int testCount, int attemptNumber) Test çalıştırmasının başlangıcını bildirir.
void	testRunStarted(String runName, int testCount) Test çalıştırmasının başlangıcını bildirir.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Test çalıştırmasının başlangıcını bildirir.
void	testRunStopped(long elapsedTime) Raporlar, kullanıcı isteği nedeniyle tamamlanmadan önce test çalıştırması durduruldu.
void	testSkipped(TestDescription test, SkipReason reason) Bir test atlandığında ve genellikle beklenmeyen bir nedenle yürütülmediğinde çağrılır.
void	testStarted(TestDescription test, long startTime) Testin ne zaman başlatıldığını da belirttiğimiz testStarted(TestDescription) yerine, doğru ölçüm için testEnded(TestDescription,long,Map) ile birlikte kullanılır.
void	testStarted(TestDescription test) Tek bir test senaryosunun başlangıcını bildirir.
void	uploadStoragePath(String resourceId, String storagePath, LogFile logFile) Bir AnTS test yapay nesnesinin depolama yolunu ResultDB'ye yükler.

Alanlar

mContext

protected IInvocationContext mContext

mEnableAlTestProperties

protected boolean mEnableAlTestProperties

Herkese açık oluşturucular

ResultDBReporter

public ResultDBReporter ()

Herkese açık yöntemler

getSummary

public TestSummary getSummary ()

InvocationListener'ın özet döndürmesine izin verir.

İadeler
TestSummary	Koşuyu özetleyen bir TestSummary veya null

invocationEnded

public void invocationEnded (long elapsedTime)

Çağırmanın başarıyla mı yoksa bir hata durumu nedeniyle mi sonlandırıldığını bildirir.

TradeFederation çerçevesi tarafından otomatik olarak çağrılır.

Parametreler
elapsedTime	long: çağrının geçen süresi (ms)

invocationFailed

public void invocationFailed (FailureDescription failure)

Bir hata durumu nedeniyle eksik bir çağırma bildirir.

TradeFederation çerçevesi tarafından otomatik olarak çağrılır.

Parametreler
failure	FailureDescription: Hatanın nedenini açıklayan FailureDescription

invocationFailed

public void invocationFailed (Throwable cause)

Bir hata durumu nedeniyle eksik bir çağırma bildirir.

TradeFederation çerçevesi tarafından otomatik olarak çağrılır.

Parametreler
cause	Throwable: hatanın Throwable nedeni

invocationSkipped

public void invocationSkipped (SkipReason reason)

Bir çağırmayı atlandı olarak bildirir.

Parametreler
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Test çağrısının başlangıcını bildirir.

TradeFederation çerçevesi tarafından otomatik olarak çağrılır. Raporcuların, birden fazla cihazın raporlamasını desteklemek için bu yöntemi geçersiz kılması gerekir.

Parametreler
context	IInvocationContext: çağrı hakkında bilgiler

isDisabled

public boolean isDisabled ()

İadeler
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Bazı durumlarda, günlüğün test senaryolarıyla güçlü bir şekilde ilişkilendirilmesi gerekir ancak doğrudan testLogSaved(String,LogDataType,InputStreamSource,LogFile) geri çağırmada bunu yapmak mümkün değildir. Bu nedenle, bu geri çağırma, güçlü bir ilişkilendirme sağlamaya olanak tanır.

Parametreler
dataName	String: Verilerin adı
logFile	LogFile: Daha önce kaydedilmiş ve test senaryosuyla ilişkilendirilmesi gereken LogFile.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Kullanımdaki IConfiguration örneğini ekler.

Parametreler
configuration	IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Uygulayıcının dosyaları kaydetmesine izin vermek için ILogSaver ayarını yapın.

Parametreler
logSaver	ILogSaver: ILogSaver

supportGranularResults

public boolean supportGranularResults ()

Raporlayıcı ayrıntılı sonuçları destekliyorsa True, aksi takdirde False değerini döndürür.

İadeler
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Birim testi, yanlış olduğu varsayılan bir koşulu işaretlediğinde çağrılır.

Parametreler
test	TestDescription: Testi tanımlar.
trace	String: Hatayla sonuçlanan yığın izleme

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Birim testi, yanlış olduğu varsayılan bir koşulu işaretlediğinde çağrılır.

Parametreler
test	TestDescription: Testi tanımlar.
failure	FailureDescription: FailureDescription arızayı ve bağlamını açıklayın.

testEnded

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

Bitiş zamanını doğrudan belirtebileceğimiz testEnded(TestDescription,Map) işlevinin alternatifi. Doğru ölçüm için testStarted(TestDescription,long) ile birlikte kullanın.

Parametreler
test	TestDescription: Testi tanımlar.
endTime	long: Testin sona erdiği zaman (System.currentTimeMillis() üzerinden ölçülür)
testMetrics	HashMap: yayınlanan metriklerin Map

testEnded

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

Tek bir test senaryosunun yürütülmesinin sonunu bildirir.

testFailed(TestDescription, FailureDescription) çağrılmadıysa bu test başarılı olur. Ayrıca, test senaryosunun yürütülmesi sırasında yayınlanmış olabilecek tüm anahtar/değer metriklerini de döndürür.

Parametreler
test	TestDescription: Testi tanımlar.
testMetrics	HashMap: yayınlanan metriklerin Map

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Tek bir test senaryosunun başarısızlığını bildirir.

testStarted ve testEnded arasında çağrılır.

Parametreler
test	TestDescription: Testi tanımlar.
failure	FailureDescription: FailureDescription arızayı ve bağlamını açıklayın.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Tek bir test senaryosunun başarısızlığını bildirir.

testStarted ve testEnded arasında çağrılır.

Parametreler
test	TestDescription: Testi tanımlar.
trace	String: Hatayla sonuçlanan yığın izleme

testIgnored

public void testIgnored (TestDescription test)

Genellikle bir test yöntemi org.junit.Ignore ile açıklama eklenmiş olduğundan bir test çalıştırılmayacağı zaman çağrılır.

Parametreler
test	TestDescription: Testi tanımlar.

testLog

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

Test çağrısından ilişkili günlük veya hata ayıklama verilerini sağlar.

ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) veya ERROR(/ITestInvocationListener#invocationEnded(long)) tarihinden önce aranmalıdır.

TradeFederation çerçevesi, bu yöntemi otomatik olarak çağırır ve ana makine günlüğünü, varsa cihaz logcat'ini sağlar.

Parametreler
dataName	String: Verilerin String açıklayıcı adı. Örneğin, "device_logcat". Not dataName, her çağırmada benzersiz olmayabilir. Yani uygulayıcılar, aynı dataName ile birden fazla çağrıyı işleyebilmelidir.
dataType	LogDataType: Verilerin LogDataType
dataStream	InputStreamSource: verilerin InputStreamSource. Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve tamamlandığında sonuçtaki InputStream'i kapattığından emin olmalıdır. Arayanlar, testLog yöntemi tamamlanana kadar veri kaynağının mevcut ve erişilebilir kalmasını sağlamalıdır.

testModuleEnded

public void testModuleEnded ()

Bir modül çalıştırmanın sonunu bildirir.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Çalışan bir modülün başlangıcını bildirir. Bu geri çağırma, testModuleEnded() ile ilişkilidir ve dizide isteğe bağlıdır. Yalnızca modül kullanan bir çalıştırma sırasında kullanılır: pakete dayalı çalıştırıcılar.

Parametreler
moduleContext	IInvocationContext: modülün IInvocationContext.

testRunEnded

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

Test çalıştırmasının sonunu bildirir. DÜZELTİLMESİ GEREKEN YER: Farklı türde iki Map<> arayüzümüz olamaz. Bu nedenle burada HashMap kullanmamız gerekiyor.

Parametreler
elapsedTimeMillis	long: Cihazın bildirdiği geçen süre (milisaniye cinsinden)
runMetrics	HashMap: Metric ile yapılan bir test çalıştırmasının sonunda bildirilen anahtar/değer çiftleri.

testRunFailed

public void testRunFailed (FailureDescription failure)

Raporlar, FailureDescription tarafından açıklanan bir hata nedeniyle test çalıştırmasını tamamlayamadı.

Parametreler
failure	FailureDescription: FailureDescription arızayı ve bağlamını açıklayın.

testRunFailed

public void testRunFailed (String errorMessage)

Raporlar test çalıştırması, ölümcül bir hata nedeniyle tamamlanamadı.

Parametreler
errorMessage	String: Çalıştırma hatasının nedenini açıklayan String.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Test çalıştırmasının başlangıcını bildirir.

Parametreler
runName	String: Test çalıştırmasının adı
testCount	int: test çalıştırmasındaki toplam test sayısı
attemptNumber	int: Aynı runName'in birden fazla kez çalıştırılan farklı denemelerini tanımlayan sipariş numarası. attemptNumber, 0 tabanlıdır ve her yeni çalıştırmada artırılmalıdır. Örneğin, bir test 3 kez ayrıntılı olarak yeniden denenirse aynı runName altında toplam 4 çalıştırma olmalı ve attemptNumber 0 ile 3 arasında olmalıdır.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Test çalıştırmasının başlangıcını bildirir.

Parametreler
runName	String: Test çalıştırmasının adı
testCount	int: test çalıştırmasındaki toplam test sayısı

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Test çalıştırmasının başlangıcını bildirir.

Parametreler
runName	String: Test çalıştırmasının adı
testCount	int: test çalıştırmasındaki toplam test sayısı
attemptNumber	int: Aynı runName'in birden fazla kez çalıştırılan farklı denemelerini tanımlayan sipariş numarası. attemptNumber, 0 tabanlıdır ve her yeni çalıştırmada artırılmalıdır. Örneğin, bir test 3 kez ayrıntılı olarak yeniden denenirse aynı runName altında toplam 4 çalıştırma olmalı ve attemptNumber 0 ile 3 arasında olmalıdır.
startTime	long: Çalıştırmanın başladığı zaman (System.currentTimeMillis() üzerinden ölçülür)

testRunStopped

public void testRunStopped (long elapsedTime)

Raporlar, kullanıcı isteği nedeniyle tamamlanmadan önce test çalıştırması durduruldu.

YAPILACAKLAR: Şu anda kullanılmıyor, kaldırılabilir.

Parametreler
elapsedTime	long: Cihazın bildirdiği geçen süre (milisaniye cinsinden)

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Bir test atlandığında ve genellikle beklenmeyen bir nedenle yürütülmediğinde çağrılır. Bu testler, uygun bir yürütme elde etmek için yeniden denenmeye çalışılacaktır.

Parametreler
test	TestDescription: Testi tanımlar.
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Testin ne zaman başlatıldığını da belirttiğimiz testStarted(TestDescription) yerine, doğru ölçüm için testEnded(TestDescription,long,Map) ile birlikte kullanılır.

Parametreler
test	TestDescription: Testi tanımlar.
startTime	long: Testin başladığı zaman (System.currentTimeMillis() üzerinden ölçülür)

testStarted

public void testStarted (TestDescription test)

Tek bir test senaryosunun başlangıcını bildirir. Eski arayüz, mümkün olduğunda testStarted(TestDescription) kullanılmalıdır.

Parametreler
test	TestDescription: Testi tanımlar.

uploadStoragePath

public void uploadStoragePath (String resourceId, 
                String storagePath, 
                LogFile logFile)

Bir AnTS test yapay nesnesinin depolama yolunu ResultDB'ye yükler.

Bu, AnTS'den ResultDB'ye geçiş için geçici bir çözümdür (bkz. go/convergence-tr). Bu yöntem, bir yapının depolama yolu kullanılabilir hale geldiğinde AnTS muhabiri tarafından çağrılmalıdır.

AnTS muhabiri, yüklediği her yapay nesne için bu yöntemi çağıracağını garanti eder. Bu raporlayıcı da söz konusu tüm yapay nesneleri doğru test ilişkilendirmesiyle ResultDB'ye yükler. Günlüklerin doğru şekilde ilişkilendirilmesi için logAssociation(String,LogFile) işlevinin daha önce aynı kaynak kimliği için çağrılması gerekir. Bu, yapının zaten izlenmesini sağlar. Aksi takdirde, yapay nesne, Tradefed çağrısının üst düzey iş birimiyle ilişkilendirilir.

Bu yöntem, invocationStarted(IInvocationContext)'dan önce çağrılmamalıdır. Bu işlev, üst sistem tarafından yönetilen çağırmalar için invocationEnded(long) sonrasında çağrılabilir. Bunun nedeni, bu çağırmaların bu raporlayıcı tarafından sonlandırılmamasıdır. Bu durum, invocationEnded(long) içinde sonlandırılan yerel olarak oluşturulmuş çağrılar için geçerli değildir.

TODO(b/464941055): AnTS yapıtlarını ResultDB'ye düzgün şekilde taşıyabildiğimizde bu yöntemi kaldırın.

Parametreler
resourceId	String: Yapıtın kaynak kimliği.
storagePath	String: Yapının depolama yolu (ör. /bigstore/ yolu).
logFile	LogFile: Yapıtla ilişkili LogFile nesnesi.