Cấu hìnhFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

Các lớp con trực tiếp đã biết GCSConfigurationFactory , RetryConfigurationFactory , SandboxConfigurationFactory GCSConfigurationFactory ConfigurationFactory tải cấu hình từ Google Cloud Storage. Thử lạiConfigurationFactory Nhà máy xử lý thử lại một lệnh. SandboxConfigurationFactory Nhà máy Cấu hình Đặc biệt để xử lý việc tạo cấu hình cho mục đích Sandboxing.

---

Nhà máy tạo IConfiguration .

Bản tóm tắt

các lớp lồng nhau
class	ConfigurationFactory.ConfigLoader Việc triển khai IConfigDefLoader theo dõi các cấu hình được bao gồm từ một cấu hình gốc và đưa ra một ngoại lệ đối với thông tư bao gồm.
class	ConfigurationFactory.ExceptionLoader

Các nhà xây dựng đượ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 xóa bản đồ.
IConfiguration	createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs) createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs) Tạo IConfiguration từ các đối số dòng lệnh.
IConfiguration	createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient) createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient) Tạo IConfiguration từ các đối số dòng lệnh với kho lưu trữ khóa.
IConfiguration	createConfigurationFromArgs (String[] arrayArgs) Một phương thức tiện lợi gọi ERROR(/#createConfigurationFromArgs(String[],List)) với đối số thứ hai null .
IGlobalConfiguration	createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs) createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs) Tạo IGlobalConfiguration từ các đối số dòng lệnh.
IConfiguration	createPartialConfigurationFromArgs (String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) 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.
void	dumpConfig (String configName, PrintStream out) Kết xuất nội dung của cấu hình vào ERROR(/PrintStream) đã cho
	getConfigList (String subPath, boolean loadFromEnv) Biến thể của getConfigList() nơi có thể chỉ định xem chúng tôi có muốn tải cấu hình từ môi trường hay không.
	getConfigList () Trả về danh sách tên của tất cả các cấu hình được tìm thấy trong các JAR trên đường dẫn lớp.
static IConfigurationFactory	getInstance () Lấy phiên bản IConfigurationFactory đơn lẻ.
void	loadAllConfigs (boolean discardExceptions) Tải tất cả các cấu hình được tìm thấy trong thư mục đường dẫn lớp và trường hợp kiểm tra.
void	loadAndPrintAllConfigs () Phương thức tiện ích kiểm tra xem tất cả các cấu hình có thể được tải, phân tích cú pháp và tất cả các giá trị tùy chọn được đặt hay không.
void	printHelp (PrintStream out) Bản in giúp đầu ra 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 các đối số dòng lệnh, Nếu 'args' đề cập đến một cấu hình đã biết, một đối tượng IConfiguration sẽ được tạo từ XML và trợ giúp cho IConfiguration đó sẽ được xuất ra.

phương pháp được bảo vệ
InputStream	getBundledConfigStream (String name)
String	getConfigPrefix () Trả về tiền tố đường dẫn của tệp xml cấu hình trên đường dẫn lớp Tiếp xúc để các bài kiểm tra đơn vị có thể giả định.
BufferedInputStream	getConfigStream (String name) Tải một InputStream cho tên cấu hình đã cho
ConfigurationDef	getConfigurationDef (String name, boolean isGlobal, templateMap) getConfigurationDef (String name, boolean isGlobal, templateMap) Truy xuất ConfigurationDef cho tên đã cho
	getMapConfig () Tiếp xúc để thử nghiệm.
boolean	isDirectConfiguration (String configName)
String[]	reorderArgs (String[] args) Sắp xếp lại các đối số sao cho tất cả các đối số template:map đều được di chuyển lên phía trước.
IRemoteFileResolver.ResolvedFile	resolveRemoteFile (URI configURI, URI destDir)

Các nhà xây dựng được bảo vệ

Cấu hìnhFactory

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 xóa bản đồ.

tạoConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

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

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

Thông số
arrayArgs	String : các đối số dòng lệnh
unconsumedArgs	: một Danh sách sẽ được phổ biến với các đối số không được sử dụng bởi các Đối tượng được liên kết với cấu hình đã chỉ định. Nếu giá trị này là null , thì quá trình triển khai sẽ ném ra ConfigurationException nếu vẫn còn bất kỳ đối số nào chưa được xử lý.

trả lại
IConfiguration	IConfiguration đã tải. Các trường Option đối tượng đại biểu đã được phổ biến với các giá trị trong args.

ném
ConfigurationException

tạoConfigurationFromArgs

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

Tạo IConfiguration từ các đối số dòng lệnh với kho lưu trữ khóa.

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

