TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
   ↳ com.android.tradefed.sandbox.TradefedSandbox

คอนเทนเนอร์แซนด์บ็อกซ์ที่เรียกใช้ Trade Federation ได้ TODO: อนุญาตให้ส่งตัวเลือกไปยังแซนด์บ็อกซ์

สรุป

ตัวสร้างแบบสาธารณะ

TradefedSandbox()

เมธอดสาธารณะ

String createClasspath(File workingDir)

สร้าง classpath ตามสภาพแวดล้อมและไดเรกทอรีการทำงานที่ getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) แสดงผล

IConfiguration createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)

โหมดพิเศษตัดการเชื่อมต่อจากการเรียกใช้หลัก: เมื่อไม่มีการกำหนดค่าในไดเรกทอรีหลัก เราจะเปลี่ยนไปใช้ Thin Launcher ซึ่งจะพยายามตั้งค่าแซนด์บ็อกซ์ด้วยข้อมูลที่ทราบในปัจจุบัน และป้อนข้อมูลในไดเรกทอรีการทำงานเพื่อสร้างการกำหนดค่าอย่างสมบูรณ์ในไดเรกทอรีเวอร์ชัน

File getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)

แสดงผล TF ของสภาพแวดล้อมเสมือนจริงที่จะใช้ตามอาร์กิวเมนต์บรรทัดคำสั่ง

Exception prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

เตรียมสภาพแวดล้อมให้แซนด์บ็อกซ์ทํางานได้อย่างถูกต้อง

CommandResult run(IConfiguration config, ITestLogger logger)

เรียกใช้แซนด์บ็อกซ์ด้วยสภาพแวดล้อมที่ตั้งไว้

void tearDown()

ล้างสถานะ ไฟล์ หรือสภาพแวดล้อมที่อาจมีการเปลี่ยนแปลง

วิธีการที่มีการป้องกัน

File dumpGlobalConfig(IConfiguration config, exclusionPatterns)

แสดงการคัดลอกการกําหนดค่าส่วนกลางที่กรองจากออบเจ็กต์บางรายการ

Exception prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

เตรียม IConfiguration ที่จะส่งไปยังกระบวนการย่อยและจะขับเคลื่อนการเรียกใช้คอนเทนเนอร์

File prepareContext(IInvocationContext context, IConfiguration config)

เตรียมและจัดเรียง IInvocationContext

ตัวสร้างแบบสาธารณะ

TradefedSandbox

public TradefedSandbox ()

เมธอดสาธารณะ

createClasspath

public String createClasspath (File workingDir)

สร้าง classpath ตามสภาพแวดล้อมและไดเรกทอรีการทำงานที่ getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) แสดงผล

พารามิเตอร์
workingDir File: ไดเรกทอรีที่ใช้งานอยู่ในปัจจุบันสำหรับแซนด์บ็อกซ์
คิกรีเทิร์น
String เส้นทางคลาสที่จะใช้

การโยน
ConfigurationException

createThinLauncherConfig

public IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

โหมดพิเศษตัดการเชื่อมต่อจากการเรียกใช้หลัก: เมื่อไม่มีการกำหนดค่าในไดเรกทอรีหลัก เราจะเปลี่ยนไปใช้ Thin Launcher ซึ่งจะพยายามตั้งค่าแซนด์บ็อกซ์ด้วยข้อมูลที่ทราบในปัจจุบัน และป้อนข้อมูลในไดเรกทอรีการทำงานเพื่อสร้างการกำหนดค่าอย่างสมบูรณ์ในไดเรกทอรีเวอร์ชัน

พารามิเตอร์
args String: อาร์กิวเมนต์บรรทัดคำสั่งเดิม
keyStoreClient IKeyStoreClient: ไคลเอ็นต์คีย์สโตร์ปัจจุบันที่จะใช้สร้างการกำหนดค่า
runUtil IRunUtil: IRunUtil ที่ใช้อยู่ในปัจจุบันเพื่อเรียกใช้คำสั่งของโฮสต์
globalConfig File: การกําหนดค่าส่วนกลางที่จะใช้เรียกใช้กระบวนการย่อยของ TF
คิกรีเทิร์น
IConfiguration ไฟล์ที่ชี้ไปยัง XML การกําหนดค่าของ TF สําหรับออบเจ็กต์ NON_VERSIONED แสดงผล Null หากสร้างการกำหนดค่าตัวเปิดใช้งานแบบ Thin ไม่ได้

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

แสดงผล TF ของสภาพแวดล้อมเสมือนจริงที่จะใช้ตามอาร์กิวเมนต์บรรทัดคำสั่ง

พารามิเตอร์
context IInvocationContext: IInvocationContext ของผู้ปกครอง
nonVersionedConfig IConfiguration: IConfiguration ที่แสดงถึงออบเจ็กต์ที่ไม่มีเวอร์ชัน
args String: อาร์กิวเมนต์บรรทัดคำสั่ง
คิกรีเทิร์น
File ไดเรกทอรี ERROR(/File) ที่มี Jar สภาพแวดล้อมแซนด์บ็อกซ์ TF

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

เตรียมสภาพแวดล้อมให้แซนด์บ็อกซ์ทํางานได้อย่างถูกต้อง

พารามิเตอร์
context IInvocationContext: การเรียกใช้ปัจจุบัน IInvocationContext
config IConfiguration: IConfiguration เพื่อให้คำสั่งทำงาน
listener ITestInvocationListener: การเรียกใช้ปัจจุบัน ITestInvocationListener ที่ควรส่งผ่านผลลัพธ์สุดท้าย
คิกรีเทิร์น
Exception Exception ที่มีข้อมูลการดําเนินการที่ไม่สําเร็จ หรือ Null หากสําเร็จ

โฮมรัน

public CommandResult run (IConfiguration config, 
                ITestLogger logger)

เรียกใช้แซนด์บ็อกซ์ด้วยสภาพแวดล้อมที่ตั้งไว้

พารามิเตอร์
config IConfiguration: IConfiguration เพื่อให้คำสั่งทำงาน
logger ITestLogger: ITestLogger ที่เราบันทึกไฟล์ได้
คิกรีเทิร์น
CommandResult CommandResult พร้อมสถานะของการเรียกใช้แซนด์บ็อกซ์และบันทึก

tearDown

public void tearDown ()

ล้างสถานะ ไฟล์ หรือสภาพแวดล้อมที่อาจมีการเปลี่ยนแปลง

วิธีการที่มีการป้องกัน

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

แสดงการคัดลอกการกําหนดค่าส่วนกลางที่กรองจากออบเจ็กต์บางรายการ

พารามิเตอร์
config IConfiguration

exclusionPatterns

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

การโยน
ConfigurationException

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

เตรียม IConfiguration ที่จะส่งไปยังกระบวนการย่อยและจะขับเคลื่อนการเรียกใช้คอนเทนเนอร์

พารามิเตอร์
context IInvocationContext: IInvocationContext ในปัจจุบัน
config IConfiguration: IConfiguration ที่จะเตรียม
listener ITestInvocationListener: การเรียกใช้ปัจจุบัน ITestInvocationListener
คิกรีเทิร์น
Exception ข้อยกเว้นหากเกิดข้อผิดพลาดขึ้น หรือเป็นค่าว่างหากไม่เกิดข้อผิดพลาด

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

เตรียมและจัดเรียง IInvocationContext

พารามิเตอร์
context IInvocationContext: IInvocationContext ที่จะเตรียม
config IConfiguration: IConfiguration ของแซนด์บ็อกซ์
คิกรีเทิร์น
File IInvocationContext ที่แปลงเป็นอนุกรม