ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

java.lang.Object
   ↳ com.android.tradefed.config.ConfigurationFactory

Nhà máy để tạo IConfiguration.

Tóm tắt

Lớp lồng ghép

class ConfigurationFactory.ConfigLoader

Triển khai IConfigDefLoader theo dõi các cấu hình được đưa vào từ một cấu hình gốc và đưa ra một ngoại lệ đối với các cấu hình bao gồm theo vòng tròn. 

class ConfigurationFactory.ExceptionLoader

 

Hàm khởi tạo được bảo vệ

ConfigurationFactory()

Phương thức công khai

void clearMapConfig()

Trong một số trường hợp cụ thể, chúng ta cần xoá bản đồ.

IConfiguration createConfigurationFromArgs(String[] arrayArgs, List<String> unconsumedArgs, IKeyStoreClient keyStoreClient)

Tạo IConfiguration từ các đối số dòng lệnh bằng một kho khoá.

IConfiguration createConfigurationFromArgs(String[] arrayArgs, List<String> unconsumedArgs)

Tạo IConfiguration từ các đối số dòng lệnh.

IConfiguration createConfigurationFromArgs(String[] arrayArgs)

Một phương thức tiện lợi gọi createConfigurationFromArgs(String[],List) bằng đối số thứ hai null.

IGlobalConfiguration createGlobalConfigurationFromArgs(String[] arrayArgs, List<String> remainingArgs)

Tạo IGlobalConfiguration từ các đối số dòng lệnh.

IConfiguration createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, Set<String> allowedObjects, TradefedDelegator delegator)

Tạo một cấu hình chỉ chứa một nhóm các đối tượng đã chọn.

void dumpConfig(String configName, PrintStream out)

Kết xuất nội dung của cấu hình vào PrintStream đã cho

List<String> getConfigList(String subPath, boolean loadFromEnv)

Biến thể của getConfigList(), trong đó bạn có thể chỉ định xem chúng ta có muốn tải cấu hình từ môi trường hay không.

List<String> getConfigList()

Trả về danh sách tên của tất cả các cấu hình có trong JAR trên đường dẫn lớp.

static IConfigurationFactory getInstance()

Lấy thực thể singleton IConfigurationFactory.

void loadAllConfigs(boolean discardExceptions)

Tải tất cả cấu hình có trong các thư mục đường dẫn lớp và trường hợp kiểm thử.

void loadAndPrintAllConfigs()

Phương thức tiện ích kiểm tra xem tất cả cấu hình có thể được tải, phân tích cú pháp và đặt tất cả các giá trị tuỳ chọn hay không.

void printHelp(PrintStream out)

In đầu ra trợ giúp cho nhà máy này.

void printHelpForConfig(String[] args, boolean importantOnly, PrintStream out)

In đầu ra trợ giúp cho IConfiguration được chỉ định trong đối số dòng lệnh,

Nếu "args" đề cập đến một cấu hình đã biết, thì một đối tượng IConfiguration sẽ được tạo từ XML và nội dung trợ giúp cho IConfiguration đó sẽ được xuất ra.

Phương thức được bảo vệ

InputStream getBundledConfigStream(String name)
String getConfigPrefix()

Trả về tiền tố đường dẫn của các tệp xml cấu hình trên đường dẫn lớp

Được hiển thị để kiểm thử đơn vị có thể mô phỏng.

BufferedInputStream getConfigStream(String name)

Tải InputStream cho tên cấu hình đã cho

ConfigurationDef getConfigurationDef(String name, boolean isGlobal, Map<String, String> templateMap)

Truy xuất ConfigurationDef cho tên đã cho

Map<ConfigurationFactory.ConfigId, ConfigurationDef> getMapConfig()

Được hiển thị để kiểm thử.

boolean isDirectConfiguration(String configName)
String[] reorderArgs(String[] args)

Sắp xếp lại các đối số sao cho tất cả đối số template:map đều được chuyển lên đầu.

IRemoteFileResolver.ResolvedFile resolveRemoteFile(URI configURI, URI destDir)

Hàm khởi tạo được bảo vệ

ConfigurationFactory

protected ConfigurationFactory ()

Phương thức công khai

clearMapConfig

public void clearMapConfig ()

