Bộ lập trình ICommand

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

Trình lập lịch biểu để chạy các lệnh TradeFederation.

Tóm tắt

Lớp lồng ghép

interface ICommandScheduler.IScheduledInvocationListener

Trình nghe các sự kiện gọi khi lệnh gọi hoàn tất. 

Phương thức công khai

abstract boolean addCommand(String[] args)

Thêm một lệnh vào trình lập lịch biểu.

abstract void addCommandFile(String cmdFile, extraArgs)

Thêm tất cả các lệnh từ tệp đã cho vào trình lập lịch biểu

abstract void await()

Chờ trình lập lịch biểu bắt đầu chạy, bao gồm cả chờ hoàn tất quá trình chuyển giao từ TF cũ nếu có.

abstract void completeHandover()

Thông báo cho trình lập lịch biểu lệnh rằng trình tự chuyển giao được khởi tạo đã hoàn tất và phải khởi động lại trình quản lý từ xa trên cổng mặc định.

abstract void displayCommandQueue(PrintWriter printWriter)

Xuất thông tin gỡ lỗi chi tiết về trạng thái của hàng đợi thực thi lệnh.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

Xuất danh sách các lệnh hiện tại.

abstract void displayInvocationsInfo(PrintWriter printWriter)

Cho thấy danh sách lệnh gọi hiện tại.

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

Kết xuất tệp xml mở rộng cho lệnh bằng tất cả Đã chỉ định giá trị Option cho tất cả các lệnh hiện tại.

abstract void execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

Phân bổ trực tiếp một thiết bị và thực thi một lệnh mà không cần thêm thiết bị đó vào hàng đợi lệnh bằng cách sử dụng IInvocationContext có sẵn.

abstract void execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)

Phân bổ trực tiếp một thiết bị và thực thi một lệnh mà không cần thêm thiết bị đó vào hàng đợi lệnh.

abstract void execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)

Thực thi trực tiếp lệnh trên thiết bị đã được phân bổ.

abstract CommandFileWatcher getCommandFileWatcher()

Lấy CommandFileWatcher thích hợp cho trình lập lịch biểu này

abstract int getExecutingCommandCount()

Trả về số lượng Lệnh ở trạng thái thực thi.

abstract String getInvocationInfo(int invocationId)

Trả về thông tin trên một bu lệnh gọi chỉ định id gọi.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

Trả về mã lỗi của lệnh gọi gần đây nhất đã chạy.

abstract Throwable getLastInvocationThrowable()

Trả về Throwable từ lệnh gọi gần đây nhất đã chạy.

abstract int getReadyCommandCount()

Trả về số lượng Lệnh ở trạng thái sẵn sàng trong hàng đợi.

abstract void handoverInitiationComplete()

Thông báo cho trình lập lịch biểu lệnh rằng quá trình chuyển giao thiết bị và lệnh đang được sử dụng lần đầu tiên đã hoàn tất và có thể bắt đầu lên lịch hoạt động.

abstract boolean handoverShutdown(int handoverPort)

Bắt đầu một shutdown() và chuyển giao sang một quy trình giao dịch khác trên cùng một máy chủ lưu trữ này.

abstract void join()

Chờ trình lập lịch biểu hoàn tất.

abstract void join(long millis)

Chờ trình lập lịch biểu hoàn tất hoặc hết thời gian chờ sau khoảng thời gian được chỉ định bằng mili giây.

abstract void removeAllCommands()

Xoá tất cả các lệnh khỏi trình lập lịch biểu

abstract void setClearcutClient(ClearcutClient client)

Thiết lập ứng dụng để báo cáo dữ liệu khai thác

abstract boolean shouldShutdownOnCmdfileError()

Trả về giá trị true nếu chúng ta cần tắt trình lập lịch biểu khi gặp lỗi lệnh

abstract void shutdown()

Cố gắng tắt trình lập lịch biểu lệnh một cách linh hoạt.

abstract void shutdownHard(boolean killAdb)

Cố gắng tắt trình lập lịch biểu lệnh.

abstract void shutdownHard()

Cố gắng tắt trình lập lịch biểu lệnh.

abstract void shutdownOnEmpty()

Tương tự như shutdown(), nhưng sẽ đợi tất cả các lệnh được thực thi trước khi thoát.

abstract void start()

Khởi động ICommandScheduler.

abstract boolean stopInvocation(int invocationId, String cause)

Dừng một lệnh gọi đang chạy bằng cách chỉ định mã nhận dạng của lệnh gọi đó.

default boolean stopInvocation(int invocationId)

Dừng một lệnh gọi đang chạy bằng cách chỉ định mã nhận dạng của lệnh gọi đó.

