GCSBucketUtil

public class GCSBucketUtil
extends Object

java.lang.Object
   ↳ com.android.tradefed.util.GCSBucketUtil


أداة إدارة الملفات لتنزيل الملفات وتحميلها من Google Cloud Storage (GCS)

يجب عدم استخدام هذه الفئة من نطاق الاختبار (أي IRemoteTest). تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة GCSFileDownloader بدلاً منها.

ملخّص

الصفوف المتداخلة

class GCSBucketUtil.GCSFileMetadata

برنامج تضمين بسيط لمعلومات الملف في GCS. 

طُرق وضع التصميم العامة

GCSBucketUtil(String bucketName)

الإجراءات العامة

CommandResult copy(String source, String dest)

نسخ ملف أو دليل إلى الحزمة أو منها

int getAttempts()
String getBotoConfig()
String getBotoPath()
String getBucketName()
boolean getNoClobber()
boolean getParallel()
boolean getRecursive()
long getRetryInterval()
long getTimeout()
boolean isFile(String path)

التحقّق مما إذا كان عنصر GCS ملفًا أو ليس ملفًا (مجلدًا)

List<String> ls(Path bucketPath)

إدراج الملفات ضمن مسار GCS

CommandResult makeBucket(String projectId)

أنشئ حزمة GCS.

String md5Hash(File localFile)

احسب تجزئة MD5 للملف المحلي.

CommandResult pull(Path bucketPath)

تنزيل ملف أو دليل من حزمة GCS إلى الدليل الحالي

CommandResult pull(Path bucketPath, File localFile)

تنزيل ملف أو دليل من حزمة GCS

String pullContents(Path bucketPath)

نزِّل ملفًا من حزمة GCS واستخرِج محتواه.

CommandResult push(File localFile)

حمِّل ملفًا أو دليلًا محليًا إلى حزمة GCS.

CommandResult push(File localFile, Path bucketPath)

حمِّل ملفًا أو دليلاً محليًا إلى حزمة GCS باستخدام مسار محدّد.

CommandResult pushString(String contents, Path bucketPath)

حمِّل سلسلة إلى حزمة GCS.

CommandResult remove(String pattern, boolean force)

إزالة ملف أو دليل من الحزمة

CommandResult remove(Path path, boolean force)

إزالة ملف أو دليل من الحزمة

CommandResult remove(Path path)

إزالة ملف أو دليل من الحزمة

CommandResult remove(String pattern)

إزالة ملف أو دليل من الحزمة

CommandResult removeBucket()

إزالة حزمة GCS

void setAttempts(int attempts)
void setBotoConfig(String botoConfig)
void setBotoPath(String botoPath)
void setBucketName(String bucketName)
void setNoClobber(boolean noClobber)
void setParallel(boolean parallel)
void setRecursive(boolean recursive)
void setRetryInterval(long retryInterval)
void setTimeout(long timeout, TimeUnit unit)
void setTimeoutMs(long timeout)
GCSBucketUtil.GCSFileMetadata stat(Path bucketPath)

احصل على حالة الملف لمسار GCS.

طُرق محمية

IRunUtil getRunUtil()

طُرق وضع التصميم العامة

GCSBucketUtil

public GCSBucketUtil (String bucketName)

المعلَمات
bucketName String

الإجراءات العامة

نسخ

public CommandResult copy (String source, 
                String dest)

نسخ ملف أو دليل إلى الحزمة أو منها

المعلَمات
source String: ملف المصدر أو النمط

dest String: ملف الوجهة أو نمطها

المرتجعات
CommandResult CommandResult نتيجة العملية

عمليات الطرح
IOException

getAttempts

public int getAttempts ()

المرتجعات
int

getBotoConfig

public String getBotoConfig ()

المرتجعات
String

getBotoPath

public String getBotoPath ()

المرتجعات
String

getBucketName

public String getBucketName ()

المرتجعات
String

getNoClobber

public boolean getNoClobber ()

المرتجعات
boolean

getParallel

public boolean getParallel ()

المرتجعات
boolean

getRecursive

public boolean getRecursive ()

المرتجعات
boolean

getRetryInterval

public long getRetryInterval ()

المرتجعات
long

getTimeout

public long getTimeout ()

المرتجعات
long

isFile

public boolean isFile (String path)

التحقّق مما إذا كان عنصر GCS ملفًا أو ليس ملفًا (مجلدًا)

إذا انتهى اسم الملف بـ "/"، يعني ذلك أنّه مجلد. من المفترض أن يعرض الأمر gsutil ls gs://filename النتيجة gs://filename إذا كان الملف عبارة عن ملف. من المفترض أن يعرض الأمر gsutil ls gs://folder name الملفات الموجودة في المجلد إذا كان المجلد يتضمّن ملفات. وستعرض gs://folder/ إذا لم تكن هناك ملفات في المجلد.

المعلَمات
path String: المسار النسبي إلى الحزمة.

المرتجعات
boolean إذا كان ملفًا أو لا

عمليات الطرح
java.io.IOException
IOException

ls

public List<String> ls (Path bucketPath)

إدراج الملفات ضمن مسار GCS

المعلَمات
bucketPath Path: مسار GCS

المرتجعات
List<String> قائمة Strings التي تمثّل ملفات ضمن مسار GCS

عمليات الطرح
java.io.IOException
IOException

