ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

คลาสย่อยโดยตรงที่ทราบ GCSConfigurationFactory, RetryConfigurationFactory, SandboxConfigurationFactory GCSConfigurationFactory ConfigurationFactory จะโหลดการกําหนดค่าจาก Google Cloud Storage  RetryConfigurationFactory โรงงานที่จัดการการลองใช้คําสั่งอีกครั้ง  SandboxConfigurationFactory Special Configuration factory เพื่อจัดการการสร้างการกําหนดค่าสําหรับวัตถุประสงค์ของการสร้างแซนด์บ็อกซ์

---

โรงงานสําหรับการสร้าง IConfiguration

สรุป

ชั้นเรียนที่ซ้อนกัน
class	ConfigurationFactory.ConfigLoader การใช้งาน IConfigDefLoader ที่ติดตามการกําหนดค่าที่รวมไว้จากการกําหนดค่ารูทรายการเดียว และแสดงข้อยกเว้นในการรวมแบบวนซ้ำ
class	ConfigurationFactory.ExceptionLoader

ตัวสร้างที่มีการป้องกัน
ConfigurationFactory()

เมธอดสาธารณะ
void	clearMapConfig() ในบางกรณี เราจำเป็นต้องล้างแผนที่
IConfiguration	createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs) สร้าง IConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่ง
IConfiguration	createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient) สร้าง IConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่งด้วยที่เก็บคีย์
IConfiguration	createConfigurationFromArgs(String[] arrayArgs) เมธอดที่สะดวกซึ่งเรียก ERROR(/#createConfigurationFromArgs(String[],List)) ด้วยอาร์กิวเมนต์ที่ 2 null
IGlobalConfiguration	createGlobalConfigurationFromArgs(String[] arrayArgs, remainingArgs) สร้าง IGlobalConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่ง
IConfiguration	createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) สร้างการกําหนดค่าที่มีเฉพาะชุดออบเจ็กต์ที่เลือก
void	dumpConfig(String configName, PrintStream out) แสดงเนื้อหาของการกำหนดค่าไปยัง ERROR(/PrintStream) ที่ระบุ
	getConfigList(String subPath, boolean loadFromEnv) รูปแบบของ getConfigList() ซึ่งระบุได้ว่าต้องการโหลดการกําหนดค่าจากสภาพแวดล้อมด้วยหรือไม่
	getConfigList() แสดงรายการชื่อของการกำหนดค่าทั้งหมดที่พบใน JAR ในเส้นทาง Class
static IConfigurationFactory	getInstance() รับอินสแตนซ์ IConfigurationFactory แบบ Singleton
void	loadAllConfigs(boolean discardExceptions) โหลดการกําหนดค่าทั้งหมดที่พบในไดเรกทอรี classpath และไดเรกทอรี Test Case
void	loadAndPrintAllConfigs() เมธอดยูทิลิตีที่ตรวจสอบว่าสามารถโหลด แยกวิเคราะห์ และตั้งค่าตัวเลือกทั้งหมดของการกำหนดค่าได้
void	printHelp(PrintStream out) พิมพ์เอาต์พุตความช่วยเหลือสำหรับแฟกทอรีนี้
void	printHelpForConfig(String[] args, boolean importantOnly, PrintStream out) พิมพ์เอาต์พุตความช่วยเหลือสำหรับ IConfiguration ที่ระบุไว้ในอาร์กิวเมนต์บรรทัดคำสั่ง หาก "args" อ้างอิงถึงการกำหนดค่าที่ทราบ ระบบจะสร้างออบเจ็กต์ IConfiguration จาก XML และแสดงความช่วยเหลือสำหรับ IConfiguration นั้น

