GCS 值區公用程式
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 檔案是否為檔案 (或不是檔案)。 |
|
ls(Path bucketPath)
列出 GCS 路徑下的檔案。 |
CommandResult
|
makeBucket(String projectId)
建立 GCS 值區。 |
String
|
md5Hash(File localFile)
計算本機檔案的 md5 雜湊。 |
CommandResult
|
pull(Path bucketPath, File localFile)
從 GCS 值區下載檔案或目錄。 |
CommandResult
|
pull(Path bucketPath)
將檔案或目錄從 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()
|
公用建構函式
GCS 值區公用程式
public GCSBucketUtil (String bucketName)
參數 | |
---|---|
bucketName |
String |
公用方法
複製
public CommandResult copy (String source, String dest)
將檔案或目錄複製到值區,或是從值區複製檔案或目錄。
參數 | |
---|---|
source |
String :來源檔案或模式 |
dest |
String :目的地檔案或模式 |
傳回 | |
---|---|
CommandResult |
CommandResult 作業的結果。 |
get 嘗試次數
public int getAttempts ()
傳回 | |
---|---|
int |
getBotoConfig
public String getBotoConfig ()
傳回 | |
---|---|
String |
getBotoPath
public String getBotoPath ()
傳回 | |
---|---|
String |
取得值區名稱
public String getBucketName ()
傳回 | |
---|---|
String |
getNoClobber
public boolean getNoClobber ()
傳回 | |
---|---|
boolean |
getParallel
public boolean getParallel ()
傳回 | |
---|---|
boolean |
getRecursive
public boolean getRecursive ()
傳回 | |
---|---|
boolean |
get 重試 Interval
public long getRetryInterval ()
傳回 | |
---|---|
long |
getTimeout
public long getTimeout ()
傳回 | |
---|---|
long |
isFile
public boolean isFile (String path)
請檢查 GCS 檔案是否為檔案 (或不是檔案)。
如果檔案名稱結尾為「/」,表示該檔案名稱為資料夾。gsutil ls gs://filename 應會傳回 例如 gs://filenamegsutil ls gs://folder 名稱應會傳回 資料夾如果沒有檔案,會傳回 gs://folder/ 再前往該資料夾
參數 | |
---|---|
path |
String :相對於值區的路徑。 |
傳回 | |
---|---|
boolean |
請儲存是否為檔案 |
擲回 | |
---|---|
|
IOException |
標準
publicls (Path bucketPath)
列出 GCS 路徑下的檔案。
參數 | |
---|---|
bucketPath |
Path :GCS 路徑 |
傳回 | |
---|---|
|
GCS 路徑下的檔案 String 清單 |
擲回 | |
---|---|
|
IOException |
MakeBucket
public CommandResult makeBucket (String projectId)
建立 GCS 值區。
參數 | |
---|---|
projectId |
String |
傳回 | |
---|---|
CommandResult |
CommandResult 作業的結果。 |
擲回 | |
---|---|
|
IOException |
md5 雜湊
public String md5Hash (File localFile)
計算本機檔案的 md5 雜湊。
參數 | |
---|---|
localFile |
File :本機檔案 |
傳回 | |
---|---|
String |
本機檔案的 md5 雜湊。 |
擲回 | |
---|---|
|
IOException |
提取
public CommandResult pull (Path bucketPath, File localFile)
從 GCS 值區下載檔案或目錄。
參數 | |
---|---|
bucketPath |
Path :GCS 值區中的檔案路徑 |
localFile |
File :本機目的地路徑 |
傳回 | |
---|---|
CommandResult |
CommandResult 作業的結果。 |
提取
public CommandResult pull (Path bucketPath)
將檔案或目錄從 GCS 值區下載至目前的目錄。
參數 | |
---|---|
bucketPath |
Path :GCS 值區中的檔案路徑 |
傳回 | |
---|---|
CommandResult |
CommandResult 作業的結果。 |
提取內容
public String pullContents (Path bucketPath)
從 GCS 值區下載檔案,並擷取其中內容。
參數 | |
---|---|
bucketPath |
Path :GCS 值區中的檔案路徑 |
傳回 | |
---|---|
String |
檔案的字串內容 |
推播
public CommandResult push (File localFile)
將本機檔案或目錄上傳至 GCS 值區。
參數 | |
---|---|
localFile |
File :本機檔案或目錄 |
傳回 | |
---|---|
CommandResult |
CommandResult 作業的結果。 |
推播
public CommandResult push (File localFile, Path bucketPath)
將本機檔案或目錄上傳至具有特定路徑的 GCS 值區。
參數 | |
---|---|
localFile |
File :本機檔案或目錄 |
bucketPath |
Path :GCS 值區中的檔案路徑 |
傳回 | |
---|---|
CommandResult |
CommandResult 作業的結果。 |
推送字串
public CommandResult pushString (String contents, Path bucketPath)
將字串上傳至 GCS 值區。
參數 | |
---|---|
contents |
String :以字串形式的檔案內容 |
bucketPath |
Path :GCS 值區中的檔案路徑 |
傳回 | |
---|---|
CommandResult |
CommandResult 作業的結果。 |
移除
public CommandResult remove (String pattern, boolean force)
從值區中移除檔案或目錄。
參數 | |
---|---|
pattern |
String :要移除的檔案、目錄或模式。 |
force |
boolean :是否要忽略失敗並無聲繼續 (不會擲回) |
傳回 | |
---|---|
CommandResult |
移除
public CommandResult remove (Path path, boolean force)
從值區中移除檔案或目錄。
參數 | |
---|---|
path |
Path :移除路徑 |
force |
boolean :如果檔案不存在時是否會失敗 |
傳回 | |
---|---|
CommandResult |
移除
public CommandResult remove (String pattern)
從值區中移除檔案或目錄。
參數 | |
---|---|
pattern |
String :要移除的檔案、目錄或模式。 |
傳回 | |
---|---|
CommandResult |
設定嘗試次數
public void setAttempts (int attempts)
參數 | |
---|---|
attempts |
int |
setBotoConfig
public void setBotoConfig (String botoConfig)
參數 | |
---|---|
botoConfig |
String |
setBotoPath
public void setBotoPath (String botoPath)
參數 | |
---|---|
botoPath |
String |
設定值區名稱
public void setBucketName (String bucketName)
參數 | |
---|---|
bucketName |
String |
setNoClobber
public void setNoClobber (boolean noClobber)
參數 | |
---|---|
noClobber |
boolean |
setParallel
public void setParallel (boolean parallel)
參數 | |
---|---|
parallel |
boolean |
遞迴
public void setRecursive (boolean recursive)
參數 | |
---|---|
recursive |
boolean |
設定重試間隔
public void setRetryInterval (long retryInterval)
參數 | |
---|---|
retryInterval |
long |
設定逾時
public void setTimeout (long timeout, TimeUnit unit)
參數 | |
---|---|
timeout |
long |
unit |
TimeUnit |
setTimeoutMs
public void setTimeoutMs (long timeout)
參數 | |
---|---|
timeout |
long |
統計資料
public GCSBucketUtil.GCSFileMetadata stat (Path bucketPath)
取得 GCS 路徑的檔案狀態。
參數 | |
---|---|
bucketPath |
Path :GCS 路徑 |
傳回 | |
---|---|
GCSBucketUtil.GCSFileMetadata |
GCS 路徑的 GCSFileMetadata |
擲回 | |
---|---|
|
IOException |