การกำหนดค่าจากโรงงาน

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

คลาสย่อยโดยตรงที่รู้จัก GCSConfigurationfactor, RetryConfigurationแฟ้ม, SandboxConfigurationfactor 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) เรียงลำดับอาร์กิวเมนต์ใหม่เพื่อให้อาร์กิวเมนต์ "เทมเพลต:แผนที่" ย้ายไปอยู่ด้านหน้าทั้งหมด
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 ที่โหลด ช่องออบเจ็กต์ที่ได้รับมอบสิทธิ์ Option มี มีการระบุค่าในอาร์กิวเมนต์

การขว้าง
ConfigurationException

createConfigurationFromArgs

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

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

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

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

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

โยน
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

วิธีการชำระเงินที่โทรหา ERROR(/#createConfigurationFromArgs(String[],List)) ด้วยอาร์กิวเมนต์ 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 บนคลาสพาธ ไม่พยายามโหลดการกําหนดค่าใดๆ ดังนั้นจึงอาจมีการกำหนดค่าที่ไม่ทํางานในรายการนี้

คิกรีเทิร์น

getInstance

public static IConfigurationFactory getInstance ()

รับอินสแตนซ์ IConfigurationFactory แบบเดี่ยว

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

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

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

พารามิเตอร์
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) สำหรับแสดงผลเอาต์พุต

ความช่วยเหลือสำหรับการกำหนดค่า

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	หากไม่พบการกำหนดค่า

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	String

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

แก้ปัญหาระยะไกลไฟล์

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

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

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

โยน
BuildRetrievalError