Nhà máy cấu hình
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
Việc triển khai IConfigDefLoader giúp theo dõi các cấu hình đi kèm từ một cấu hình gốc và ném một ngoại lệ vào vòng bao gồm. |
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 tôi cần phải xoá nội dung trên bản đồ. |
IConfiguration
|
createConfigurationFromArgs(String[] arrayArgs,
Tạo |
IConfiguration
|
createConfigurationFromArgs(String[] arrayArgs,
Tạo |
IConfiguration
|
createConfigurationFromArgs(String[] arrayArgs)
Một phương thức tiện lợi gọi |
IGlobalConfiguration
|
createGlobalConfigurationFromArgs(String[] arrayArgs,
Tạo |
IConfiguration
|
createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient,
Tạo một cấu hình chỉ chứa một tập hợp các đối tượng đã chọn. |
void
|
dumpConfig(String configName, PrintStream out)
Kết xuất nội dung cấu hình vào |
|
getConfigList(String subPath, boolean loadFromEnv)
Biến thể của |
|
getConfigList()
Trả về danh sách tên của tất cả các cấu hình có trong tệp JAR trên classpath. |
static
IConfigurationFactory
|
getInstance()
Lấy thực thể singleton |
void
|
loadAllConfigs(boolean discardExceptions)
Tải tất cả cấu hình có trong thư mục classpath và trường hợp kiểm thử. |
void
|
loadAndPrintAllConfigs()
Phương thức tiện ích giúp kiểm tra để đảm bảo rằng có thể tải, phân tích cú pháp và phân tích cú pháp tất cả cấu hình đã đặt tất cả giá trị tùy chọn. |
void
|
printHelp(PrintStream out)
Kết quả trợ giúp về bản in cho nhà máy này. |
void
|
printHelpForConfig(String[] args, boolean importantOnly, PrintStream out)
In giúp xuất kết quả cho
Nếu là "args" tham chiếu đến một cấu hình đã biết, đối tượng |
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 config trên classpath Được hiển thị để kiểm thử đơn vị có thể mô phỏng. |
BufferedInputStream
|
getConfigStream(String name)
Tải một InputStream cho tên cấu hình đã cho |
ConfigurationDef
|
getConfigurationDef(String name, boolean isGlobal,
Truy xuất |
|
getMapConfig()
Được sử dụng để kiểm thử. |
boolean
|
isDirectConfiguration(String configName)
|
String[]
|
reorderArgs(String[] args)
Hãy sắp xếp lại thứ tự đối số để đối số mẫu:map đều được di chuyển lên phía trước. |
IRemoteFileResolver.ResolvedFile
|
resolveRemoteFile(URI configURI, URI destDir)
|
Hàm khởi tạo được bảo vệ
Nhà máy cấu hình
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 tôi cần phải xoá nội dung trên bản đồ.
createCấu hìnhTừArgs
public IConfiguration createConfigurationFromArgs (String[] arrayArgs,unconsumedArgs)
Tạo IConfiguration
từ đối số dòng lệnh.
Định dạng đúng là "CONFIG [options]", trong đó CONFIG là tên cấu hình tích hợp sẵn hoặc một đường dẫn tệp đến tệp xml cấu hình.
Tham số | |
---|---|
arrayArgs |
String : đối số dòng lệnh |
unconsumedArgs |
: một Danh sách sẽ được điền sẵn các đối số không phải là
được tiêu thụ bởi các Đối tượng liên kết với cấu hình được chỉ định. Nếu trường hợp nà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 Option của đối tượng uỷ quyền có
đã được điền sẵn các giá trị vào đối số. |
Gửi | |
---|---|
ConfigurationException |
createCấu hìnhTừArgs
public IConfiguration createConfigurationFromArgs (String[] arrayArgs,unconsumedArgs, IKeyStoreClient keyStoreClient)
Tạo IConfiguration
từ đối số dòng lệnh có kho khoá.
Định dạng đúng là "CONFIG [options]", trong đó CONFIG là tên cấu hình tích hợp sẵn hoặc một đường dẫn tệp đến tệp xml cấu hình.
Tham số | |
---|---|
arrayArgs |
String : đối số dòng lệnh |
unconsumedArgs |
: một Danh sách sẽ được điền sẵn các đối số không phải là
được tiêu thụ bởi các Đối tượng liên kết với cấu hình được chỉ định. Nếu trường hợp nà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 dùng để lấy thông tin nhạy cảm trong
lập luận. |
Giá trị trả về | |
---|---|
IConfiguration |
IConfiguration đã tải. Các trường Option của đối tượng uỷ quyền có
đã được điền sẵn các giá trị vào đối số. |
Gửi | |
---|---|
ConfigurationException |
createCấu hìnhTừArgs
public IConfiguration createConfigurationFromArgs (String[] arrayArgs)
Một phương thức tiện lợi gọi ERROR(/#createConfigurationFromArgs(String[],List))
với một đối số thứ hai null
. Do đó, hàm sẽ gửi ConfigurationException
nếu
mọi đối số không được sử dụng vẫn còn.
Tham số | |
---|---|
arrayArgs |
String |
Giá trị trả về | |
---|---|
IConfiguration |
Gửi | |
---|---|
ConfigurationException |
createGlobalConfigurationFromArgs
public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs,remainingArgs)
Tạo IGlobalConfiguration
từ đối số dòng lệnh.
Định dạng đúng là "CONFIG [options]", trong đó CONFIG là tên cấu hình tích hợp sẵn hoặc một đường dẫn tệp đến tệp xml cấu hình.
Tham số | |
---|---|
arrayArgs |
String : đối số dòng lệnh |
remainingArgs |
: một danh sách sẽ được điền sẵn các đối số không được điền trước
được xử lý dưới dạng đối số toàn cục |
Giá trị trả về | |
---|---|
IGlobalConfiguration |
IGlobalConfiguration đã tải. Các trường của đối tượng uỷ quyền Option
đã được điền sẵn các giá trị vào đối số. |
Gửi | |
---|---|
ConfigurationException |
Tạo một phần cấu hình từArgs
public IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, IKeyStoreClient keyStoreClient,allowedObjects, TradefedDelegator delegator)
Tạo một cấu hình chỉ chứa một tập hợp các đối tượng đã chọn.
Tham số | |
---|---|
arrayArgs |
String : Đối số dòng lệnh |
keyStoreClient |
IKeyStoreClient : Một IKeyStoreClient dùng để lấy thông tin nhạy cảm trong
args. |
allowedObjects |
: 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ấu hình vào ERROR(/PrintStream)
đã cho
Tham số | |
---|---|
configName |
String : tên cấu hình |
out |
PrintStream : ERROR(/PrintStream) để kết xuất đầu ra thành |
getConfigList
publicgetConfigList (String subPath, boolean loadFromEnv)
Biến thể của getConfigList()
, trong đó có thể chỉ định xem chúng ta có muốn tải hay không
cấu hình từ môi trường.
Tham số | |
---|---|
subPath |
String : tên của thư mục con cần tìm cấu hình. Nếu rỗng, sẽ có
hành vi tương tự như getConfigList() . |
loadFromEnv |
boolean : Đúng nếu chúng ta tải cấu hình trong biến môi trường. |
Giá trị trả về | |
---|---|
|
getConfigList
publicgetConfigList ()
Trả về danh sách tên của tất cả các cấu hình có trong tệp JAR trên classpath. Không tìm cách tải bất kỳ cấu hình nào nên có thể cấu hình không hoạt động trong danh sách này.
Giá trị trả về | |
---|---|
|
getInstance
public static IConfigurationFactory getInstance ()
Lấy thực thể singleton IConfigurationFactory
.
Giá trị trả về | |
---|---|
IConfigurationFactory |
tảiAllConfigs
public void loadAllConfigs (boolean discardExceptions)
Tải tất cả cấu hình có trong thư mục classpath và trường hợp kiểm thử.
Tham số | |
---|---|
discardExceptions |
boolean : true nếu cần bỏ qua bất kỳ ConfigurationException nào. |
Gửi | |
---|---|
|
com.android.tradefed.config.ConfigurationException |
ConfigurationException |
tảiAndPrintAllConfigs
public void loadAndPrintAllConfigs ()
Phương thức tiện ích giúp kiểm tra để đảm bảo rằng có thể tải, phân tích cú pháp và phân tích cú pháp tất cả cấu hình đã đặt tất cả giá trị tùy chọn. Chỉ được hiển thị để tuỳ thuộc vào dự án có thể xác thực cá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 một hoặc nhiều cấu hình không tải được |
printTrợ giúp
public void printHelp (PrintStream out)
Kết quả trợ giúp về bản in cho nhà máy này.
In thông tin trợ giúp chung và liệt kê tất cả cấu hình có sẵn.
Tham số | |
---|---|
out |
PrintStream : ERROR(/PrintStream) để kết xuất đầu ra thành |
printHelpForConfig
public void printHelpForConfig (String[] args, boolean importantOnly, PrintStream out)
In giúp xuất kết quả cho IConfiguration
được chỉ định trong đối số dòng lệnh,
Nếu là "args" tham chiếu đến một cấu hình đã biết, đối tượng IConfiguration
sẽ được tạo
từ XML và đưa ra thông tin trợ giúp cho IConfiguration
đó. Lưu ý tất cả các "args" khác
các giá trị 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 các giá trị Option
như được tải từ XML và sẽ không phản ánh các giá trị của tuỳ chọn do đối số dòng lệnh đặt.
Nếu là "args" không tham chiếu đến một IConfiguration
đã biết, tham chiếu đến
Trợ giúp printHelp(PrintStream)
sẽ hiển thị.
Tham số | |
---|---|
args |
String : đối số dòng lệnh |
importantOnly |
boolean : nếu là true , xuất bản trợ giúp viết tắt chỉ liệt kê
chi tiết quan trọng |
out |
PrintStream : ERROR(/PrintStream) để kết xuất đầu ra thành |
Phương thức được bảo vệ
getBundledConfigStream
protected InputStream getBundledConfigStream (String name)
Tham số | |
---|---|
name |
String |
Giá trị trả về | |
---|---|
InputStream |
getConfigPrefix (Tiền tố cấu hình)
protected String getConfigPrefix ()
Trả về tiền tố đường dẫn của các tệp xml config trên classpath
Được hiển thị để kiểm thử đơn vị có thể mô phỏng.
Giá trị trả về | |
---|---|
String |
Đường dẫn String có đuôi / |
getConfigStream
protected BufferedInputStream getConfigStream (String name)
Tải một 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 |
ERROR(/BufferedInputStream) để đọc nội dung cấu hình |
Gửi | |
---|---|
ConfigurationException |
nếu không thể tìm thấy cấu hình |
getConfigurationDef
protected ConfigurationDef getConfigurationDef (String name, boolean isGlobal,templateMap)
Truy xuất ConfigurationDef
cho tên được cung cấp
Tham số | |
---|---|
name |
String : tên của cấu hình tích hợp sẵn cần tải hoặc đường dẫn tệp đến tệp cấu hình
để tải |
isGlobal |
boolean |
templateMap |
|
Giá trị trả về | |
---|---|
ConfigurationDef |
ConfigurationDef |
Gửi | |
---|---|
ConfigurationException |
nếu đã xảy ra lỗi khi tải cấu hình |
getMapConfig
protectedgetMapConfig ()
Được sử dụng để kiểm thử. Trả về một bản sao của Bản đồ.
Giá trị trả về | |
---|---|
|
Cấu hình trực tiếp
protected boolean isDirectConfiguration (String configName)
Tham số | |
---|---|
configName |
String |
Giá trị trả về | |
---|---|
boolean |
đơn đặt hàng lại
protected String[] reorderArgs (String[] args)
Hãy sắp xếp lại thứ tự đối số để đối số mẫu:map đều được di chuyển lên phía trước.
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 |