IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

Lưu giữ thông tin về Invocation để các kiểm thử truy cập nếu cần. Các bài kiểm thử không được sửa đổi ngữ cảnh có trong đây, vì vậy, chỉ các getter mới có sẵn, ngoại trừ các thuộc tính ngữ cảnh cho mục đích báo cáo.

Tóm tắt

Hằng số

String INVOCATION_ID

Khoá dùng để lưu trữ mã nhận dạng lệnh gọi được liên kết.

Phương thức công khai

abstract void addAllocatedDevice(Map<String, ITestDevice> deviceWithName)

Theo dõi bản đồ tên thiết bị cấu hình được liên kết với ITestDevice.

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

Thêm ITestDevice để siêu dữ liệu theo dõi khi thiết bị được phân bổ.

abstract void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

Thêm một IBuildInfo để được theo dõi bằng tên cấu hình thiết bị.

abstract void addInvocationAttribute(String attributeName, String attributeValue)

Thêm một thuộc tính Lời gọi.

abstract void addInvocationAttributes(MultiMap<String, String> attributesMap)

Thêm nhiều thuộc tính lời gọi cùng một lúc thông qua UniqueMultiMap.

default void addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)

Thêm chỉ số thời gian gọi.

abstract void addSerialsFromShard(Integer index, List<String> serials)

Thêm một số sê-ri cần theo dõi khi được chỉ định cho một trong các phân đoạn đang chạy một số kiểm thử.

default String getAttribute(String key)

Một phương thức thuận tiện để truy xuất thuộc tính ngữ cảnh lời gọi dưới dạng một cặp khoá-giá trị duy nhất.

abstract MultiMap<String, String> getAttributes()

Trả về bản sao của bản đồ chứa tất cả các thuộc tính lệnh gọi.

abstract IBuildInfo getBuildInfo(String deviceName)

Trả về IBuildInfo được liên kết với tên cấu hình thiết bị đã cung cấp.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Trả về IBuildInfo được liên kết với ITestDevice

abstract String getBuildInfoName(IBuildInfo info)

Trả về tên của tập hợp thiết bị trong cấu hình xml từ IBuildInfo.

abstract List<IBuildInfo> getBuildInfos()

Trả về tất cả IBuildInfo được theo dõi cho lệnh gọi này.

abstract ConfigurationDescriptor getConfigurationDescriptor()

Trả về giá trị mô tả được liên kết với cấu hình kiểm thử đã khởi chạy lệnh gọi

abstract ITestDevice getDevice(String deviceName)

Trả về ITestDevice được liên kết với tên cấu hình thiết bị đã cung cấp.

abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

Trả về bản đồ của mối liên kết Thông tin thiết bị/bản dựng

abstract ITestDevice getDeviceBySerial(String serial)

Trả về ITestDevice được liên kết với số sê-ri đã cung cấp.

abstract List<String> getDeviceConfigNames()

Trả về danh sách tên cấu hình thiết bị của thiết bị được theo dõi trong lệnh gọi này

abstract String getDeviceName(ITestDevice device)

Trả về tên của tập hợp thiết bị trong cấu hình xml từ ITestDevice.

abstract List<ITestDevice> getDevices()

Trả về tất cả thiết bị được phân bổ được theo dõi cho lời gọi này.

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

Trả về bản đồ chứa các chỉ số về thời gian gọi.

abstract IInvocationContext getModuleInvocationContext()

Trả về ngữ cảnh gọi của mô-đun trong khi được thực thi như một phần của bộ.

abstract int getNumDevicesAllocated()

Trả về số lượng thiết bị được phân bổ cho lời gọi.

abstract List<String> getSerials()

Trả về danh sách số sê-ri của thiết bị được theo dõi trong lệnh gọi này

abstract Map<Integer, List<String>> getShardsSerials()

Trả về Bản đồ của tất cả các số sê-ri được theo dõi và phân đoạn của chúng có liên quan đến việc phân đoạn.

abstract String getTestTag()

Trả về thẻ kiểm thử lệnh gọi.

abstract void markReleasedEarly()

Đánh dấu các thiết bị được phát hành sớm.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

Đặt giá trị mô tả được liên kết với cấu hình kiểm thử đã khởi chạy lệnh gọi

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

Đặt ngữ cảnh gọi của mô-đun trong khi được thực thi như một phần của bộ.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

Đặt RecoveryMode cho tất cả các thiết bị thuộc ngữ cảnh

abstract void setTestTag(String testTag)

Đặt thẻ kiểm thử lệnh gọi.

abstract InvocationContext.Context toProto()

Tuần tự hoá phiên bản ngữ cảnh thành một protobuf.

abstract boolean wasReleasedEarly()

Trả về thông tin về việc các thiết bị có được phát hành sớm hay không và sẽ không được sử dụng nữa.

Hằng số

INVOCATION_ID

public static final String INVOCATION_ID

Khoá dùng để lưu trữ mã nhận dạng lệnh gọi được liên kết.

Giá trị không đổi: "invocation-id"

Phương thức công khai

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

Theo dõi bản đồ tên thiết bị cấu hình được liên kết với ITestDevice. Không xoá thông tin theo dõi trước đó trước khi thêm.

Tham số
deviceWithName Map: Map của thiết bị bổ sung cần theo dõi

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Thêm ITestDevice để siêu dữ liệu theo dõi khi thiết bị được phân bổ. sẽ đặt thông tin bản dựng thành giá trị rỗng trong bản đồ.