makeBucket

public CommandResult makeBucket (String projectId)

أنشئ حزمة GCS.

المعلَمات
projectId String

المرتجعات
CommandResult CommandResult نتيجة العملية

عمليات الطرح
java.io.IOException
IOException

md5Hash

public String md5Hash (File localFile)

احسب تجزئة MD5 للملف المحلي.

المعلَمات
localFile File: ملف محلي

المرتجعات
String تجزئة MD5 للملف المحلي

عمليات الطرح
java.io.IOException
IOException

سحب

public CommandResult pull (Path bucketPath)

تنزيل ملف أو دليل من حزمة GCS إلى الدليل الحالي

المعلَمات
bucketPath Path: مسار الملف في حزمة GCS

المرتجعات
CommandResult CommandResult نتيجة العملية

عمليات الطرح
IOException

سحب

public CommandResult pull (Path bucketPath, 
                File localFile)

تنزيل ملف أو دليل من حزمة GCS

المعلَمات
bucketPath Path: مسار الملف في حزمة GCS

localFile File: مسار الوجهة المحلية

المرتجعات
CommandResult CommandResult نتيجة العملية

عمليات الطرح
IOException

pullContents

public String pullContents (Path bucketPath)

نزِّل ملفًا من حزمة GCS واستخرِج محتواه.

المعلَمات
bucketPath Path: مسار الملف في حزمة GCS

المرتجعات
String محتوى السلسلة في الملف

عمليات الطرح
IOException

إرسال

public CommandResult push (File localFile)

حمِّل ملفًا أو دليلًا محليًا إلى حزمة GCS.

المعلَمات
localFile File: ملف أو دليل محلي

المرتجعات
CommandResult CommandResult نتيجة العملية

عمليات الطرح
IOException

إرسال

public CommandResult push (File localFile, 
                Path bucketPath)

حمِّل ملفًا أو دليلاً محليًا إلى حزمة GCS باستخدام مسار محدّد.

المعلَمات
localFile File: ملف أو دليل محلي

bucketPath Path: مسار الملف في حزمة GCS

المرتجعات
CommandResult CommandResult نتيجة العملية

عمليات الطرح
IOException

pushString

public CommandResult pushString (String contents, 
                Path bucketPath)

حمِّل سلسلة إلى حزمة GCS.

المعلَمات
contents String: محتوى الملف، كسلسلة

bucketPath Path: مسار الملف في حزمة GCS

المرتجعات
CommandResult CommandResult نتيجة العملية

عمليات الطرح
IOException

إزالة

public CommandResult remove (String pattern, 
                boolean force)

إزالة ملف أو دليل من الحزمة

المعلَمات
pattern String: الملف أو الدليل أو النمط المطلوب إزالته

force boolean: ما إذا كان سيتم تجاهل حالات التعذّر والمتابعة بدون تنبيه (لن يتم عرض أي خطأ)

المرتجعات
CommandResult

عمليات الطرح
IOException

إزالة

public CommandResult remove (Path path, 
                boolean force)

إزالة ملف أو دليل من الحزمة

المعلَمات
path Path: مسار الإزالة

force boolean: ما إذا كان سيحدث خطأ إذا لم يكن الملف متوفّرًا

المرتجعات
CommandResult

عمليات الطرح
IOException

إزالة

public CommandResult remove (Path path)

إزالة ملف أو دليل من الحزمة

المعلَمات
path Path: مسار الإزالة

المرتجعات
CommandResult

عمليات الطرح
IOException

إزالة

public CommandResult remove (String pattern)

إزالة ملف أو دليل من الحزمة

المعلَمات
pattern String: الملف أو الدليل أو النمط المطلوب إزالته

المرتجعات
CommandResult

عمليات الطرح
IOException

removeBucket

public CommandResult removeBucket ()

إزالة حزمة GCS

المرتجعات
CommandResult

عمليات الطرح
java.io.IOException
IOException

setAttempts

public void setAttempts (int attempts)

المعلَمات
attempts int

setBotoConfig

public void setBotoConfig (String botoConfig)

المعلَمات
botoConfig String

setBotoPath

public void setBotoPath (String botoPath)

المعلَمات
botoPath String

setBucketName

public void setBucketName (String bucketName)

المعلَمات
bucketName String

setNoClobber

public void setNoClobber (boolean noClobber)

المعلَمات
noClobber boolean

setParallel

public void setParallel (boolean parallel)

المعلَمات
parallel boolean

setRecursive

public void setRecursive (boolean recursive)

المعلَمات
recursive boolean

setRetryInterval

public void setRetryInterval (long retryInterval)

المعلَمات
retryInterval long

setTimeout

public void setTimeout (long timeout, 
                TimeUnit unit)

المعلَمات
timeout long

unit TimeUnit

setTimeoutMs

public void setTimeoutMs (long timeout)

المعلَمات
timeout long

stat

public GCSBucketUtil.GCSFileMetadata stat (Path bucketPath)

احصل على حالة الملف لمسار GCS.

المعلَمات
bucketPath Path: مسار GCS

المرتجعات
GCSBucketUtil.GCSFileMetadata GCSFileMetadata لمسار GCS

عمليات الطرح
java.io.IOException
IOException

طُرق محمية

getRunUtil

protected IRunUtil getRunUtil ()

المرتجعات
IRunUtil