Trong một số trường hợp cụ thể, chúng ta cần xoá bản đồ.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                List<String> unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

Tạo IConfiguration từ các đối số dòng lệnh bằng một kho khoá.

Định dạng dự kiến là "CONFIG [options]", trong đó CONFIG là tên cấu hình tích hợp hoặc đường dẫn tệp đến tệp xml cấu hình.

Tham số
arrayArgs String: đối số dòng lệnh
unconsumedArgs List: một Danh sách sẽ được điền sẵn các đối số mà Đối tượng được liên kết với cấu hình đã chỉ định không sử dụng. Nếu đây là null, thì quá trình triển khai sẽ gửi ConfigurationException nếu vẫn còn đối số chưa được xử lý.
keyStoreClient IKeyStoreClient: một IKeyStoreClient được dùng để lấy thông tin nhạy cảm trong các đối số.
Giá trị trả về
IConfiguration IConfiguration đã tải. Các trường đối tượng uỷ quyền Option đã được điền các giá trị trong args.
Gửi
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                List<String> unconsumedArgs)

Tạo IConfiguration từ các đối số dòng lệnh.

Định dạng dự kiến là "CONFIG [options]", trong đó CONFIG là tên cấu hình tích hợp hoặc đường dẫn tệp đến tệp xml cấu hình.

Tham số
arrayArgs String: đối số dòng lệnh
unconsumedArgs List: một Danh sách sẽ được điền sẵn các đối số mà Đối tượng được liên kết với cấu hình đã chỉ định không sử dụng. Nếu đây là null, thì quá trình triển khai sẽ gửi ConfigurationException nếu vẫn còn đối số chưa được xử lý.
Giá trị trả về
IConfiguration IConfiguration đã tải. Các trường đối tượng uỷ quyền Option đã được điền các giá trị trong args.
Gửi
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Một phương thức tiện lợi gọi createConfigurationFromArgs(String[],List) bằng đối số thứ hai null. Do đó, phương thức này sẽ gửi ConfigurationException nếu vẫn còn đối số chưa được sử dụng.

Tham số
arrayArgs String

Giá trị trả về
IConfiguration

Gửi
ConfigurationException

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                List<String> remainingArgs)

Tạo IGlobalConfiguration từ các đối số dòng lệnh.

Định dạng dự kiến là "CONFIG [options]", trong đó CONFIG là tên cấu hình tích hợp hoặc đường dẫn tệp đến tệp xml cấu hình.

Tham số
arrayArgs String: đối số dòng lệnh
remainingArgs List: một danh sách sẽ được điền sẵn các đối số chưa được xử lý dưới dạng đối số chung
Giá trị trả về
IGlobalConfiguration IGlobalConfiguration đã tải. Các trường đối tượng uỷ quyền Option đã được điền sẵn các giá trị trong args.
Gửi
ConfigurationException

createPartialConfigurationFromArgs

public IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                Set<String> allowedObjects, 
                TradefedDelegator delegator)

Tạo một cấu hình chỉ chứa một nhóm các đối tượng đã chọn.

Tham số
arrayArgs String: Đối số dòng lệnh
keyStoreClient IKeyStoreClient: Một IKeyStoreClient được dùng để lấy thông tin nhạy cảm trong các đối số.
allowedObjects Set: Tập hợp các đối tượng được phép tạo
delegator TradefedDelegator

Giá trị trả về
IConfiguration IConfiguration đã tải.
Gửi
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

Kết xuất nội dung của cấu hình vào PrintStream đã cho

Tham số
configName String: tên cấu hình
out PrintStream: PrintStream để kết xuất đầu ra

getConfigList

public List<String> getConfigList (String subPath, 
                boolean loadFromEnv)

Biến thể của getConfigList(), trong đó bạn có thể chỉ định xem chúng ta có muốn tải cấu hình từ môi trường hay không.

Tham số
subPath String: tên của các thư mục con cần tìm cấu hình. Nếu có giá trị rỗng, thì sẽ có cùng hành vi như getConfigList().
loadFromEnv boolean: True nếu chúng ta nên tải cấu hình trong biến môi trường.
Giá trị trả về
List<String>

getConfigList

public List<String> getConfigList ()

