ITestStorageClient

public interface ITestStorageClient

com.google.android.tradefed.result.teststorage.ITestStorageClient

ממשק לתקשורת עם הקצה העורפי של Android Test Storage. הממשק מכיל שיטות ליצירה ולעדכון של קריאות ושל יחידות עבודה, ולהעלאה של תוצאות הבדיקה. כדי ליצור או לעדכן יחידות עבודה או תוצאות בדיקה, הן צריכות להיות שייכות לקריאה לפונקציה שנוצרה על ידי הלקוח הזה, או שהקריאה לפונקציה צריכה להתווסף באמצעות השיטה addInvocation.

סיכום

‫methods ציבוריים

abstract Invocation createInvocation(Invocation invocation)

יוצר הפעלה ב-Test Storage באמצעות הנתונים בהפעלה שסופקה.

abstract Build createLocalBuild(Build localBuild)

הוספת גרסת build מקומית בקצה העורפי.

abstract WorkUnit createWorkUnit(WorkUnit workUnit)

יוצר יחידת עבודה באחסון לבדיקה.

abstract ImmutableList<WorkUnit> createWorkUnits(List<WorkUnit> workUnits)

יוצר את כל יחידות העבודה ברשימה שסופקה ב-TestStorage.

abstract File fetchTestArtifact(String invocationId, String resourceId)

מאחזר ומחזיר את קובץ הארטיפקט של הבדיקה שנדרש.

abstract void finalizeTestResults()

ההמתנה היא עד להעלאת כל תוצאות הבדיקה.

abstract Invocation getInvocation(String invocationId)

מחזירה הפעלה עם מזהה ההפעלה שצוין.

abstract BuildArtifactMetadata getTestArtifact(String invocationId, String resourceId)

מחזירה ארטיפקט של בדיקה שתואם להפעלה ולמזהה המשאב שצוינו.

abstract WorkUnit getWorkUnit(String workUnitId)

מחזירה יחידת עבודה שתואמת למזהה שצוין.

abstract TestArtifactListResponse listTestArtifact(String invocationId, String artifactType)

מבצע חיפוש ומציג רשימה של כל פריטי המידע שנוצרו מבדיקות שתואמים לסוג שצוין.

abstract Invocation updateInvocation(Invocation invocation)

מעדכן קריאה לפונקציה ב-Test Storage באמצעות הנתונים בקריאה לפונקציה שסופקה.

abstract BuildArtifactMetadata updateTestArtifact(String invocationId, String workUnitId, String testResultId, BuildArtifactMetadata artifact, long legacyId)

מעדכן את פריט המידע שסופק.

abstract BuildArtifactMetadata updateTestArtifact(BuildArtifactMetadata artifact, long legacyId, AbstractInputStreamContent content)

מעדכן את הארטיפקט שסופק ומעלה את התוכן שסופק.

abstract WorkUnit updateWorkUnit(WorkUnit workUnit)

עדכון של יחידת עבודה שסופקה באחסון לצורך בדיקה.

abstract void uploadAssociations(List<LogAssociation> associations, int poolSize)

העלאות של שיוכים בין יומנים לבין בדיקות או יחידות עבודה.

abstract void uploadResult(TestResult result)

העלאת תוצאת הבדיקה שסופקה אל Test Storage.

‫methods ציבוריים

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

יוצר הפעלה ב-Test Storage באמצעות הנתונים בהפעלה שסופקה.

פרמטרים
invocation ‫Invocation: – מתאר את הקריאה להפעלה שרוצים ליצור.
החזרות
Invocation קריאה לפונקציה שנוצרה ב-Test Storage.
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

הוספת גרסת build מקומית בקצה העורפי.

פרמטרים
localBuild ‫Build: תיאור של הגרסה המקומית
החזרות
Build Build
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

יוצר יחידת עבודה באחסון לבדיקה.

פרמטרים
workUnit ‫WorkUnit: – מתאר את יחידת העבודה שצריך ליצור.
החזרות
WorkUnit יחידת עבודה חדשה.
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits (List<WorkUnit> workUnits)

יוצר את כל יחידות העבודה ברשימה שסופקה ב-TestStorage.

פרמטרים
workUnits ‫List: - רשימה של יחידות עבודה ליצירה.
החזרות
ImmutableList<WorkUnit> רשימה של יחידות עבודה שנוצרו.
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

מאחזר ומחזיר את קובץ הארטיפקט של הבדיקה שנדרש.

פרמטרים
invocationId String

resourceId String

החזרות
File

הקפצת הודעות שגיאה (throw)
IOException

finalizeTestResults

public abstract void finalizeTestResults ()