Tham số
deviceName String: tên cấu hình thiết bị cần liên kết với ITestDevice
testDevice ITestDevice: được thêm vào các thiết bị được phân bổ.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Thêm một IBuildInfo để được theo dõi bằng tên cấu hình thiết bị.

Tham số
deviceName String: tên cấu hình thiết bị
buildinfo IBuildInfo: một IBuildInfo được liên kết với tên cấu hình thiết bị.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Thêm một thuộc tính Lời gọi.

Tham số
attributeName String

attributeValue String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

Thêm nhiều thuộc tính lời gọi cùng một lúc thông qua UniqueMultiMap.

Tham số
attributesMap MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

Thêm chỉ số thời gian gọi.

Tham số
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                List<String> serials)

Thêm một số sê-ri cần theo dõi khi được chỉ định cho một trong các phân đoạn đang chạy một số kiểm thử.

Tham số
index Integer: chỉ mục của phân đoạn bằng cách sử dụng số sê-ri
serials List: Danh sách các số sê-ri cần theo dõi.

getAttribute

public String getAttribute (String key)

Một phương thức thuận tiện để truy xuất thuộc tính ngữ cảnh lời gọi dưới dạng một cặp khoá-giá trị duy nhất. Không bao giờ trả về giá trị rỗng.

Tham số
key String

Giá trị trả về
String chuỗi trống khi khoá không tồn tại, nếu không thì giá trị.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Trả về bản sao của bản đồ chứa tất cả các thuộc tính lệnh gọi.

Giá trị trả về
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Trả về IBuildInfo được liên kết với tên cấu hình thiết bị đã cung cấp. Trả về giá trị rỗng nếu không tìm thấy deviceName.

Tham số
deviceName String

Giá trị trả về
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Trả về IBuildInfo được liên kết với ITestDevice

Tham số
testDevice ITestDevice

Giá trị trả về
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Trả về tên của tập hợp thiết bị trong cấu hình xml từ IBuildInfo. Trả về giá trị rỗng nếu không thể so khớp IBuildInfo

Tham số
info IBuildInfo

Giá trị trả về
String

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Trả về tất cả IBuildInfo được theo dõi cho lệnh gọi này.

Giá trị trả về
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Trả về giá trị mô tả được liên kết với cấu hình kiểm thử đã khởi chạy lệnh gọi

Giá trị trả về
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Trả về ITestDevice được liên kết với tên cấu hình thiết bị đã cung cấp.

Tham số
deviceName String

Giá trị trả về
ITestDevice

getDeviceBuildMap

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Trả về bản đồ mối liên kết Thông tin thiết bị/bản dựng

Giá trị trả về
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Trả về ITestDevice được liên kết với số sê-ri đã cung cấp. Không nên sử dụng quá nhiều vì đây không phải là cách tra cứu nhanh nhất.

Tham số
serial String

Giá trị trả về
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

Trả về danh sách tên cấu hình thiết bị của thiết bị được theo dõi trong lệnh gọi này

Giá trị trả về
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Trả về tên của tập hợp thiết bị trong cấu hình xml từ ITestDevice. Trả về giá trị rỗng nếu ITestDevice không thể được so khớp.

Tham số
device ITestDevice

Giá trị trả về
String

getDevices

public abstract List<ITestDevice> getDevices ()

Trả về tất cả thiết bị được phân bổ được theo dõi cho lời gọi này.

Giá trị trả về
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

Giá trị trả về
String mã nhận dạng lệnh gọi được liên kết hoặc null nếu không được liên kết với một lệnh gọi

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

Trả về bản đồ chứa các chỉ số về thời gian gọi.

Giá trị trả về
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Trả về ngữ cảnh gọi của mô-đun trong khi được thực thi như một phần của bộ.

Giá trị trả về
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

Trả về số lượng thiết bị được phân bổ cho lời gọi.

Giá trị trả về
int

getSerials

public abstract List<String> getSerials ()

Trả về danh sách số sê-ri của thiết bị được theo dõi trong lệnh gọi này

Giá trị trả về
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

Trả về Bản đồ của tất cả các số sê-ri được theo dõi và phân đoạn của chúng có liên quan đến việc phân đoạn. Để trống nếu không phải là một lệnh gọi được phân đoạn.

Giá trị trả về
Map<Integer, List<String>>

getTestTag

public abstract String getTestTag ()

Trả về thẻ kiểm thử lệnh gọi.

Giá trị trả về
String

markReleasedEarly

public abstract void markReleasedEarly ()

Đánh dấu các thiết bị được phát hành sớm.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Đặt giá trị mô tả được liên kết với cấu hình kiểm thử đã khởi chạy lệnh gọi

Tham số
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Đặt ngữ cảnh gọi của mô-đun trong khi được thực thi như một phần của bộ.

Tham số
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Đặt RecoveryMode cho tất cả các thiết bị thuộc ngữ cảnh

Tham số
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Đặt thẻ kiểm thử lệnh gọi.

Tham số
testTag String

toProto

public abstract InvocationContext.Context toProto ()

Tuần tự hoá phiên bản ngữ cảnh thành một protobuf.

Giá trị trả về
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Trả về thông tin về việc các thiết bị có được phát hành sớm hay không và sẽ không được sử dụng nữa.

Giá trị trả về
boolean