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

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

ค่าเริ่มต้นสำหรับการสร้าง 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