ההמתנה היא עד להעלאת כל תוצאות הבדיקה.

getInvocation

public abstract Invocation getInvocation (String invocationId)

מחזירה הפעלה עם מזהה ההפעלה שצוין.

פרמטרים
invocationId ‫String: - המזהה של הקריאה להפעלה שרוצים להחזיר.
החזרות
Invocation

הקפצת הודעות שגיאה (throw)
IOException – אם הקריאה שצוינה לא נמצאה או אם יש שגיאה בתקשורת עם העורף.

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

מחזירה ארטיפקט של בדיקה שתואם להפעלה ולמזהה המשאב שצוינו.

פרמטרים
invocationId String

resourceId String

החזרות
BuildArtifactMetadata

הקפצת הודעות שגיאה (throw)
IOException

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

מחזירה יחידת עבודה שתואמת למזהה שצוין.

פרמטרים
workUnitId ‫String: - מזהה יחידת העבודה.
החזרות
WorkUnit

הקפצת הודעות שגיאה (throw)
IOException – אם יחידת העבודה שצוינה לא נמצאה או אם יש שגיאה בתקשורת עם שירותי העורף.

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

מבצע חיפוש ומציג רשימה של כל פריטי המידע שנוצרו מבדיקות שתואמים לסוג שצוין.

פרמטרים
invocationId String

artifactType String

החזרות
TestArtifactListResponse

הקפצת הודעות שגיאה (throw)
IOException

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

מעדכן קריאה לפונקציה ב-Test Storage באמצעות הנתונים בקריאה לפונקציה שסופקה.

פרמטרים
invocation ‫Invocation: - הפעלה עם נתונים מעודכנים.
החזרות
Invocation קריאה מעודכנת.
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

updateTestArtifact

public abstract BuildArtifactMetadata updateTestArtifact (String invocationId, 
                String workUnitId, 
                String testResultId, 
                BuildArtifactMetadata artifact, 
                long legacyId)

מעדכן את פריט המידע שסופק. השיטה הזו מעדכנת רק את הקישור ולא משנה את התוכן. כשמפעילים את השיטה הזו, צריך לספק את מזהה ההפעלה המקורי, מזהה יחידת העבודה ומזהה תוצאת הבדיקה כארגומנטים. מציבים את יחידת העבודה החדשה ואת מזהה תוצאת הבדיקה באובייקט BuildArtifactMetadata. אם לא נעשה שימוש במזהה יחידת העבודה או בתוצאת הבדיקה בשיוך, צריך להגדיר אותם כמחרוזת ריקה ("").

פרמטרים
invocationId String

workUnitId String

testResultId String

artifact BuildArtifactMetadata

legacyId long

החזרות
BuildArtifactMetadata

הקפצת הודעות שגיאה (throw)
IOException

updateTestArtifact

public abstract BuildArtifactMetadata updateTestArtifact (BuildArtifactMetadata artifact, 
                long legacyId, 
                AbstractInputStreamContent content)

מעדכן את הארטיפקט שסופק ומעלה את התוכן שסופק. כשמעלים תוכן, אי אפשר לעדכן את נתוני השיוך. אל תשנו את מזהה יחידת העבודה ואת מזהה תוצאת הבדיקה שכבר הוגדרו בארגומנט BuildArtifactMetadata.

פרמטרים
artifact BuildArtifactMetadata

legacyId long

content AbstractInputStreamContent

החזרות
BuildArtifactMetadata

הקפצת הודעות שגיאה (throw)
IOException

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

עדכון של יחידת עבודה שסופקה באחסון לצורך בדיקה.

פרמטרים
workUnit ‫WorkUnit: - יחידת עבודה לעדכון.
החזרות
WorkUnit יחידת העבודה עודכנה.
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

uploadAssociations

public abstract void uploadAssociations (List<LogAssociation> associations, 
                int poolSize)

העלאות של שיוכים בין יומנים לבין בדיקות או יחידות עבודה. השיוכים מאפשרים ל-Android Test Storage לעקוב אחרי היומן שנוצר בכל בדיקה.

פרמטרים
associations ‫List: רשימה של קובצי יומן והשיוכים שלהם.
poolSize ‫int: גודל מאגר העובדים שמשמש להעלאה מקבילה. ‫0 אם לא רוצים להשתמש בהעלאה מקבילה.
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

uploadResult

public abstract void uploadResult (TestResult result)

העלאת תוצאת הבדיקה שסופקה אל Test Storage. תוצאת הבדיקה צריכה להיות חלק מקריאה לפונקציה שנוצרה בעבר.

פרמטרים
result ‫TestResult: – התוצאה להעלאה.
הקפצת הודעות שגיאה (throw)
java.io.IOException