SyncService

public class SyncService
extends Object implements AutoCloseable

java.lang.Object
   ↳ com.android.tradefed.device.server.SyncService

सिंक सेवा क्लास, डिवाइसों/इम्यूलेटर से डेटा को पुश/पुल करने के लिए होती है. इसके लिए, डीबग ब्रिज का इस्तेमाल किया जाता है.

SyncService ऑब्जेक्ट पाने के लिए, IDevice.getSyncService() का इस्तेमाल करें.

खास जानकारी

नेस्टेड क्लास

class SyncService.FileStat

 

interface SyncService.ISyncProgressMonitor

इस इंटरफ़ेस को लागू करने वाली क्लास, ऐसे तरीके उपलब्ध कराती हैं जिनसे ट्रांसफ़र की प्रोग्रेस दिखाई जाती है. 

सार्वजनिक कंस्ट्रक्टर

SyncService(InetSocketAddress address, IDevice device)

यह फ़ंक्शन, Sync service ऑब्जेक्ट बनाता है.

पब्लिक मेथड

void close()

इससे कनेक्शन बंद हो जाता है.

static SyncService.ISyncProgressMonitor getNullProgressMonitor()

यह एक ऐसा सिंक प्रोग्रेस मॉनिटर दिखाता है जो कुछ नहीं करता.

boolean openSync()

सिंक कनेक्शन खोलता है.

void pull(FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)

फ़ाइलें या फ़ोल्डर डाउनलोड करता है.

void pullFile(FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)

एक फ़ाइल डाउनलोड करता है.

void pullFile(String remoteFilepath, String localFilename, SyncService.ISyncProgressMonitor monitor)

एक फ़ाइल डाउनलोड करता है.

void push(String[] local, FileListingService.FileEntry remote, SyncService.ISyncProgressMonitor monitor)

कई फ़ाइलों या डायरेक्ट्री को पुश करता है.

void push(String[] local, String remote, SyncService.ISyncProgressMonitor monitor)

कई फ़ाइलों या डायरेक्ट्री को पुश करता है.

void pushFile(String local, String remote, SyncService.ISyncProgressMonitor monitor)

किसी एक फ़ाइल को पुश करें.

SyncService.FileStat statFile(String path)

यह कुकी, रिमोट फ़ाइल के आंकड़ों की जानकारी दिखाती है.

सार्वजनिक कंस्ट्रक्टर

SyncService

public SyncService (InetSocketAddress address, 
                IDevice device)

यह फ़ंक्शन, Sync service ऑब्जेक्ट बनाता है.

पैरामीटर
address InetSocketAddress: कनेक्ट करने के लिए पता
device IDevice: वह IDevice जिससे सेवा कनेक्ट होती है.

पब्लिक मेथड

बंद करें

public void close ()

इससे कनेक्शन बंद हो जाता है.

getNullProgressMonitor

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

यह एक ऐसा सिंक प्रोग्रेस मॉनिटर दिखाता है जो कुछ नहीं करता. इससे बैकग्राउंड टास्क, मान्य ISyncProgressMonitor पास कर सकते हैं. इन टास्क को यूज़र इंटरफ़ेस (यूआई) दिखाने की ज़रूरत नहीं होती.

इस ऑब्जेक्ट का इस्तेमाल एक से ज़्यादा बार किया जा सकता है. साथ ही, इसका इस्तेमाल एक साथ कई थ्रेड कर सकती हैं.

रिटर्न
SyncService.ISyncProgressMonitor

openSync

public boolean openSync ()

सिंक कनेक्शन खोलता है. push[File] / pull[File] को कॉल करने से पहले, इसे कॉल करना ज़रूरी है.

रिटर्न
boolean कनेक्शन खुलने पर, यह वैल्यू सही होती है. अगर adb कनेक्शन को अस्वीकार करता है, तो यह वैल्यू गलत होती है. ऐसा तब हो सकता है, जब IDevice अमान्य हो.
थ्रो
AdbCommandRejectedException अगर adb निर्देश को अस्वीकार करता है
TimeoutException कनेक्शन टाइम आउट होने पर.
IOException अगर adb से कनेक्ट नहीं किया जा सका.

पुल

public void pull (FileEntry[] entries, 
                String localPath, 
                SyncService.ISyncProgressMonitor monitor)

फ़ाइलें या फ़ोल्डर डाउनलोड करता है.