วิธีการที่มีการป้องกัน
InputStream	getBundledConfigStream(String name)
String	getConfigPrefix() แสดงผลคำนำหน้าเส้นทางของไฟล์ XML การกำหนดค่าใน classpath เปิดเผยเพื่อให้การทดสอบ 1 หน่วยสามารถจำลองได้
BufferedInputStream	getConfigStream(String name) โหลด InputStream สําหรับชื่อการกําหนดค่าที่ระบุ
ConfigurationDef	getConfigurationDef(String name, boolean isGlobal, templateMap) ดึงข้อมูล ConfigurationDef สำหรับชื่อที่ระบุ
	getMapConfig() แสดงเพื่อทดสอบ
boolean	isDirectConfiguration(String configName)
String[]	reorderArgs(String[] args) จัดเรียง args ใหม่เพื่อให้ args template:map ทั้งหมดย้ายไปไว้ด้านหน้า
IRemoteFileResolver.ResolvedFile	resolveRemoteFile(URI configURI, URI destDir)

ตัวสร้างที่มีการป้องกัน

ConfigurationFactory

protected ConfigurationFactory ()

เมธอดสาธารณะ

clearMapConfig

public void clearMapConfig ()

ในบางกรณี เราจำเป็นต้องล้างแผนที่

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

สร้าง IConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่ง

รูปแบบที่คาดไว้คือ "CONFIG [options]" โดยที่ CONFIG คือชื่อการกําหนดค่าในตัวหรือเส้นทางไฟล์ไปยังไฟล์ XML ของการกําหนดค่า

พารามิเตอร์
arrayArgs	String: อาร์กิวเมนต์บรรทัดคำสั่ง
unconsumedArgs	: รายการที่จะป้อนข้อมูลอาร์กิวเมนต์ที่ออบเจ็กต์ที่เชื่อมโยงกับการกำหนดค่าที่ระบุไม่ได้ใช้ หากค่านี้คือ null การใช้งานจะแสดงข้อผิดพลาด ConfigurationException หากยังมีอาร์กิวเมนต์ที่ยังไม่ได้ประมวลผลอยู่

คิกรีเทิร์น
IConfiguration	IConfiguration ที่โหลด ระบบได้ป้อนค่าใน args ลงในช่อง Option ของออบเจ็กต์ผู้รับมอบสิทธิ์แล้ว

การโยน
ConfigurationException

createConfigurationFromArgs

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

สร้าง IConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่งด้วยที่เก็บคีย์

รูปแบบที่คาดไว้คือ "CONFIG [options]" โดยที่ CONFIG คือชื่อการกําหนดค่าในตัวหรือเส้นทางไฟล์ไปยังไฟล์ XML ของการกําหนดค่า

พารามิเตอร์
arrayArgs	String: อาร์กิวเมนต์บรรทัดคำสั่ง
unconsumedArgs	: รายการที่จะป้อนข้อมูลอาร์กิวเมนต์ที่ออบเจ็กต์ที่เชื่อมโยงกับการกำหนดค่าที่ระบุไม่ได้ใช้ หากค่านี้คือ null การใช้งานจะแสดงข้อผิดพลาด ConfigurationException หากยังมีอาร์กิวเมนต์ที่ยังไม่ได้ประมวลผลอยู่
keyStoreClient	IKeyStoreClient: IKeyStoreClient ที่ใช้รับข้อมูลที่ละเอียดอ่อนใน args

คิกรีเทิร์น
IConfiguration	IConfiguration ที่โหลด ระบบได้ป้อนค่าใน args ลงในช่อง Option ของออบเจ็กต์ผู้รับมอบสิทธิ์แล้ว

การโยน
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