Trả về danh sách tên của tất cả các cấu hình có trong JAR trên đường dẫn lớp. Không cố gắng tải bất kỳ cấu hình nào, vì vậy có thể có cấu hình không hoạt động trong danh sách này.

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

getInstance

public static IConfigurationFactory getInstance ()

Lấy thực thể singleton IConfigurationFactory.

Giá trị trả về
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

Tải tất cả cấu hình có trong các thư mục đường dẫn lớp và trường hợp kiểm thử.

Tham số
discardExceptions boolean: true nếu bạn nên bỏ qua mọi ConfigurationException.
Gửi
com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

Phương thức tiện ích kiểm tra xem tất cả cấu hình có thể được tải, phân tích cú pháp và đặt tất cả các giá trị tuỳ chọn hay không. Chỉ được hiển thị để dự án phụ thuộc có thể xác thực cấu hình của chúng. Không được hiển thị trong bảng điều khiển.

Gửi
ConfigurationException nếu không tải được một hoặc nhiều cấu hình

printHelp

public void printHelp (PrintStream out)

In đầu ra trợ giúp cho nhà máy này.

In thông tin trợ giúp chung và liệt kê tất cả các cấu hình có sẵn.

Tham số
out PrintStream: PrintStream để kết xuất đầu ra

printHelpForConfig

public void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

In đầu ra trợ giúp cho IConfiguration được chỉ định trong đối số dòng lệnh,

Nếu "args" đề cập đến một cấu hình đã biết, thì một đối tượng IConfiguration sẽ được tạo từ XML và nội dung trợ giúp cho IConfiguration đó sẽ được xuất ra. Xin lưu ý rằng tất cả các giá trị "args" khác sẽ bị bỏ qua (tức là văn bản trợ giúp sẽ mô tả các giá trị hiện tại của Option được tải từ XML và sẽ không phản ánh các giá trị của lựa chọn do các đối số dòng lệnh đặt.

Nếu "args" không tham chiếu đến một IConfiguration đã biết, thì trợ giúp printHelp(PrintStream) chung sẽ xuất hiện.

Tham số
args String: đối số dòng lệnh
importantOnly boolean: nếu true, chỉ in danh sách trợ giúp rút gọn với các thông tin quan trọng
out PrintStream: PrintStream để kết xuất đầu ra

Phương thức được bảo vệ

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Tham số
name String

Giá trị trả về
InputStream

getConfigPrefix

protected String getConfigPrefix ()

Trả về tiền tố đường dẫn của các tệp xml cấu hình trên đường dẫn lớp

Được hiển thị để kiểm thử đơn vị có thể mô phỏng.

Giá trị trả về
String Đường dẫn String có dấu / ở cuối

getConfigStream

protected BufferedInputStream getConfigStream (String name)

Tải InputStream cho tên cấu hình đã cho

Tham số
name String: tên cấu hình cần tải
Giá trị trả về
BufferedInputStream một BufferedInputStream để đọc nội dung cấu hình
Gửi
ConfigurationException nếu không tìm thấy cấu hình

getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                Map<String, String> templateMap)

Truy xuất ConfigurationDef cho tên đã cho

Tham số
name String: tên của một cấu hình tích hợp để tải hoặc đường dẫn tệp đến tệp cấu hình để tải
isGlobal boolean

templateMap Map

Giá trị trả về
ConfigurationDef ConfigurationDef
Gửi
ConfigurationException nếu xảy ra lỗi khi tải cấu hình

getMapConfig

protected Map<ConfigurationFactory.ConfigId, ConfigurationDef> getMapConfig ()

Được hiển thị để kiểm thử. Trả về một bản sao của Bản đồ.

Giá trị trả về
Map<ConfigurationFactory.ConfigId, ConfigurationDef>

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

Tham số
configName String

Giá trị trả về
boolean

reorderArgs

protected String[] reorderArgs (String[] args)

Sắp xếp lại các đối số sao cho tất cả đối số template:map đều được chuyển lên đầu.

Tham số
args String

Giá trị trả về
String[]

resolveRemoteFile

protected IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, 
                URI destDir)

Tham số
configURI URI

destDir URI

Giá trị trả về
IRemoteFileResolver.ResolvedFile

Gửi
BuildRetrievalError