abstract boolean stopInvocation(ITestInvocation invocation)

Dừng một lệnh gọi đang chạy.

Phương thức công khai

addCommand

public abstract boolean addCommand (String[] args)

Thêm một lệnh vào trình lập lịch biểu.

Lệnh về cơ bản là một thực thể của cấu hình cần chạy cũng như các đối số liên quan.

Nếu "--help" Đối số được chỉ định văn bản trợ giúp cho cấu hình sẽ được xuất sang stdout. Nếu không, cấu hình này sẽ được thêm vào hàng đợi để chạy.

Tham số
args String: các đối số cấu hình.
Giá trị trả về
boolean true nếu đã thêm lệnh thành công
Gửi
ConfigurationException không thể phân tích cú pháp lệnh if

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Thêm tất cả các lệnh từ tệp đã cho vào trình lập lịch biểu

Tham số
cmdFile String: đường dẫn hệ thống tệp của tệp comand
extraArgs : ERROR(/List) trong số String đối số để thêm vào mỗi lệnh được phân tích cú pháp khỏi tệp. Có thể để trống nhưng không được để trống.
Gửi
ConfigurationException nếu không thể phân tích cú pháp tệp lệnh

Xem thêm:

đang chờ

public abstract void await ()

Chờ trình lập lịch biểu bắt đầu chạy, bao gồm cả chờ hoàn tất quá trình chuyển giao từ TF cũ nếu có.

hoàn tất quá trình chuyển giao

public abstract void completeHandover ()

Thông báo cho trình lập lịch biểu lệnh rằng trình tự chuyển giao được khởi tạo đã hoàn tất và phải khởi động lại trình quản lý từ xa trên cổng mặc định.

Hàng đợi displayCommand

public abstract void displayCommandQueue (PrintWriter printWriter)

Xuất thông tin gỡ lỗi chi tiết về trạng thái của hàng đợi thực thi lệnh.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Xuất danh sách các lệnh hiện tại.

Tham số
printWriter PrintWriter: ERROR(/PrintWriter) để xuất dữ liệu.
regex String: biểu thức chính quy cần được so khớp để được đã in. Nếu giá trị rỗng thì tất cả lệnh sẽ được in.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Cho thấy danh sách lệnh gọi hiện tại.

Tham số
printWriter PrintWriter: ERROR(/PrintWriter) để xuất dữ liệu.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Kết xuất tệp xml mở rộng cho lệnh bằng tất cả Đã chỉ định giá trị Option cho tất cả các lệnh hiện tại.

Tham số
printWriter PrintWriter: ERROR(/PrintWriter) để xuất trạng thái.
regex String: biểu thức chính quy cần được so khớp để có xml được kết xuất. Nếu giá trị rỗng, mọi lệnh sẽ được kết xuất.

execCommand

public abstract void execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

Phân bổ trực tiếp một thiết bị và thực thi một lệnh mà không cần thêm thiết bị đó vào hàng đợi lệnh bằng cách sử dụng IInvocationContext có sẵn.

Tham số
context IInvocationContext: một IInvocationContext hiện có.
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener cần nhận thông báo
args String: đối số lệnh
Gửi
ConfigurationException lệnh if không hợp lệ
NoDeviceException không có thiết bị nào để sử dụng

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

Phân bổ trực tiếp một thiết bị và thực thi một lệnh mà không cần thêm thiết bị đó vào hàng đợi lệnh.

Tham số
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener cần nhận thông báo
args String: đối số lệnh
Gửi
ConfigurationException lệnh if không hợp lệ
NoDeviceException không có thiết bị nào để sử dụng

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

Thực thi trực tiếp lệnh trên thiết bị đã được phân bổ.

Tham số
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener cần nhận thông báo
device ITestDevice: ITestDevice để sử dụng
args String: đối số lệnh
Gửi
ConfigurationException lệnh if không hợp lệ

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Lấy CommandFileWatcher thích hợp cho trình lập lịch biểu này

Giá trị trả về
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Trả về số lượng Lệnh ở trạng thái thực thi.

Giá trị trả về
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Trả về thông tin trên một bu lệnh gọi chỉ định id gọi.

Tham số
invocationId int: mã theo dõi của lệnh gọi.
Giá trị trả về
String String chứa thông tin về lệnh gọi.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Trả về mã lỗi của lệnh gọi gần đây nhất đã chạy. Trả về 0 (không có lỗi) nếu chưa có lệnh gọi nào chạy.

Giá trị trả về
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Trả về Throwable từ lệnh gọi gần đây nhất đã chạy. Trả về giá trị rỗng nếu không có lớp throwable.

Giá trị trả về
Throwable