เมธอดที่สะดวกซึ่งเรียก ERROR(/#createConfigurationFromArgs(String[],List)) ด้วยอาร์กิวเมนต์ที่ 2 null ดังนั้น ระบบจะแสดงข้อผิดพลาด ConfigurationException หากยังมีอาร์กิวเมนต์ที่ไม่ได้ใช้อยู่

พารามิเตอร์
arrayArgs	String

คิกรีเทิร์น
IConfiguration

การโยน
ConfigurationException

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

สร้าง IGlobalConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่ง

รูปแบบที่คาดไว้คือ "CONFIG [options]" โดยที่ CONFIG คือชื่อการกําหนดค่าในตัวหรือเส้นทางไฟล์ไปยังไฟล์ XML ของการกําหนดค่า

พารามิเตอร์
arrayArgs	String: อาร์กิวเมนต์บรรทัดคำสั่ง
remainingArgs	: รายการที่จะป้อนข้อมูลอาร์กิวเมนต์ที่ไม่ได้ประมวลผลเป็นอาร์กิวเมนต์ส่วนกลาง

คิกรีเทิร์น
IGlobalConfiguration	IGlobalConfiguration ที่โหลด ระบบได้ป้อนค่าใน args ลงในช่อง Option ของออบเจ็กต์ตัวแทนแล้ว

การโยน
ConfigurationException

createPartialConfigurationFromArgs

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

สร้างการกําหนดค่าที่มีเฉพาะชุดออบเจ็กต์ที่เลือก

พารามิเตอร์
arrayArgs	String: อาร์กิวเมนต์บรรทัดคำสั่ง
keyStoreClient	IKeyStoreClient: IKeyStoreClient ที่ใช้รับข้อมูลที่ละเอียดอ่อนใน args
allowedObjects	: ชุดออบเจ็กต์ที่อนุญาตให้สร้าง
delegator	TradefedDelegator

คิกรีเทิร์น
IConfiguration	IConfiguration ที่โหลด

การโยน
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

แสดงเนื้อหาของการกำหนดค่าไปยัง ERROR(/PrintStream) ที่ระบุ

พารามิเตอร์
configName	String: ชื่อการกําหนดค่า
out	PrintStream: ERROR(/PrintStream) สำหรับแสดงผลเอาต์พุต

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

รูปแบบของ getConfigList() ซึ่งระบุได้ว่าต้องการโหลดการกําหนดค่าจากสภาพแวดล้อมด้วยหรือไม่

พารามิเตอร์
subPath	String: ชื่อของไดเรกทอรีย่อยที่จะค้นหาการกําหนดค่า หากเป็นค่า Null ลักษณะการทํางานจะเหมือนกับ getConfigList()
loadFromEnv	boolean: จริงหากเราควรโหลดการกําหนดค่าในตัวแปรสภาพแวดล้อม

คิกรีเทิร์น

getConfigList

public  getConfigList ()

แสดงรายการชื่อของการกำหนดค่าทั้งหมดที่พบใน JAR ในเส้นทาง Class ไม่พยายามโหลดการกําหนดค่าใดๆ ดังนั้นจึงอาจมีการกำหนดค่าที่ไม่ทํางานในรายการนี้

คิกรีเทิร์น

getInstance

public static IConfigurationFactory getInstance ()

รับอินสแตนซ์ IConfigurationFactory แบบ Singleton

คิกรีเทิร์น
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

โหลดการกําหนดค่าทั้งหมดที่พบในไดเรกทอรี classpath และไดเรกทอรี Test Case

พารามิเตอร์
discardExceptions	boolean: จริงหากควรละเว้น ConfigurationException

การโยน
	com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

เมธอดยูทิลิตีที่ตรวจสอบว่าสามารถโหลด แยกวิเคราะห์ และตั้งค่าตัวเลือกทั้งหมดของการกำหนดค่าได้ แสดงเฉพาะเพื่อให้โปรเจ็กต์ที่เกี่ยวข้องตรวจสอบการกําหนดค่าได้ ไม่ควรแสดงในคอนโซล

การโยน
ConfigurationException	หากการโหลดการกําหนดค่าอย่างน้อย 1 รายการไม่สําเร็จ

printHelp

public void printHelp (PrintStream out)

พิมพ์เอาต์พุตความช่วยเหลือสำหรับแฟกทอรีนี้

พิมพ์ข้อมูลความช่วยเหลือทั่วไปและแสดงรายการการกำหนดค่าที่ใช้ได้ทั้งหมด

พารามิเตอร์
out	PrintStream: ERROR(/PrintStream) สำหรับแสดงผลเอาต์พุต

printHelpForConfig

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

พิมพ์เอาต์พุตความช่วยเหลือสำหรับ IConfiguration ที่ระบุไว้ในอาร์กิวเมนต์บรรทัดคำสั่ง

หาก "args" อ้างอิงถึงการกำหนดค่าที่ทราบ ระบบจะสร้างออบเจ็กต์ IConfiguration จาก XML และแสดงความช่วยเหลือสำหรับ IConfiguration นั้น โปรดทราบว่าระบบจะไม่สนใจค่า "args" อื่นๆ ทั้งหมด (กล่าวคือ ข้อความความช่วยเหลือจะอธิบายค่าปัจจุบันของ Options ที่โหลดจาก XML และจะไม่แสดงค่าของตัวเลือกที่ตั้งค่าโดยอาร์กิวเมนต์บรรทัดคำสั่ง)

หาก "args" ไม่ได้อ้างอิง IConfiguration ที่รู้จัก ระบบจะแสดงความช่วยเหลือทั่วไปเกี่ยวกับ printHelp(PrintStream)

พารามิเตอร์
args	String: อาร์กิวเมนต์บรรทัดคำสั่ง
importantOnly	boolean: หากเป็น true ให้พิมพ์ความช่วยเหลือแบบย่อที่แสดงเฉพาะรายละเอียดที่สําคัญ
out	PrintStream: ERROR(/PrintStream) สำหรับแสดงผลเอาต์พุต

วิธีการที่มีการป้องกัน

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

พารามิเตอร์
name	String

คิกรีเทิร์น
InputStream

getConfigPrefix

protected String getConfigPrefix ()

แสดงผลคำนำหน้าเส้นทางของไฟล์ XML การกำหนดค่าใน classpath

เปิดเผยเพื่อให้การทดสอบ 1 หน่วยสามารถจำลองได้

คิกรีเทิร์น
String	String เส้นทางที่มีเครื่องหมาย / ต่อท้าย

getConfigStream

protected BufferedInputStream getConfigStream (String name)

โหลด InputStream สําหรับชื่อการกําหนดค่าที่ระบุ

พารามิเตอร์
name	String: ชื่อการกําหนดค่าที่จะโหลด

คิกรีเทิร์น
BufferedInputStream	ERROR(/BufferedInputStream) สําหรับการอ่านเนื้อหาการกําหนดค่า

การโยน
ConfigurationException	if config could not be found

getConfigurationDef

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

ดึงข้อมูล ConfigurationDef สำหรับชื่อที่ระบุ

พารามิเตอร์
name	String: ชื่อการกําหนดค่าในตัวที่จะโหลด หรือเส้นทางไฟล์ไปยังไฟล์การกําหนดค่าที่จะโหลด
isGlobal	boolean
templateMap

คิกรีเทิร์น
ConfigurationDef	ConfigurationDef

การโยน
ConfigurationException	หากเกิดข้อผิดพลาดขณะโหลดการกําหนดค่า

getMapConfig

protected  getMapConfig ()

แสดงเพื่อทดสอบ ส่งสำเนาแผนที่คืน

คิกรีเทิร์น

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

พารามิเตอร์
configName	String

คิกรีเทิร์น
boolean

reorderArgs

protected String[] reorderArgs (String[] args)

จัดเรียง args ใหม่เพื่อให้ args template:map ทั้งหมดย้ายไปไว้ด้านหน้า

พารามิเตอร์
args	String

คิกรีเทิร์น
String[]

resolveRemoteFile

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

พารามิเตอร์
configURI	URI
destDir	URI

คิกรีเทิร์น
IRemoteFileResolver.ResolvedFile

การโยน
BuildRetrievalError