पैरामीटर
entries FileEntry: पुल करने के लिए रिमोट आइटम
localPath String: स्थानीय डेस्टिनेशन. अगर एंट्री की संख्या 1 से ज़्यादा है या यूनीक एंट्री कोई फ़ोल्डर है, तो यह फ़ोल्डर होना चाहिए.
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर. इसे शून्य नहीं किया जा सकता.
थ्रो
com.android.ddmlib.SyncException
com.android.ddmlib.TimeoutException
java.io.IOException
IOException
SyncException
TimeoutException

pullFile

public void pullFile (FileListingService.FileEntry remote, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

एक फ़ाइल डाउनलोड करता है.

पैरामीटर
remote FileListingService.FileEntry: रिमोट फ़ाइल
localFilename String: स्थानीय डेस्टिनेशन.
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर. इसे शून्य नहीं किया जा सकता.
थ्रो
SyncException सिंक करने में समस्या आने पर.
TimeoutException डिवाइस से जवाब पाने में समय लगने पर.
IOException IO से जुड़ी गड़बड़ी होने पर.

pullFile

public void pullFile (String remoteFilepath, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

एक फ़ाइल डाउनलोड करता है.

इस तरीके में, रिमोट फ़ाइल के लिए सिर्फ़ एक स्ट्रिंग का इस्तेमाल किया जाता है, न कि FileEntry का. इसलिए, पुल की जा रही फ़ाइल का साइज़ पता नहीं चलता. साथ ही, ISyncProgressMonitor प्रोग्रेस को सही तरीके से नहीं दिखाएगा

पैरामीटर
remoteFilepath String: रिमोट फ़ाइल का पूरा पाथ
localFilename String: स्थानीय डेस्टिनेशन.
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर. इसे शून्य नहीं किया जा सकता.
थ्रो
SyncException सिंक करने में समस्या आने पर.
TimeoutException डिवाइस से जवाब पाने में समय लगने पर.
IOException IO से जुड़ी गड़बड़ी होने पर.

यह भी देखें:

पुश

public void push (String[] local, 
                FileListingService.FileEntry remote, 
                SyncService.ISyncProgressMonitor monitor)

कई फ़ाइलों या डायरेक्ट्री को पुश करता है.

पैरामीटर
local String: पुश करने के लिए स्थानीय फ़ाइलें
remote FileListingService.FileEntry: डायरेक्ट्री को दिखाने वाला रिमोट FileEntry
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर
थ्रो
SyncException अगर कुछ फ़ाइलें पुश नहीं की जा सकीं
TimeoutException डिवाइस से जवाब पाने में समय लगने पर
IOException कनेक्शन पर I/O गड़बड़ी होने पर

पुश

public void push (String[] local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

कई फ़ाइलों या डायरेक्ट्री को पुश करता है.

पैरामीटर
local String: पुश करने के लिए स्थानीय फ़ाइलें
remote String: डायरेक्ट्री को दिखाने वाला रिमोट पाथ
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर
थ्रो
SyncException अगर कुछ फ़ाइलें पुश नहीं की जा सकीं
TimeoutException डिवाइस से जवाब पाने में समय लगने पर
IOException कनेक्शन पर I/O गड़बड़ी होने पर

pushFile

public void pushFile (String local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

किसी एक फ़ाइल को पुश करें.

पैरामीटर
local String: यह लोकल फ़ाइलपाथ है.
remote String: रिमोट फ़ाइलपाथ.
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर. इसे शून्य नहीं किया जा सकता.
थ्रो
SyncException अगर फ़ाइल को पुश नहीं किया जा सका
TimeoutException डिवाइस से जवाब पाने में समय लगने पर.
IOException कनेक्शन पर I/O में गड़बड़ी होने पर.

statFile

public SyncService.FileStat statFile (String path)

यह कुकी, रिमोट फ़ाइल के आंकड़ों की जानकारी दिखाती है.

पैरामीटर
path String: रिमोट फ़ाइल
रिटर्न
SyncService.FileStat अगर सब कुछ ठीक रहा, तो FileStat ऑब्जेक्ट में मोड, साइज़, और पिछली बार बदलाव करने की जानकारी होगी. अगर ऐसा नहीं होता है, तो यह ऑब्जेक्ट null होगा
थ्रो
TimeoutException डिवाइस से जवाब पाने में समय लगने पर.
java.io.IOException
IOException