ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

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

---

โรงงานสำหรับสร้าง IConfiguration

สรุป

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

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

วิธีการสาธารณะ
void	clearMapConfig () ในบางกรณี เราจำเป็นต้องล้างแผนที่
IConfiguration	createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs) createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs) สร้าง IConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่ง
IConfiguration	createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient) createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient) สร้าง IConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่งด้วยที่เก็บคีย์
IConfiguration	createConfigurationFromArgs (String[] arrayArgs) วิธีการอำนวยความสะดวกที่เรียกใช้ ERROR(/#createConfigurationFromArgs(String[],List)) ด้วยอาร์กิวเมนต์วินาที null
IGlobalConfiguration	createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs) createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs) สร้าง IGlobalConfiguration จากอาร์กิวเมนต์บรรทัดคำสั่ง
IConfiguration	createPartialConfigurationFromArgs (String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) createPartialConfigurationFromArgs (String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) สร้างการกำหนดค่าที่มีชุดของวัตถุที่เลือกเท่านั้น
void	dumpConfig (String configName, PrintStream out) ดัมพ์เนื้อหาของการกำหนดค่าไปที่ ERROR(/PrintStream) ที่กำหนด
	getConfigList (String subPath, boolean loadFromEnv) รูปแบบของ getConfigList() ที่สามารถระบุได้ว่าเราต้องการโหลดการกำหนดค่าจากสภาพแวดล้อมด้วยหรือไม่
	getConfigList () ส่งคืนรายชื่อของการกำหนดค่าทั้งหมดที่พบใน JARs บน classpath
static IConfigurationFactory	getInstance () รับอินสแตนซ์ singleton IConfigurationFactory
void	loadAllConfigs (boolean discardExceptions) โหลดการกำหนดค่าทั้งหมดที่พบในไดเร็กทอรี classpath และกรณีทดสอบ
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 () ส่งคืนคำนำหน้าเส้นทางของไฟล์ config xml บน classpath เปิดเผยเพื่อให้การทดสอบหน่วยสามารถเยาะเย้ย
BufferedInputStream	getConfigStream (String name) โหลด InputStream สำหรับชื่อการกำหนดค่าที่กำหนด
ConfigurationDef	getConfigurationDef (String name, boolean isGlobal, templateMap) getConfigurationDef (String name, boolean isGlobal, templateMap) เรียก ConfigurationDef สำหรับชื่อที่กำหนด
	getMapConfig () เปิดเผยสำหรับการทดสอบ
boolean	isDirectConfiguration (String configName)
String[]	reorderArgs (String[] args) จัดลำดับอาร์กิวเมนต์ใหม่เพื่อให้ template:map args ถูกย้ายไปด้านหน้าทั้งหมด
IRemoteFileResolver.ResolvedFile	resolveRemoteFile (URI configURI, URI destDir)

ตัวสร้างที่ได้รับการป้องกัน

ConfigurationFactory

protected ConfigurationFactory ()

วิธีการสาธารณะ

clearMapConfig

public void clearMapConfig ()

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

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

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

รูปแบบที่ต้องการคือ "CONFIG [ตัวเลือก]" โดยที่ CONFIG เป็นชื่อการกำหนดค่าในตัวหรือพาธไฟล์ไปยังไฟล์ xml การกำหนดค่า

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

ส่งคืน
IConfiguration	IConfiguration ที่โหลดมา ฟิลด์ Option วัตถุผู้รับมอบสิทธิ์มีการเติมค่าในอาร์กิวเมนต์

พ่น
ConfigurationException

createConfigurationFromArgs

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

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

รูปแบบที่ต้องการคือ "CONFIG [ตัวเลือก]" โดยที่ CONFIG เป็นชื่อการกำหนดค่าในตัวหรือพาธไฟล์ไปยังไฟล์ xml การกำหนดค่า

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

ส่งคืน
IConfiguration	IConfiguration ที่โหลดมา ฟิลด์ Option วัตถุผู้รับมอบสิทธิ์มีการเติมค่าในอาร์กิวเมนต์

พ่น
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

วิธีการอำนวยความสะดวกที่เรียกใช้ ERROR(/#createConfigurationFromArgs(String[],List)) ด้วยอาร์กิวเมนต์วินาที null ConfigurationException ถ้าอาร์กิวเมนต์ที่ยังไม่ได้ใช้เหลืออยู่

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

ส่งคืน
IConfiguration

พ่น
ConfigurationException

สร้าง GlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

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

รูปแบบที่ต้องการคือ "CONFIG [ตัวเลือก]" โดยที่ CONFIG เป็นชื่อการกำหนดค่าในตัวหรือพาธไฟล์ไปยังไฟล์ xml การกำหนดค่า

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

ส่งคืน
IGlobalConfiguration	IGlobalConfiguration ที่โหลด ฟิลด์ 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

ถ่ายโอนข้อมูล Config

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 ()

ส่งคืนรายชื่อของการกำหนดค่าทั้งหมดที่พบใน JARs บน classpath ไม่พยายามโหลดการกำหนดค่าใด ๆ ดังนั้นจึงเป็นไปได้ที่จะมีการกำหนดค่าที่ไม่ทำงานในรายการนี้

ส่งคืน

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

public static IConfigurationFactory getInstance ()

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

ส่งคืน
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

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

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

พ่น
	com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

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

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

พิมพ์วิธีใช้

public void printHelp (PrintStream out)

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

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

พารามิเตอร์
out	PrintStream : ERROR(/PrintStream) เพื่อดัมพ์เอาต์พุตไปที่

พิมพ์วิธีใช้สำหรับการกำหนดค่า

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

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

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

ถ้า '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 ()

ส่งคืนคำนำหน้าเส้นทางของไฟล์ config xml บน classpath

เปิดเผยเพื่อให้การทดสอบหน่วยสามารถเยาะเย้ย

ส่งคืน
String	เส้นทาง ERROR(/String) พร้อมต่อท้าย /

รับ ConfigStream

protected BufferedInputStream getConfigStream (String name)

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

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

ส่งคืน
BufferedInputStream	ERROR(/BufferedInputStream) สำหรับการอ่านเนื้อหาการกำหนดค่า

พ่น
ConfigurationException	หากไม่พบการกำหนดค่า

รับ ConfigurationDef

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

เรียก ConfigurationDef สำหรับชื่อที่กำหนด

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

ส่งคืน
ConfigurationDef	ConfigurationDef

พ่น
ConfigurationException	หากเกิดข้อผิดพลาดในการโหลดการกำหนดค่า

รับ MapConfig

protected  getMapConfig ()

เปิดเผยสำหรับการทดสอบ ส่งคืนสำเนาของแผนที่

ส่งคืน

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

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

ส่งคืน
boolean

จัดลำดับอาร์กิวเมนต์ใหม่

protected String[] reorderArgs (String[] args)

จัดลำดับอาร์กิวเมนต์ใหม่เพื่อให้ template:map args ถูกย้ายไปด้านหน้าทั้งหมด

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

ส่งคืน
String[]

แก้ไขไฟล์ระยะไกล

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

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

ส่งคืน
IRemoteFileResolver.ResolvedFile

พ่น
BuildRetrievalError