ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

โรงงานสําหรับการสร้าง 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