SyncService
public
class
SyncService
extends Object
| java.lang.Object | |
| ↳ | com.android.tradefed.device.server.SyncService |
Lớp dịch vụ đồng bộ hoá để đẩy/kéo đến/từ các thiết bị/trình mô phỏng, thông qua cầu gỡ lỗi.
Để lấy một đối tượng SyncService, hãy dùng IDevice.getSyncService().
Tóm tắt
Lớp lồng ghép | |
|---|---|
class |
SyncService.FileStat
|
interface |
SyncService.ISyncProgressMonitor
Các lớp triển khai giao diện này cung cấp các phương thức xử lý việc hiển thị tiến trình chuyển. |
Hàm khởi tạo công khai | |
|---|---|
SyncService(InetSocketAddress address, IDevice device)
Tạo một đối tượng dịch vụ Đồng bộ hoá. |
|
Phương thức công khai | |
|---|---|
void
|
close()
Đóng kết nối. |
static
SyncService.ISyncProgressMonitor
|
getNullProgressMonitor()
Trả về một trình theo dõi tiến trình đồng bộ hoá không làm gì cả. |
boolean
|
openSync()
Mở kết nối đồng bộ hoá. |
void
|
pull(FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)
Kéo(các) tệp hoặc(các) thư mục. |
void
|
pullFile(FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)
Kéo một tệp. |
void
|
pullFile(String remoteFilepath, String localFilename, SyncService.ISyncProgressMonitor monitor)
Kéo một tệp. |
void
|
push(String[] local, FileListingService.FileEntry remote, SyncService.ISyncProgressMonitor monitor)
Đẩy một số tệp hoặc thư mục. |
void
|
push(String[] local, String remote, SyncService.ISyncProgressMonitor monitor)
Đẩy một số tệp hoặc thư mục. |
void
|
pushFile(String local, String remote, SyncService.ISyncProgressMonitor monitor)
Đẩy một tệp. |
SyncService.FileStat
|
statFile(String path)
Trả về thông tin thống kê của tệp từ xa. |
Hàm khởi tạo công khai
SyncService
public SyncService (InetSocketAddress address,
IDevice device)Tạo một đối tượng dịch vụ Đồng bộ hoá.
| Tham số | |
|---|---|
address |
InetSocketAddress: Địa chỉ để kết nối |
device |
IDevice: IDevice mà dịch vụ kết nối. |
Phương thức công khai
đóng
public void close ()
Đóng kết nối.
getNullProgressMonitor
public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()
Trả về một trình theo dõi tiến trình đồng bộ hoá không làm gì cả. Điều này cho phép các tác vụ ở chế độ nền không muốn/cần hiển thị giao diện người dùng, chuyển một ISyncProgressMonitor hợp lệ.
Đối tượng này có thể được dùng lại nhiều lần và có thể được dùng bởi các luồng đồng thời.
| Giá trị trả về | |
|---|---|
SyncService.ISyncProgressMonitor |
|
openSync
public boolean openSync ()
Mở kết nối đồng bộ hoá. Bạn phải gọi phương thức này trước khi gọi push[File] / pull[File].
| Giá trị trả về | |
|---|---|
boolean |
true nếu kết nối được mở, false nếu adb từ chối kết nối. Điều này có thể xảy ra nếu IDevice không hợp lệ. |
| Gửi | |
|---|---|
TimeoutException |
trong trường hợp hết thời gian chờ kết nối. |
AdbCommandRejectedException |
nếu adb từ chối lệnh |
|
Nếu không kết nối được với adb. |
kéo
public void pull (FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)
Kéo(các) tệp hoặc(các) thư mục.
| Tham số | |
|---|---|
entries |
FileEntry: (các) mục từ xa cần kéo |
localPath |
String: Điểm đến tại địa phương. Nếu số lượng mục nhập > 1 hoặc nếu mục nhập duy nhất là một thư mục, thì đây phải là một thư mục. |
monitor |
SyncService.ISyncProgressMonitor: Trình theo dõi tiến trình. Không được rỗng. |
| Gửi | |
|---|---|
|
com.android.ddmlib.SyncException |
|
IOException |
|
com.android.ddmlib.TimeoutException |
SyncException |
|
TimeoutException |
|
pullFile
public void pullFile (FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)
Kéo một tệp.
| Tham số | |
|---|---|
remote |
FileListingService.FileEntry: tệp từ xa |
localFilename |
String: Điểm đến tại địa phương. |
monitor |
SyncService.ISyncProgressMonitor: Trình theo dõi tiến trình. Không được rỗng. |
| Gửi | |
|---|---|
|
trong trường hợp xảy ra ngoại lệ IO. |
TimeoutException |
trong trường hợp hết thời gian đọc phản hồi từ thiết bị. |
SyncException |
trong trường hợp xảy ra ngoại lệ đồng bộ hoá. |
pullFile
public void pullFile (String remoteFilepath,
String localFilename,
SyncService.ISyncProgressMonitor monitor)Kéo một tệp.
Vì phương thức này chỉ xử lý một chuỗi cho tệp từ xa thay vì FileEntry, nên kích thước của tệp đang được kéo sẽ không xác định và ISyncProgressMonitor sẽ không hiển thị đúng tiến trình
| Tham số | |
|---|---|
remoteFilepath |
String: đường dẫn đầy đủ đến tệp từ xa |
localFilename |
String: Điểm đến tại địa phương. |
monitor |
SyncService.ISyncProgressMonitor: Trình theo dõi tiến trình. Không được rỗng. |
| Gửi | |
|---|---|
|
trong trường hợp xảy ra ngoại lệ IO. |
TimeoutException |
trong trường hợp hết thời gian đọc phản hồi từ thiết bị. |
SyncException |
trong trường hợp xảy ra ngoại lệ đồng bộ hoá. |
Xem thêm:
đẩy
public void push (String[] local,
FileListingService.FileEntry remote,
SyncService.ISyncProgressMonitor monitor)Đẩy một số tệp hoặc thư mục.
| Tham số | |
|---|---|
local |
String: các tệp cục bộ cần đẩy |
remote |
FileListingService.FileEntry: FileEntry từ xa đại diện cho một thư mục |
monitor |
SyncService.ISyncProgressMonitor: Trình giám sát tiến trình |
| Gửi | |
|---|---|
SyncException |
nếu không thể đẩy một số tệp |
|
trong trường hợp xảy ra lỗi đầu vào/đầu ra trên kết nối |
TimeoutException |
trong trường hợp hết thời gian chờ đọc phản hồi từ thiết bị |
đẩy
public void push (String[] local,
String remote,
SyncService.ISyncProgressMonitor monitor)Đẩy một số tệp hoặc thư mục.
| Tham số | |
|---|---|
local |
String: các tệp cục bộ cần đẩy |
remote |
String: đường dẫn từ xa đại diện cho một thư mục |
monitor |
SyncService.ISyncProgressMonitor: Trình giám sát tiến trình |
| Gửi | |
|---|---|
SyncException |
nếu không thể đẩy một số tệp |
|
trong trường hợp xảy ra lỗi đầu vào/đầu ra trên kết nối |
TimeoutException |
trong trường hợp hết thời gian chờ đọc phản hồi từ thiết bị |
pushFile
public void pushFile (String local,
String remote,
SyncService.ISyncProgressMonitor monitor)Đẩy một tệp.
| Tham số | |
|---|---|
local |
String: đường dẫn tệp cục bộ. |
remote |
String: Đường dẫn tệp từ xa. |
monitor |
SyncService.ISyncProgressMonitor: Trình theo dõi tiến trình. Không được rỗng. |
| Gửi | |
|---|---|
SyncException |
nếu không thể đẩy tệp |
|
trong trường hợp xảy ra lỗi đầu vào/đầu ra trên kết nối. |
TimeoutException |
trong trường hợp hết thời gian đọc phản hồi từ thiết bị. |
statFile
public SyncService.FileStat statFile (String path)
Trả về thông tin stat của tệp từ xa.
| Tham số | |
|---|---|
path |
String: tệp từ xa |
| Giá trị trả về | |
|---|---|
SyncService.FileStat |
FileStat chứa chế độ, kích thước và thông tin sửa đổi gần đây nhất nếu mọi thứ diễn ra suôn sẻ hoặc giá trị rỗng nếu không |
| Gửi | |
|---|---|
|
IOException |
TimeoutException |
trong trường hợp hết thời gian đọc phản hồi từ thiết bị. |