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

public class ConfigurationFactory
extends Object implements IConfigurationFactory

java.lang.Object
↳	com.android.tradefed.config.Configurationมัน

คลาสย่อยโดยตรงที่รู้จัก GCSConfigurationfactor, RetryConfigurationแฟ้ม, SandboxConfigurationFactory GCSConfigurationfactor ConfigurationFactory จะโหลดการกำหนดค่าจาก Google Cloud Storage  ลองอีกครั้งการกำหนดค่าจากโรงงาน โรงงานที่จัดการลองใช้คำสั่งซ้ำ  แซนด์บ็อกซ์การกำหนดค่าโรงงาน โรงงานกำหนดค่าพิเศษเพื่อจัดการการสร้างการกำหนดค่าเพื่อวัตถุประสงค์ในการใช้แซนด์บ็อกซ์

---

ค่าเริ่มต้นสำหรับการสร้าง IConfiguration

สรุป

ชั้นเรียนที่ซ้อนกัน
class	ConfigurationFactory.ConfigLoader การใช้งาน IConfigDefLoader ที่ติดตามการกำหนดค่าที่รวมอยู่ Root config ได้ และแสดงผลข้อยกเว้นใน Circular include
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)) ด้วยอาร์กิวเมนต์ 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 บนคลาสพาธ
static IConfigurationFactory	getInstance() รับอินสแตนซ์ IConfigurationFactory แบบเดี่ยว
void	loadAllConfigs(boolean discardExceptions) โหลดการกำหนดค่าทั้งหมดที่พบในไดเรกทอรี classpath และกรอบการทดสอบ
void	loadAndPrintAllConfigs() วิธียูทิลิตีที่ตรวจสอบว่าการกําหนดค่าทั้งหมดสามารถโหลด แยกวิเคราะห์ และ ตั้งค่าตัวเลือกทั้งหมด
void	printHelp(PrintStream out) ฟังก์ชันช่วยพิมพ์เอาต์พุตสำหรับโรงงานนี้
void	printHelpForConfig(String[] args, boolean importantOnly, PrintStream out) พิมพ์เอาต์พุตความช่วยเหลือสำหรับ IConfiguration ที่ระบุในอาร์กิวเมนต์บรรทัดคำสั่ง หาก "อาร์กิวเมนต์" อ้างถึงการกำหนดค่าที่รู้จัก ระบบจะสร้างออบเจ็กต์ 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)

เครื่องมือสร้างที่มีการป้องกัน

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

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 ที่โหลด ช่องออบเจ็กต์ที่ได้รับมอบสิทธิ์ Option มีการระบุค่าในอาร์กิวเมนต์

การขว้าง
ConfigurationException

createบางConfigurationFromArgs

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

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

พารามิเตอร์
arrayArgs	String: อาร์กิวเมนต์บรรทัดคำสั่ง
keyStoreClient	IKeyStoreClient: IKeyStoreClient ที่ใช้รับข้อมูลที่ละเอียดอ่อนใน อาร์กิวเมนต์
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: true หากละเว้น ConfigurationException

การขว้าง
	com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

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

การขว้าง
ConfigurationException	หากมีการกำหนดค่าไม่สำเร็จอย่างน้อย 1 รายการ

ความช่วยเหลือเกี่ยวกับการพิมพ์

public void printHelp (PrintStream out)

ฟังก์ชันช่วยพิมพ์เอาต์พุตสำหรับโรงงานนี้

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

พารามิเตอร์
out	PrintStream: ERROR(/PrintStream) เพื่อถ่ายโอนเอาต์พุตไปยัง

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

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

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

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

หาก "อาร์กิวเมนต์" ไม่ได้อ้างอิง 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 ที่มี / ต่อท้าย

getConfigสตรีม

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

จัดเรียงอาร์เรย์ใหม่

protected String[] reorderArgs (String[] args)

เรียงลำดับอาร์กิวเมนต์ใหม่เพื่อให้อาร์กิวเมนต์ "เทมเพลต:แผนที่" ย้ายไปอยู่ด้านหน้าทั้งหมด

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

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

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

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

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

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

การขว้าง
BuildRetrievalError