Thông số
arrayArgs	String : các đối số dòng lệnh
unconsumedArgs	: một Danh sách sẽ được phổ biến với các đối số không được sử dụng bởi các Đối tượng được liên kết với cấu hình đã chỉ định. Nếu giá trị này là null , thì quá trình triển khai sẽ ném ra ConfigurationException nếu vẫn còn bất kỳ đối số nào chưa được xử lý.
keyStoreClient	IKeyStoreClient : một IKeyStoreClient được sử dụng để lấy thông tin nhạy cảm trong các đối số.

trả lại
IConfiguration	IConfiguration đã tải. Các trường Option đối tượng đại biểu đã được phổ biến với các giá trị trong args.

ném
ConfigurationException

tạoConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Một phương thức tiện lợi gọi ERROR(/#createConfigurationFromArgs(String[],List)) với đối số thứ hai null . Do đó, nó sẽ ném ra ConfigurationException nếu vẫn còn bất kỳ đối số nào chưa được sử dụng.

Thông số
arrayArgs	String

trả lại
IConfiguration

ném
ConfigurationException

tạoGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

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

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

Thông số
arrayArgs	String : các đối số dòng lệnh
remainingArgs	: một danh sách sẽ được phổ biến với các đối số không được xử lý dưới dạng đối số chung

trả lại
IGlobalConfiguration	IGlobalConfiguration đã tải. Các trường Option đối tượng đại biểu đã được phổ biến với các giá trị trong args.

ném
ConfigurationException

tạoPartialConfigurationFromArgs

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.

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

trả lại
IConfiguration	IConfiguration đã tải.

ném
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

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

Thông số
configName	String : tên cấu hình
out	PrintStream : ERROR(/PrintStream) để kết xuất đầu ra sang

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

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

Thông số
subPath	String : tên của các thư mục con để tìm kiếm cấu hình. Nếu null, sẽ có hành vi tương tự như getConfigList() .
loadFromEnv	boolean : Đúng nếu chúng ta nên tải cấu hình trong biến môi trường.

trả lại

getConfigList

public  getConfigList ()

Trả về danh sách tên của tất cả các cấu hình được tìm thấy trong các JAR trên đường dẫn lớp. Không cố 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.

trả lại

getInstance

public static IConfigurationFactory getInstance ()

Lấy phiên bản IConfigurationFactory đơn lẻ.

trả lại
IConfigurationFactory

tảiAllConfigs

public void loadAllConfigs (boolean discardExceptions)

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

Thông số
discardExceptions	boolean : đúng nếu bỏ qua bất kỳ Ngoại lệ cấu hình nào.

ném
	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ác cấu hình có thể được tải, phân tích cú pháp và tất cả các giá trị tùy chọn được đặt hay không. Chỉ được hiển thị để dự án tùy thuộc có thể xác thực cấu hình của họ. Không nên được tiếp xúc trong bảng điều khiển.

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

inTrợ giúp

public void printHelp (PrintStream out)

Bản in giúp đầu ra 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.

Thông số
out	PrintStream : ERROR(/PrintStream) để kết xuất đầu ra sang

printHelpForConfig

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

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

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

Nếu 'args' không tham chiếu IConfiguration đã biết, trợ giúp printHelp(PrintStream) chung sẽ được hiển thị.

Thông số
args	String : các đối số dòng lệnh
importantOnly	boolean : nếu true , hãy in trợ giúp viết tắt chỉ liệt kê các chi tiết quan trọng
out	PrintStream : ERROR(/PrintStream) để kết xuất đầu ra sang

phương pháp được bảo vệ

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Thông số
name	String

trả lại
InputStream

getConfigPrefix

protected String getConfigPrefix ()

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

Tiếp xúc để các bài kiểm tra đơn vị có thể giả định.

trả lại
String	Đường dẫn String có dấu /

getConfigStream

protected BufferedInputStream getConfigStream (String name)

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

Thông số
name	String : tên cấu hình cần tải

trả lại
BufferedInputStream	một ERROR(/BufferedInputStream) để đọc nội dung cấu hình

ném
ConfigurationException	nếu không tìm thấy cấu hình

getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                 templateMap)

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

Thông số
name	String : tên của 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

trả lại
ConfigurationDef	ConfigurationDef

ném
ConfigurationException	nếu xảy ra lỗi khi tải cấu hình

getMapConfig

protected  getMapConfig ()

Tiếp xúc để thử nghiệm. Trả lại một bản sao của Bản đồ.

trả lại

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

Thông số
configName	String

trả lại
boolean

sắp xếp lạiArgs

protected String[] reorderArgs (String[] args)

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

Thông số
args	String

trả lại
String[]

giải quyếtRemoteFile

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

Thông số
configURI	URI
destDir	URI

trả lại
IRemoteFileResolver.ResolvedFile

ném
BuildRetrievalError