getSẵn LệnhCount

public abstract int getReadyCommandCount ()

Trả về số lượng Lệnh ở trạng thái sẵn sàng trong hàng đợi.

Giá trị trả về
int

quá trình chuyển giao hoàn tất

public abstract void handoverInitiationComplete ()

Thông báo cho trình lập lịch biểu lệnh rằng quá trình chuyển giao thiết bị và lệnh đang được sử dụng lần đầu tiên đã hoàn tất và có thể bắt đầu lên lịch hoạt động.

tắt bàn giao

public abstract boolean handoverShutdown (int handoverPort)

Bắt đầu một shutdown() và chuyển giao sang một quy trình giao dịch khác trên cùng một máy chủ lưu trữ này.

Bộ lập lịch sẽ thông báo cho quy trình trao đổi từ xa đang nghe trên cổng thiết bị được giải phóng đó khi chúng trở nên khả dụng.

Tham số
handoverPort int

Giá trị trả về
boolean true nếu quá trình bắt đầu bàn giao thành công, false nếu không

tham gia

public abstract void join ()

Chờ trình lập lịch biểu hoàn tất.

Xem thêm:

tham gia

public abstract void join (long millis)

Chờ trình lập lịch biểu hoàn tất hoặc hết thời gian chờ sau khoảng thời gian được chỉ định bằng mili giây.

Tham số
millis long

Xem thêm:

removeAllCommands

public abstract void removeAllCommands ()

Xoá tất cả các lệnh khỏi trình lập lịch biểu

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Thiết lập ứng dụng để báo cáo dữ liệu khai thác

Tham số
client ClearcutClient

nênTắtOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Trả về giá trị true nếu chúng ta cần tắt trình lập lịch biểu khi gặp lỗi lệnh

Giá trị trả về
boolean

tắt máy

public abstract void shutdown ()

Cố gắng tắt trình lập lịch biểu lệnh một cách linh hoạt.

Xoá các lệnh đang chờ kiểm thử và yêu cầu tất cả lệnh gọi đang diễn ra tắt một cách dễ dàng.

Sau khi gọi quá trình tắt, vòng lặp chính của trình lập lịch biểu sẽ đợi tất cả các lệnh gọi đang diễn ra để hoàn tất trước khi thoát hoàn toàn.

CANNOT TRANSLATE

public abstract void shutdownHard (boolean killAdb)

Cố gắng tắt trình lập lịch biểu lệnh.

Tương tự như shutdown(), nhưng cũng sẽ tuỳ ý loại bỏ kết nối adb, trong một cố gắng 'truyền cảm hứng' đang thực hiện lệnh gọi để hoàn tất nhanh hơn.

Tham số
killAdb boolean

CANNOT TRANSLATE

public abstract void shutdownHard ()

Cố gắng tắt trình lập lịch biểu lệnh. Tương tự như TẮTHard(true).

tắt máy khi trống

public abstract void shutdownOnEmpty ()

Tương tự như shutdown(), nhưng sẽ đợi tất cả các lệnh được thực thi trước khi thoát.

Lưu ý rằng nếu có bất kỳ lệnh nào ở chế độ lặp lại, thì trình lập lịch biểu sẽ không bao giờ thoát.

start

public abstract void start ()

Khởi động ICommandScheduler.

Phải được gọi trước khi gọi các phương thức khác.

Sẽ chạy cho đến khi shutdown() được gọi. xem Thread.start().

dừngGọi

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Dừng một lệnh gọi đang chạy bằng cách chỉ định mã nhận dạng của lệnh gọi đó.

Tham số
invocationId int: mã theo dõi của lệnh gọi.
cause String: nguyên nhân khiến lệnh gọi dừng hoạt động.
Giá trị trả về
boolean true nếu lệnh gọi bị dừng, false nếu không gọi
Gửi
UnsupportedOperationException nếu quá trình triển khai không hỗ trợ điều này

dừngGọi

public boolean stopInvocation (int invocationId)

Dừng một lệnh gọi đang chạy bằng cách chỉ định mã nhận dạng của lệnh gọi đó.

Tham số
invocationId int

Giá trị trả về
boolean true nếu lệnh gọi bị dừng, false nếu không gọi
Gửi
UnsupportedOperationException nếu quá trình triển khai không hỗ trợ điều này

dừngGọi

public abstract boolean stopInvocation (ITestInvocation invocation)

Dừng một lệnh gọi đang chạy.

Tham số
invocation ITestInvocation

Giá trị trả về
boolean true nếu lệnh gọi bị dừng, false nếu không gọi
Gửi
UnsupportedOperationException nếu quá trình triển khai không hỗ trợ điều này