+ * The returned value is a UTC time in the format of + * "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", e.g. "2016-03-04T17:01:02.629Z". + *
+ * + * @return the formatted UTC time of the bucket creation + */ + public String getCreated() { + return created; + } + + /** + * Checks if the bucket name has been decrypted successfully with the + * {@link Storj#importKeys(Keys, String) imported keys}. + * + *+ * If the bucket name has been decrypted successfully then {@link #getName()} + * will return the decrypted bucket name. Otherwise {@link #getName()} will + * return the encrypted bucket name - the way it is stored in the Storj Bridge. + *
+ * + * @returntrue if the bucket name has been decrypted successfully,
+ * false otherwise
+ *
+ * @see #getName()
+ * @see Storj#importKeys(Keys, String)
+ */
+ public boolean isDecrypted() {
+ return decrypted;
+ }
+
+ /**
+ * The hash code value of the Bucket object is the hash code value of its id.
+ */
+ @Override
+ public int hashCode() {
+ return Objects.hash(id);
+ }
+
+ /**
+ * Two Bucket objects are equal if their ids are equal.
+ */
+ @Override
+ public boolean equals(Object o) {
+ if (o == this) return true;
+ if (!(o instanceof Bucket)) {
+ return false;
+ }
+ Bucket bucket = (Bucket) o;
+ return Objects.equals(id, bucket.id);
+ }
+
+ /**
+ * Two Bucket objects are compared to each other by their bucket names.
+ */
+ @Override
+ public int compareTo(Bucket other) {
+ return name.compareTo(other.name);
+ }
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/CreateBucketCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/CreateBucketCallback.java
new file mode 100644
index 0000000..77ef870
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/CreateBucketCallback.java
@@ -0,0 +1,48 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see createBucket() and createBuckets() methods.
+ *
+ * @see Storj#createBucket(String, CreateBucketCallback)
+ * @see Storj#createBuckets(String[], CreateBucketCallback)
+ */
+public interface CreateBucketCallback {
+
+ /**
+ * Called if the bucket was created successfully.
+ *
+ * @param bucket
+ * a {@link Bucket} object with the newly created bucket
+ */
+ void onBucketCreated(Bucket bucket);
+
+ /**
+ * Called if creating the bucket finished with error.
+ *
+ * @param bucketName
+ * the bucket name this error applies to
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String bucketName, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/DeleteBucketCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/DeleteBucketCallback.java
new file mode 100644
index 0000000..4d5c900
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/DeleteBucketCallback.java
@@ -0,0 +1,50 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see deleteBucket() and deleteBuckets() methods.
+ *
+ * @see Storj#deleteBucket(Bucket, DeleteBucketCallback)
+ * @see Storj#deleteBucket(String, DeleteBucketCallback)
+ * @see Storj#deleteBuckets(Bucket[], DeleteBucketCallback)
+ * @see Storj#deleteBuckets(String[], DeleteBucketCallback)
+ */
+public interface DeleteBucketCallback {
+
+ /**
+ * Called if the bucket was deleted successfully.
+ *
+ * @param bucketId
+ * the id of the bucket that was deleted
+ */
+ void onBucketDeleted(String bucketId);
+
+ /**
+ * Called if deleting the bucket finished with error.
+ *
+ * @param bucketId
+ * the bucket id this error applies to
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String bucketId, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/DeleteFileCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/DeleteFileCallback.java
new file mode 100644
index 0000000..0ed25fc
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/DeleteFileCallback.java
@@ -0,0 +1,50 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see deleteFile() and deleteFiles() methods.
+ *
+ * @see Storj#deleteFile(Bucket, File, DeleteFileCallback)
+ * @see Storj#deleteFile(String, String, DeleteFileCallback)
+ * @see Storj#deleteFiles(Bucket, File[], DeleteFileCallback)
+ * @see Storj#deleteFiles(String, String[], DeleteFileCallback)
+ */
+public interface DeleteFileCallback {
+
+ /**
+ * Called if the file was deleted successfully.
+ *
+ * @param fileId
+ * the id of the file that was deleted
+ */
+ void onFileDeleted(String fileId);
+
+ /**
+ * Called if deleting the file finished with error.
+ *
+ * @param fileId
+ * the file id this error applies to
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String fileId, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/DownloadFileCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/DownloadFileCallback.java
new file mode 100644
index 0000000..f4d4a12
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/DownloadFileCallback.java
@@ -0,0 +1,69 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see downloadFile() and downloadFiles() methods.
+ *
+ * @see Storj#downloadFile(Bucket, File, DownloadFileCallback)
+ * @see Storj#downloadFile(Bucket, File, String, DownloadFileCallback)
+ * @see Storj#downloadFile(String, String, String, DownloadFileCallback)
+ * @see Storj#downloadFiles(Bucket, File[], DownloadFileCallback)
+ * @see Storj#downloadFiles(Bucket, File[], String[], DownloadFileCallback)
+ * @see Storj#downloadFiles(String, String[], String[], DownloadFileCallback)
+ */
+public interface DownloadFileCallback {
+
+ /**
+ * Called when new progress is reported.
+ *
+ * @param fileId
+ * the id of the file being downloaded
+ * @param progress
+ * the current progress from 0 to 1, e.g.
+ * 0.75 means 75% completed
+ * @param downloadedBytes
+ * the number of bytes already downloaded
+ * @param totalBytes
+ * the total bytes to be downloaded
+ */
+ void onProgress(String fileId, double progress, long downloadedBytes, long totalBytes);
+
+ /**
+ * Called if the file was downloaded successfully.
+ *
+ * @param fileId
+ * the id of the downloaded file
+ * @param localPath
+ * the local path (including file name) of the downloaded file
+ */
+ void onComplete(String fileId, String localPath);
+
+ /**
+ * Called if downloaded the file finished with error.
+ *
+ * @param fileId
+ * the id of the file being downloaded
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String fileId, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/File.java b/android-libstorj/src/main/java/io/storj/libstorj/File.java
new file mode 100644
index 0000000..8a6fc40
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/File.java
@@ -0,0 +1,277 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see + * The returned value is a UTC time in the format of + * "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", e.g. "2016-03-04T17:01:02.629Z". + *
+ * + * @return the formatted UTC time when the file was uploaded + */ + public String getCreated() { + return created; + } + + /** + * Checks if the file name has been decrypted successfully with the + * {@link Storj#importKeys(Keys, String) imported keys}. + * + *+ * If the file name has been decrypted successfully then {@link #getName()} will + * return the decrypted file name. Otherwise {@link #getName()} will return the + * encrypted file name - the way it is stored in the Storj Bridge. + *
+ * + *+ * The return value also indicates if the file will be decrypted successully if + * later downloaded using the same keys. + *
+ * + * @returntrue if the file name has been decrypted successfully,
+ * false otherwise
+ *
+ * @see #getName()
+ * @see Storj#importKeys(Keys, String)
+ */
+ public boolean isDecrypted() {
+ return decrypted;
+ }
+
+ /**
+ * Returns the file size in bytes.
+ *
+ * @return the number of bytes
+ */
+ public long getSize() {
+ return size;
+ }
+
+ /**
+ * Returns the content type of the file.
+ *
+ * + * Currently the io.storj.libstorj native library does not determine the file's content + * type during upload, so most probably the Storj Bridge stores it as + * 'application/octet-stream' in the file metadata. Thus, an attempt is made to + * determine the content type by calling + * {@link URLConnection#guessContentTypeFromName(String)} + *
+ * + * @return a guess of the content type based on the file name + */ + public String getMimeType() { + String mime = null; + + // prefer the Java util as io.storj.libstorj returns always 'application/octet-stream' + try { + String escaped = URLEncoder.encode(name, StandardCharsets.UTF_8.name()); + mime = URLConnection.guessContentTypeFromName(escaped); + } catch (Exception e) { + // mime will remain null + } + + if (mime == null || mime.isEmpty()) { + // fallback to io.storj.libstorj + mime = mimeType; + } + + return mime; + } + + /** + * Returns the erasure encoding algorithm used for this file. + * + * @return the name of the erasure encoding algorithm + */ + public String getErasure() { + return erasure; + } + + /** + * Returns the index that the encryption key for this file is derived from. + * + * @return the 32 bit hex value of the index + */ + public String getIndex() { + return index; + } + + /** + * Returns the HMAC checksum for the file. + * + *+ * The checksum is used for verifying the file's integrity and authenticity. The + * formula is described in SIP5. + *
+ * + * @return the HMAC checksum + */ + public String getHMAC() { + return hmac; + } + + /** + * Checks if the file is a directory. + * + *+ * The Storj Bridge has a flat structure of bucket and files. There is no real + * file tree structure with subdirectories. However, a pseudo tree structure can + * be maintained by clients using file paths as the file name, e.g. + * "mydir/mysubdir/myfile". It is assumed that a file is a directory if its name + * ends with a slash character, e.g. "mydir/mysubdir/". + *
+ * + * @returntrue if this file object is a directory,
+ * false otherwise
+ */
+ public boolean isDirectory() {
+ return name.endsWith("/");
+ }
+
+ /**
+ * The hash code value of the File object is the hash code value of its id.
+ */
+ @Override
+ public int hashCode() {
+ return Objects.hash(id);
+ }
+
+ /**
+ * Two File objects are equal if their ids are equal.
+ */
+ @Override
+ public boolean equals(Object o) {
+ if (o == this) return true;
+ if (!(o instanceof File)) {
+ return false;
+ }
+ File file = (File) o;
+ return Objects.equals(id, file.id);
+ }
+
+ /**
+ * Two File objects are compared to each other by their file names.
+ */
+ @Override
+ public int compareTo(File other) {
+ return name.compareTo(other.name);
+ }
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/GetBucketCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/GetBucketCallback.java
new file mode 100644
index 0000000..dfbf416
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/GetBucketCallback.java
@@ -0,0 +1,53 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see getBucket()
+ * and getBuckets() methods.
+ *
+ * + * If info is requested for multiple buckets then this callback will be invoked + * once for each bucket. + *
+ * + * @see Storj#getBucket(String, GetBucketCallback) + * @see Storj#getBuckets(String[], GetBucketCallback) + */ +public interface GetBucketCallback { + + /** + * Called if the bucket info was retrieved successfully. + * + * @param bucket + * a {@link Bucket} object with the result + */ + void onBucketReceived(Bucket bucket); + + /** + * Called if getting info about the bucket finished with error. + * + * @param bucketId + * the bucket id this error applies to + * @param code + * the error code + * @param message + * the error message + */ + void onError(String bucketId, int code, String message); + +} diff --git a/android-libstorj/src/main/java/io/storj/libstorj/GetBucketIdCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/GetBucketIdCallback.java new file mode 100644 index 0000000..1c680d5 --- /dev/null +++ b/android-libstorj/src/main/java/io/storj/libstorj/GetBucketIdCallback.java @@ -0,0 +1,50 @@ +/* + * Copyright (C) 2018 Kaloyan Raev + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as + * published by the Free Software Foundation, either version 3 of the + * License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program. If not, seegetBucketId() and getBucketIds() methods.
+ *
+ * @see Storj#getBucketId(String, GetBucketIdCallback)
+ * @see Storj#getBucketIds(String[], GetBucketIdCallback)
+ */
+public interface GetBucketIdCallback {
+
+ /**
+ * Called if the bucket id was retrieved successfully.
+ *
+ * @param bucketName
+ * the bucket name the received bucket id applies to
+ * @param bucketId
+ * the received bucket id
+ */
+ void onBucketIdReceived(String bucketName, String bucketId);
+
+ /**
+ * Called if getting the bucket id finished with error.
+ *
+ * @param bucketName
+ * the bucket name this error applies to
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String bucketName, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/GetBucketsCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/GetBucketsCallback.java
new file mode 100644
index 0000000..8003d9f
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/GetBucketsCallback.java
@@ -0,0 +1,45 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see getBuckets() method.
+ *
+ * @see Storj#getBuckets(GetBucketsCallback)
+ */
+public interface GetBucketsCallback {
+
+ /**
+ * Called if the buckets list was retrieved successfully.
+ *
+ * @param buckets
+ * an array of {@link Bucket} objects with the result
+ */
+ void onBucketsReceived(Bucket[] buckets);
+
+ /**
+ * Called if getting the buckets list finished with error.
+ *
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/GetFileCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/GetFileCallback.java
new file mode 100644
index 0000000..c4b7bb0
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/GetFileCallback.java
@@ -0,0 +1,50 @@
+/*
+ * Copyright (C) 2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see getFile()
+ * and getFiles() methods.
+ *
+ * @see Storj#getFile(Bucket, String, GetFileCallback)
+ * @see Storj#getFile(String, String, GetFileCallback)
+ * @see Storj#getFiles(Bucket, String[], GetFileCallback)
+ * @see Storj#getFiles(String, String[], GetFileCallback)
+ */
+public interface GetFileCallback {
+
+ /**
+ * Called if the file info was retrieved successfully.
+ *
+ * @param file
+ * a {@link File} object with the result
+ */
+ void onFileReceived(File file);
+
+ /**
+ * Called if getting the file info finished with error.
+ *
+ * @param fileId
+ * the file id this error applies to
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String fileId, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/GetFileIdCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/GetFileIdCallback.java
new file mode 100644
index 0000000..0e5cc10
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/GetFileIdCallback.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright (C) 2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see getFileId() and getFileIds() methods.
+ *
+ * @see Storj#getFileId(String, String, GetFileIdCallback)
+ * @see Storj#getFileId(String, String, GetFileIdCallback)
+ * @see Storj#getFileIds(Bucket, String[], GetFileIdCallback)
+ * @see Storj#getFileIds(String, String[], GetFileIdCallback)
+ */
+public interface GetFileIdCallback {
+
+ /**
+ * Called if the file id was retrieved successfully.
+ *
+ * @param fileName
+ * the file name the received file id applies to
+ * @param fileId
+ * the received file id
+ */
+ void onFileIdReceived(String fileName, String fileId);
+
+ /**
+ * Called if getting the file id finished with error.
+ *
+ * @param fileName
+ * the file name this error applies to
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String fileName, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/GetInfoCallback.java b/android-libstorj/src/main/java/io/storj/libstorj/GetInfoCallback.java
new file mode 100644
index 0000000..1d42ada
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/GetInfoCallback.java
@@ -0,0 +1,53 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see getInfo()
+ * method.
+ *
+ * @see Storj#getInfo(GetInfoCallback)
+ */
+public interface GetInfoCallback {
+
+ /**
+ * Called when the {@link Storj#getInfo(GetInfoCallback)} method finishes
+ * successfully.
+ *
+ * @param title
+ * the title of the Bridge API server
+ * @param description
+ * the description of the Bridge API server
+ * @param version
+ * the version of the Bridge API server
+ * @param host
+ * the host the Bridge API server is listening for requests at
+ */
+ void onInfoReceived(String title, String description, String version, String host);
+
+ /**
+ * Called when the {@link Storj#getInfo(GetInfoCallback)} method finishes with
+ * error.
+ *
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/Keys.java b/android-libstorj/src/main/java/io/storj/libstorj/Keys.java
new file mode 100644
index 0000000..418c102
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/Keys.java
@@ -0,0 +1,62 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see listFiles() methods.
+ *
+ * @see Storj#listFiles(Bucket, ListFilesCallback)
+ * @see Storj#listFiles(String, ListFilesCallback)
+ * @see Storj#listFiles(Bucket[], ListFilesCallback)
+ * @see Storj#listFiles(String[], ListFilesCallback)
+ */
+public interface ListFilesCallback {
+
+ /**
+ * Called if the files list was retrieved successfully.
+ *
+ * @param bucketId
+ * the bucket id the received file list applies to
+ * @param files
+ * an array of {@link File} objects with the result
+ */
+ void onFilesReceived(String bucketId, File[] files);
+
+ /**
+ * Called if getting the files list finished with error.
+ *
+ * @param bucketId
+ * the bucket id this error applies to
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String bucketId, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/NativeLibraries.java b/android-libstorj/src/main/java/io/storj/libstorj/NativeLibraries.java
new file mode 100644
index 0000000..a9d437b
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/NativeLibraries.java
@@ -0,0 +1,81 @@
+/*
+ * Copyright (C) 2017 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see register() method.
+ *
+ * @see Storj#register(String, String, RegisterCallback)
+ */
+public interface RegisterCallback {
+
+ /**
+ * Called if registration finished successfully and now the new account is
+ * pending confirmation via an activation link.
+ *
+ * @param email
+ * the email address that will receive the activation link, same as
+ * the user's email used for the registration
+ */
+ void onConfirmationPending(String email);
+
+ /**
+ * Called if registration finished with error.
+ *
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/Storj.java b/android-libstorj/src/main/java/io/storj/libstorj/Storj.java
new file mode 100644
index 0000000..bdc6fdd
--- /dev/null
+++ b/android-libstorj/src/main/java/io/storj/libstorj/Storj.java
@@ -0,0 +1,2024 @@
+/*
+ * Copyright (C) 2017-2018 Kaloyan Raev
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see + * For example, if a malformed bucket id or file id is provided in the request. + *
+ */ + public static final int HTTP_BAD_REQUEST = 400; + + /** + * Error code if the Bridge was requested with invalid credentials. + */ + public static final int HTTP_UNAUTHORIZED = 401; + + /** + * Error code if the requested operation is forbidden. + * + *+ * For example, if the user account has not been activated yet. + *
+ */ + public static final int HTTP_FORBIDDEN = 403; + + /** + * Error code if the requested resource from the Bridge did not exist. + * + *+ * For example, if a bucket with the given id (which is not malformed) does not + * exist. + *
+ */ + public static final int HTTP_NOT_FOUND = 404; + + /** + * Error code if a resource could not be created due to conflict. + * + *+ * For example, if a resource with the same name already exists. + *
+ */ + public static final int HTTP_CONFLICT = 409; + + /** + * Error code if the transfer rate limit for this account was reached. + */ + public static final int HTTP_TRANSFER_RATE_LIMIT = 420; + + /** + * Error code if the request rate limit for this account was reached. + */ + public static final int HTTP_TOO_MANY_REQUESTS = 429; + + /** + * Error code if an internal server error occured on the Bridge. + */ + public static final int HTTP_INTERNAL_SERVER_ERROR = 500; + + /** + * Error code if the Storj network is temporarily overloaded. + * + *+ * For example, if the Bridge could not establish a contract for a shard within + * a specific period of time. + *
+ */ + public static final int HTTP_SERVICE_UNAVAILABLE = 503; + + /** + * Error code for general error with requesting the Bridge during a download or + * upload operation. + */ + public static final int STORJ_BRIDGE_REQUEST_ERROR = 1000; + + /** + * Error code if a download or upload operation was requested with invalid + * credentials. + */ + public static final int STORJ_BRIDGE_AUTH_ERROR = 1001; + + /** + * Error code if failed to request a token during a download or upload + * operation. + */ + public static final int STORJ_BRIDGE_TOKEN_ERROR = 1002; + + /** + * Error code if a request to the Bridge timed out during a download or upload + * operation. + */ + public static final int STORJ_BRIDGE_TIMEOUT_ERROR = 1003; + + /** + * Error code if an Internal Server Error (500) occured on the Bridge during a + * download or upload operation. + */ + public static final int STORJ_BRIDGE_INTERNAL_ERROR = 1004; + + /** + * Error code if a Transfer Rate Limit (420) or Request Rate Limit (429) error + * occured on the Bridge during a download or upload operation. + */ + public static final int STORJ_BRIDGE_RATE_ERROR = 1005; + + /** + * Error code if an attempt was made to upload a file to a bucket that does not + * exist. + */ + public static final int STORJ_BRIDGE_BUCKET_NOTFOUND_ERROR = 1006; + + /** + * Error code if an attempt was made to download a file that does not exist. + */ + public static final int STORJ_BRIDGE_FILE_NOTFOUND_ERROR = 1007; + + /** + * Error code if the Bridge returned an unexpected JSON response. + */ + public static final int STORJ_BRIDGE_JSON_ERROR = 1008; + + /** + * Error code if the Bridge failed to request a frame during file upload. + */ + public static final int STORJ_BRIDGE_FRAME_ERROR = 1009; + + /** + * Error code if the Bridge failed to request the pointers to the file being + * downloaded. + */ + public static final int STORJ_BRIDGE_POINTER_ERROR = 1010; + + /** + * Error code if the Bridge failed to replace a pointer to the file being + * downloaded. + */ + public static final int STORJ_BRIDGE_REPOINTER_ERROR = 1011; + + /** + * Error code if the Bridge failed to get the metainfo about the file being + * downloaded. + */ + public static final int STORJ_BRIDGE_FILEINFO_ERROR = 1012; + + /** + * Error code if a file with the same name as the file being uploaded already + * exists in the bucket. + */ + public static final int STORJ_BRIDGE_BUCKET_FILE_EXISTS = 1013; + + /** + * Error code if the Bridge failed to receive a storage offer from the Storj + * network for the file being uploaded. + */ + public static final int STORJ_BRIDGE_OFFER_ERROR = 1014; + + /** + * Error code for general error with requesting a farmer during a download or + * upload operation. + */ + public static final int STORJ_FARMER_REQUEST_ERROR = 2000; + + /** + * Error code if a request to a farmer timed out during a download or upload + * operation. + */ + public static final int STORJ_FARMER_TIMEOUT_ERROR = 2001; + + /** + * Error code if a farmer was requested with invalid credentials. + */ + public static final int STORJ_FARMER_AUTH_ERROR = 2002; + + /** + * Error code if a farmer is exhausted. + */ + public static final int STORJ_FARMER_EXHAUSTED_ERROR = 2003; + + /** + * Error code for farmer integrity problems. + */ + public static final int STORJ_FARMER_INTEGRITY_ERROR = 2004; + + /** + * Error code if info about the file being uploaded could not be retrieved from + * the local file system. + */ + public static final int STORJ_FILE_INTEGRITY_ERROR = 3000; + + /** + * Error code if failed to write the file to the local file system. + */ + public static final int STORJ_FILE_WRITE_ERROR = 3001; + + /** + * Error code if failed to encrypt the file. + */ + public static final int STORJ_FILE_ENCRYPTION_ERROR = 3002; + + /** + * Error code if the file selected for upload has invalid size. + */ + public static final int STORJ_FILE_SIZE_ERROR = 3003; + + /** + * Error code if failed to decrypt the file. + */ + public static final int STORJ_FILE_DECRYPTION_ERROR = 3004; + + /** + * Error code if failed to generate the HMAC checksum for the file. + */ + public static final int STORJ_FILE_GENERATE_HMAC_ERROR = 3005; + + /** + * Error code if error occurred while reading the file being uploaded from the + * local file system. + */ + public static final int STORJ_FILE_READ_ERROR = 3006; + + /** + * Error code if the file has too many missing shards to be recovered from the + * Storj network. + */ + public static final int STORJ_FILE_SHARD_MISSING_ERROR = 3007; + + /** + * Error code if failed to reconstruct the file from the downloaded shards. + */ + public static final int STORJ_FILE_RECOVER_ERROR = 3008; + + /** + * Error code if failed to resize the file on the local file system while shards + * were being downloaded. + */ + public static final int STORJ_FILE_RESIZE_ERROR = 3009; + + /** + * Error code if the file being downloaded was encrypted with unsupported + * erasure codes. + * + *+ * Currently only "reedsolomon" codes are supported. + *
+ */ + public static final int STORJ_FILE_UNSUPPORTED_ERASURE = 3010; + + /** + * Error code if failed to create parity shards for the file being uploaded. + */ + public static final int STORJ_FILE_PARITY_ERROR = 3011; + + /** + * Error code if a memory allocation request failed in the io.storj.libstorj native + * library. + */ + public static final int STORJ_MEMORY_ERROR = 4000; + + /** + * Error code if failed to map the file being downloaded to memory. + */ + public static final int STORJ_MAPPING_ERROR = 4001; + + /** + * Error code if failed to unmap the file being downloaded from memory. + */ + public static final int STORJ_UNMAPPING_ERROR = 4002; + + /** + * Error code if error occurred with the event loop of the io.storj.libstorj native + * library. + */ + public static final int STORJ_QUEUE_ERROR = 5000; + + /** + * Error code if failed to encrypt the bucket or file metadata. + */ + public static final int STORJ_META_ENCRYPTION_ERROR = 6000; + + /** + * Error code if failed to decrypt the bucket or file metadata. + */ + public static final int STORJ_META_DECRYPTION_ERROR = 6001; + + /** + * Error code if failed to generate the file key for encryption. + */ + public static final int STORJ_HEX_DECODE_ERROR = 7000; + + /** + * Error code if the Bridge URL uses protocol that is not supported. + */ + public static final int CURLE_UNSUPPORTED_PROTOCOL = 10001; + + /** + * Error code if the Bridge URL is not properly formatted. + */ + public static final int CURLE_URL_MALFORMAT = 10003; + + /** + * Error code if the given proxy host could not be resolved. + */ + public static final int CURLE_COULDNT_RESOLVE_PROXY = 10005; + + /** + * Error code if the Bridge host could not be resolved. + */ + public static final int CURLE_COULDNT_RESOLVE_HOST = 10006; + + /** + * Error code if failed to connect to the Bridge server or to the proxy. + */ + public static final int CURLE_COULDNT_CONNECT = 10007; + + /** + * Error code if a memory allocation request failed in the libcurl native + * library. + */ + public static final int CURLE_OUT_OF_MEMORY = 10027; + + /** + * Error code if a network operation timed out. + */ + public static final int CURLE_OPERATION_TIMEDOUT = 10028; + + /** + * Error code for "No such file or directory" error that occured on the local + * file system. + * + *+ * This error code is usually returned on upload and download operations. For + * example, if the file to be uploaded does not exist, or the directory to save + * the downloaded file does not exist. + *
+ */ + public static final int ENOENT = 20002; + + /** + * Error code for "Permission denied" error that occured on the local file + * system. + * + *+ * This error code is usually returned on upload and download operations. For + * example, if the file to be uploaded cannot be accessed due to insufficient + * permissions, or there are not enough permissions to save the downloaded file + * to the selected directory. + *
+ */ + public static final int EACCES = 20013; + + private static final String DEFAULT_PROTO = "https"; + private static final String DEFAULT_HOST = "mars.tardigrade.io"; + private static final int DEFAULT_PORT = 7777; + + private String host; + private String addr; + private Keys keys; + private java.io.File configDir; + private java.io.File downloadDir; + + private ConcurrentHashMap
+ * It will be configured to connect to the Bridge hosted at
+ * https://api.storj.io.
+ *
+ * After completing the work with this object make sure to call + * {@link #destroy()} to release the allocated native resources. + *
+ * + * @see Storj#destroy() + */ + public Storj() { + this(DEFAULT_PROTO, DEFAULT_HOST, DEFAULT_PORT); + } + + /** + * Constructs a Storj object to connect to the Bridge hosted at the provided + * URL. + * + *+ * After completing the work with this object make sure to call + * {@link #destroy()} to release the allocated native resources. + *
+ * + * @param bridgeUrl a String object with the Bridge URL + * @throws MalformedURLException if the provided String represents a malformed URL + * @see Storj#destroy() + */ + public Storj(String bridgeUrl) throws MalformedURLException { + this(new URL(bridgeUrl)); + } + + /** + * Constructs a Storj object to connect to the Bridge hosted at the provided + * URL. + * + *+ * After completing the work with this object make sure to call + * {@link #destroy()} to release the allocated native resources. + *
+ * + * @param bridgeUrl the Bridge URL + * @see Storj#destroy() + */ + public Storj(URL bridgeUrl) { + this(bridgeUrl.getProtocol(), bridgeUrl.getHost(), bridgeUrl.getPort()); + } + + private Storj(String bridgeProtocol, String bridgeHost, int bridgePort) { + String proto = bridgeProtocol; + host = bridgeHost; + int port = bridgePort; + + if (port == -1) { + switch (bridgeProtocol) { + case "http": + port = 80; + break; + case "https": + port = 443; + break; + } + } + + addr = host + ":" + port; + configDir = new java.io.File(System.getProperty("user.home"), ".storj"); + downloadDir = new java.io.File(System.getProperty("user.dir")); + } + + /** + * Configure the locaton of the configuration directory. + * + *+ * The configuration directory is where the authentication files are stored. + *
+ * + *
+ * The default location of the configuration directory is '.storj' under the
+ * user home directory, e.g. /home/myuser/.storj or
+ * C:\Users\myuser\.storj.
+ *
+ * Downloading files to a custom directory is still possible using the
+ * {@link #downloadFile(Bucket, File, String, DownloadFileCallback)} variant
+ * that takes a localPath parameter.
+ *
+ * The default download directory is the program's working directory. + *
+ * + * @param dir a directory + * @return a reference to this Storj object + */ + public Storj setDownloadDirectory(java.io.File dir) { + downloadDir = dir; + return this; + } + + /** + * Returns the current unix timestamp in milliseconds. + * + * @return a unix timestamp + * @deprecated Use java.lang.System#currentTimeMillis() instead. + */ + public static long getTimestamp() { + return System.currentTimeMillis(); + } + + /** + * Generates a new random mnemonic. + * + *+ * This will generate a new random mnemonic with 128 to 256 bits of entropy. + *
+ * + * @param strength the bits of entropy + * @return a 12 or 24-word mnemonic + * @deprecated This method is not supported anymore. There is no replacement. + */ + public static String generateMnemonic(int strength) { + return "deprecated deprecated deprecated deprecated deprecated deprecated deprecated deprecated deprecated deprecated deprecated deprecated"; + } + + /** + * Checks that a mnemonic is valid. + * + *+ * This will check that a mnemonic has been entered correctly by verifying the + * checksum, and that words are a part of the dictionary. + *
+ * + * @param mnemonic the mnemonic + * @returntrue on success and false on failure
+ * @deprecated This method is not supported anymore. There is no replacement.
+ */
+ public static boolean checkMnemonic(String mnemonic) {
+ return false;
+ }
+
+ /**
+ * Returns the error message for the given error code.
+ *
+ *
+ * Note that the message parameter of the onError()
+ * method in callbacks often provides more detailed error message than this
+ * method.
+ *
true if the keys are imported, and false
+ * otherwise
+ */
+ public boolean keysExist() {
+ return getAuthFile().exists();
+ }
+
+ /**
+ * Returns the user's keys that have been imported by decrypting the
+ * authentication file with the provided passphrase.
+ *
+ * + * The authentication file is located in the configuration directory. + *
+ * + * @param passphrase the passphrase to decrypt the keys, can be an empty String, but + * notnull
+ * @return a {@code Key} object with the user's keys, or null if
+ * the keys have not been imported yet.
+ * @see #setConfigDirectory(java.io.File)
+ */
+ public Keys getKeys(String passphrase) {
+ if (keys == null) {
+ Properties props = new Properties();
+
+ try {
+ props.load(new FileReader(getAuthFile()));
+ } catch (IOException e) {
+ return null;
+ }
+
+ keys = new Keys(props.getProperty("api-key"), props.getProperty("enc-key"));
+ }
+ return keys;
+ }
+
+ /**
+ * Imports the provided keys and encrypt them with the provided passphrase in an
+ * authentication file.
+ *
+ * + * The authentication file is located in the configuration directory. + *
+ * + * @param keys a {@link Keys} object with the user's keys + * @param passphrase the passphrase to encrypt the keys, can be an empty String, but + * notnull
+ * @return true if importing keys was successful,
+ * false otherwise
+ * @see #setConfigDirectory(java.io.File)
+ */
+ public boolean importKeys(Keys keys, String passphrase) {
+ Properties props = new Properties();
+ props.setProperty("api-key", keys.getApiKey());
+ props.setProperty("enc-key", keys.getEncryptionKey());
+
+ try {
+ props.store(new FileWriter(getAuthFile()), null);
+ this.keys = keys;
+ } catch (IOException e) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Deletes the authentication file with user's keys and clear them from memory.
+ *
+ * + * The authentication file is located in the configuration directory. + *
+ * + * @returntrue if deleting the authentication file was successful,
+ * false otherwise
+ * @see #setConfigDirectory(java.io.File)
+ */
+ public boolean deleteKeys() {
+ boolean success = getAuthFile().delete();
+ if (success) {
+ keys = null;
+ }
+ return success;
+ }
+
+ /**
+ * Verifies if the provided credentials are valid.
+ *
+ * + * This will try to list the buckets with the provided user and password. It + * will block until the response is received. + *
+ * + * @param user the user's email + * @param pass the user's password + * @return {@link #NO_ERROR} if the user and password match; + * {@link #HTTP_UNAUTHORIZED} if the credentials are invalid; + * {@link #HTTP_FORBIDDEN} if the account has not been activated yet; or + * other error codes due to network issues. + * @throws InterruptedException if the request was interrupted + * @deprecated This method is not supported anymore. This is no replacement. + */ + public int verifyKeys(String user, String pass) throws InterruptedException { + throw new UnsupportedOperationException("deprecated"); + } + + /** + * Verifies if the provided keys are valid. + * + *+ * This will try to list the buckets with the provided keys. It will block until + * the response is received. + *
+ * + * @param keys the user's keys + * @return {@link #NO_ERROR} if the user and password match, and the mnemonic + * can decrypt the metadata; {@link #HTTP_UNAUTHORIZED} if the + * credentials are invalid; {@link #HTTP_FORBIDDEN} if the account has + * not been activated yet; {@link #STORJ_FILE_DECRYPTION_ERROR} if the + * user and password match, but the mnemonic could not decrypt any + * metadata; or other error codes due to network issues. + * @throws InterruptedException if the request was interrupted + */ + public int verifyKeys(Keys keys) throws InterruptedException { + Keys oldKeys = this.keys; + this.keys = keys; + try { + runInProject(new ProjectRunnable() { + @Override + public void run(Project project) throws Exception { + project.listBuckets("", 2, 1); + } + }); + } catch (Exception e) { + return -1; + } finally { + this.keys = oldKeys; + } + return NO_ERROR; + } + + /** + * Lists available buckets for the user. + * + * @param callback an implementation of the {@link GetBucketsCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getBuckets(GetBucketsCallback callback) throws KeysNotFoundException { + checkKeys(); + _getBuckets(callback); + } + + /** + * Gets info about a specific bucket. + * + * @param bucketId the bucket id + * @param callback an implementation of the {@link GetBucketCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getBucket(String bucketId, GetBucketCallback callback) throws KeysNotFoundException { + checkKeys(); + _getBucket(bucketId, callback); + } + + /** + * Gets info about the specified list of buckets. + * + *+ * This method will issue a seperate request to the bridge for each bucket id + * from the list. The requests will run in parallel. The callback will be + * invoked once for each bucket id. The order of invoking the callback is + * undetermined and most likely will be different than the order of bucket ids + * in the list. + *
+ * + * @param bucketIds an array of bucket ids + * @param callback an implementation of the {@link GetBucketCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getBuckets(String bucketIds[], GetBucketCallback callback) throws KeysNotFoundException { + checkKeys(); + for (String bucketId : bucketIds) { + _getBucket(bucketId, callback); + } + } + + /** + * Gets the bucket id by the specified bucket name. + * + * @param bucketName the bucket name + * @param callback an implementation of the {@link GetBucketIdCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getBucketId(String bucketName, GetBucketIdCallback callback) throws KeysNotFoundException { + checkKeys(); + _getBucketId(bucketName, callback); + } + + /** + * Gets the bucket ids for the specified list of bucket names. + * + *+ * This method will issue a seperate request to the bridge for each bucket name + * from the list. The requests will run in parallel. The callback will be + * invoked once for each bucket name. The order of invoking the callback is + * undetermined and most likely will be different than the order of bucket names + * in the list. + *
+ * + * @param bucketNames an array of bucket names + * @param callback an implementation of the {@link GetBucketIdCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getBucketIds(String[] bucketNames, GetBucketIdCallback callback) throws KeysNotFoundException { + checkKeys(); + for (String bucketName : bucketNames) { + _getBucketId(bucketName, callback); + } + } + + /** + * Creates a new bucket. + * + * @param bucketName a name for the new bucket + * @param callback an implementation of the {@link CreateBucketCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void createBucket(String bucketName, CreateBucketCallback callback) throws KeysNotFoundException { + checkKeys(); + _createBucket(bucketName, callback); + } + + /** + * Creates a list of new buckets. + * + *+ * This method will issue a seperate request to the bridge for each bucket name + * from the list. The requests will run in parallel. The callback will be + * invoked once for each bucket name. The order of invoking the callback is + * undetermined and most likely will be different than the order of bucket names + * in the list. + *
+ * + * @param bucketNames an array of bucket names + * @param callback an implementation of the {@link CreateBucketCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void createBuckets(String[] bucketNames, final CreateBucketCallback callback) throws KeysNotFoundException { + checkKeys(); + for (final String bucketName : bucketNames) { + _createBucket(bucketName, callback); + } + } + + /** + * Deletes the specified bucket. + * + * @param bucket a {@link Bucket} object + * @param callback an implementation of the {@link DeleteBucketCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void deleteBucket(Bucket bucket, DeleteBucketCallback callback) throws KeysNotFoundException { + deleteBucket(bucket.getId(), callback); + } + + /** + * Deletes the specified bucket. + * + * @param bucketId the bucket id + * @param callback an implementation of the {@link DeleteBucketCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void deleteBucket(String bucketId, DeleteBucketCallback callback) throws KeysNotFoundException { + checkKeys(); + _deleteBucket(bucketId, callback); + } + + /** + * Deletes the specified list of buckets. + * + *+ * This method will issue a seperate request to the bridge for each bucket from + * the list. The requests will run in parallel. The callback will be invoked + * once for each bucket. The order of invoking the callback is undetermined and + * most likely will be different than the order of buckets in the list. + *
+ * + * @param buckets an array of {@link Bucket} objects + * @param callback an implementation of the {@link DeleteBucketCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void deleteBuckets(Bucket[] buckets, DeleteBucketCallback callback) throws KeysNotFoundException { + deleteBuckets(getBucketIds(buckets), callback); + } + + /** + * Deletes the specified list of buckets. + * + *+ * This method will issue a seperate request to the bridge for each bucket id + * from the list. The requests will run in parallel. The callback will be + * invoked once for each bucket id. The order of invoking the callback is + * undetermined and most likely will be different than the order of bucket ids + * in the list. + *
+ * + * @param bucketIds an array of bucket ids + * @param callback an implementation of the {@link DeleteBucketCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void deleteBuckets(String[] bucketIds, DeleteBucketCallback callback) throws KeysNotFoundException { + checkKeys(); + for (String bucketId : bucketIds) { + _deleteBucket(bucketId, callback); + } + } + + /** + * Gets a list of all files in a bucket. + * + * @param bucket a {@link Bucket} object + * @param callback an implementation of the {@link ListFilesCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void listFiles(Bucket bucket, ListFilesCallback callback) throws KeysNotFoundException { + listFiles(bucket.getId(), callback); + } + + /** + * Gets a list of all files in a bucket. + * + * @param bucketId the bucket id + * @param callback an implementation of the {@link ListFilesCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void listFiles(String bucketId, ListFilesCallback callback) throws KeysNotFoundException { + checkKeys(); + _listFiles(bucketId, callback); + } + + /** + * Gets a list of all files for each bucket in the specified list. + * + *+ * This method will issue a seperate request to the bridge for each bucket from + * the list. The requests will run in parallel. The callback will be invoked + * once for each bucket. The order of invoking the callback is undetermined and + * most likely will be different than the order of buckets in the list. + *
+ * + * @param buckets an array of {@link Bucket} objects + * @param callback an implementation of the {@link ListFilesCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void listFiles(Bucket[] buckets, ListFilesCallback callback) throws KeysNotFoundException { + listFiles(getBucketIds(buckets), callback); + } + + /** + * Gets a list of all files for each bucket in the specified list. + * + *+ * This method will issue a seperate request to the bridge for each bucket id + * from the list. The requests will run in parallel. The callback will be + * invoked once for each bucket id. The order of invoking the callback is + * undetermined and most likely will be different than the order of bucket ids + * in the list. + *
+ * + * @param bucketIds an array of bucket ids + * @param callback an implementation of the {@link ListFilesCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void listFiles(String[] bucketIds, ListFilesCallback callback) throws KeysNotFoundException { + checkKeys(); + for (String bucketId : bucketIds) { + _listFiles(bucketId, callback); + } + } + + /** + * Gets info about a file. + * + * @param bucket the {@link Bucket} containing the file + * @param fileId the file id + * @param callback an implementation of the {@link GetFileCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getFile(Bucket bucket, String fileId, GetFileCallback callback) throws KeysNotFoundException { + getFile(bucket.getId(), fileId, callback); + } + + /** + * Gets info about a file. + * + * @param bucketId the id of the bucket containing the file + * @param fileId the file id + * @param callback an implementation of the {@link GetFileCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getFile(String bucketId, String fileId, GetFileCallback callback) throws KeysNotFoundException { + checkKeys(); + _getFile(bucketId, fileId, callback); + } + + /** + * Gets info about the specified list of files. + * + *+ * This method will issue a seperate request to the bridge for each file id from + * the list. The requests will run in parallel. The callback will be invoked + * once for each file id. The order of invoking the callback is undetermined and + * most likely will be different than the order of file ids in the list. + *
+ * + * @param bucket the {@link Bucket} containing the files + * @param fileIds an array of file ids + * @param callback an implementation of the {@link GetFileCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getFiles(Bucket bucket, String[] fileIds, GetFileCallback callback) throws KeysNotFoundException { + getFiles(bucket.getId(), fileIds, callback); + } + + /** + * Gets info about the specified list of files. + * + *+ * This method will issue a seperate request to the bridge for each file id from + * the list. The requests will run in parallel. The callback will be invoked + * once for each file id. The order of invoking the callback is undetermined and + * most likely will be different than the order of file ids in the list. + *
+ * + * @param bucketId the id of the bucket containing the files + * @param fileIds an array of file ids + * @param callback an implementation of the {@link GetFileCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getFiles(String bucketId, String[] fileIds, GetFileCallback callback) throws KeysNotFoundException { + checkKeys(); + for (String fileId : fileIds) { + _getFile(bucketId, fileId, callback); + } + } + + /** + * Gets the file id by the provided file name. + * + * @param bucket the {@link Bucket} containing the file + * @param fileName the file name + * @param callback an implementation of the {@link GetFileIdCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getFileId(Bucket bucket, String fileName, GetFileIdCallback callback) throws KeysNotFoundException { + getFileId(bucket.getId(), fileName, callback); + } + + /** + * Gets the file id by the provided file name. + * + * @param bucketId the id of the bucket containing the file + * @param fileName the file name + * @param callback an implementation of the {@link GetFileIdCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getFileId(String bucketId, String fileName, GetFileIdCallback callback) throws KeysNotFoundException { + checkKeys(); + _getFileId(bucketId, fileName, callback); + } + + /** + * Gets the file ids for the specified list of file names. + * + *+ * This method will issue a seperate request to the bridge for each file name + * from the list. The requests will run in parallel. The callback will be + * invoked once for each file name. The order of invoking the callback is + * undetermined and most likely will be different than the order of file names + * in the list. + *
+ * + * @param bucket the {@link Bucket} containing the files + * @param fileNames an array of file names + * @param callback an implementation of the {@link GetFileIdCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getFileIds(Bucket bucket, String[] fileNames, GetFileIdCallback callback) throws KeysNotFoundException { + getFileIds(bucket.getId(), fileNames, callback); + } + + /** + * Gets the file ids for the specified list of file names. + * + *+ * This method will issue a seperate request to the bridge for each file name + * from the list. The requests will run in parallel. The callback will be + * invoked once for each file name. The order of invoking the callback is + * undetermined and most likely will be different than the order of file names + * in the list. + *
+ * + * @param bucketId the id of the bucket containing the files + * @param fileNames an array of file names + * @param callback an implementation of the {@link GetFileIdCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void getFileIds(String bucketId, String[] fileNames, GetFileIdCallback callback) throws KeysNotFoundException { + checkKeys(); + for (String fileName : fileNames) { + _getFileId(bucketId, fileName, callback); + } + } + + /** + * Deletes a file. + * + * @param bucket the {@link Bucket} containing the file + * @param file the {@link File} to detele + * @param callback an implementation of the {@link DeleteFileCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void deleteFile(Bucket bucket, File file, DeleteFileCallback callback) throws KeysNotFoundException { + deleteFile(bucket.getId(), file.getId(), callback); + } + + /** + * Deletes a file. + * + * @param bucketId the id of the bucket containing the file + * @param fileId the id of the file to delete + * @param callback an implementation of the {@link DeleteFileCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void deleteFile(String bucketId, String fileId, DeleteFileCallback callback) throws KeysNotFoundException { + checkKeys(); + _deleteFile(bucketId, fileId, callback); + } + + /** + * Deletes the specified list of files. + * + *+ * This method will issue a seperate request to the bridge for each file from + * the list. The requests will run in parallel. The callback will be invoked + * once for each file. The order of invoking the callback is undetermined and + * most likely will be different than the order of files in the list. + *
+ * + * @param bucket the {@link Bucket} containing the files + * @param files an array of {@link File} objects to delete + * @param callback an implementation of the {@link DeleteFileCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void deleteFiles(Bucket bucket, File[] files, DeleteFileCallback callback) throws KeysNotFoundException { + deleteFiles(bucket.getId(), getFileIds(files), callback); + } + + /** + * Deletes the specified list of files. + * + *+ * This method will issue a seperate request to the bridge for each file id from + * the list. The requests will run in parallel. The callback will be invoked + * once for each file id. The order of invoking the callback is undetermined and + * most likely will be different than the order of file ids in the list. + *
+ * + * @param bucketId the id of the bucket containing the files + * @param fileIds an array of file ids to delete + * @param callback an implementation of the {@link DeleteFileCallback} interface to + * receive the response + * @throws KeysNotFoundException if the user's keys have not been imported yet + */ + public void deleteFiles(String bucketId, String[] fileIds, DeleteFileCallback callback) throws KeysNotFoundException { + checkKeys(); + for (String fileId : fileIds) { + _deleteFile(bucketId, fileId, callback); + } + } + + /** + * Downloads a file to the default download directory. + * + *+ * The default download directory can be configured using + * {@link #setDownloadDirectory(java.io.File)}. + *
+ * + * @param bucket the {@link Bucket} containing the file + * @param file the {@link File} to download + * @param callback an implementation of the {@link DownloadFileCallback} interface to + * receive the download progress + * @return a pointer to the download state that can be passed to + * {@link #_cancelDownload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #setDownloadDirectory(java.io.File) + * @see #cancelDownload(long) + */ + public long downloadFile(Bucket bucket, File file, DownloadFileCallback callback) throws KeysNotFoundException { + checkDownloadDir(); + String localPath = new java.io.File(downloadDir, file.getName()).getPath(); + return downloadFile(bucket, file, localPath, callback); + } + + /** + * Downloads a file to the provided local path. + * + * @param bucket the {@link Bucket} containing the file + * @param file the {@link File} to download + * @param localPath the local path (including file name) to download the file to + * @param callback an implementation of the {@link DownloadFileCallback} interface to + * receive the download progress + * @return a pointer to the download state that can be passed to + * {@link #_cancelDownload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelDownload(long) + */ + public long downloadFile(Bucket bucket, File file, String localPath, DownloadFileCallback callback) throws KeysNotFoundException { + return downloadFile(bucket.getId(), file.getId(), localPath, callback); + } + + /** + * Downloads a file to the provided local path. + * + * @param bucketId the id of the bucket containing the file + * @param fileId the id of the file to download + * @param localPath the local path (including file name) to download the file to + * @param callback an implementation of the {@link DownloadFileCallback} interface to + * receive the download progress + * @return a pointer to the download state that can be passed to + * {@link #_cancelDownload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelDownload(long) + */ + public long downloadFile(String bucketId, String fileId, String localPath, DownloadFileCallback callback) throws KeysNotFoundException { + checkKeys(); + return _downloadFile(bucketId, fileId, localPath, callback); + } + + /** + * Downloads the specified list of files to the default download directory. + * + *+ * The default download directory can be configured using + * {@link #setDownloadDirectory(java.io.File)}. + *
+ * + *+ * This method will download all files in parallel. The callback will be invoked + * for all files. The order of invoking the callback is undetermined and most + * likely will be different than the order of files in the list. + *
+ * + * @param bucket the {@link Bucket} containing the files + * @param files an array of {@link File} objects to download + * @param callback an implementation of the {@link DownloadFileCallback} interface to + * receive the download progress + * @return an array with pointers to the download state of each file that can be + * passed to {@link #_cancelDownload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #setDownloadDirectory(java.io.File) + * @see #cancelDownload(long) + */ + public long[] downloadFiles(Bucket bucket, File[] files, DownloadFileCallback callback) throws KeysNotFoundException { + checkDownloadDir(); + + String[] localPaths = new String[files.length]; + for (int i = 0; i < files.length; i++) { + localPaths[i] = new java.io.File(downloadDir, files[i].getName()).getPath(); + } + + return downloadFiles(bucket, files, localPaths, callback); + } + + /** + * Downloads the specified list of files to the provided local paths. + * + *+ * This method will download all files in parallel. The callback will be invoked + * for all files. The order of invoking the callback is undetermined and most + * likely will be different than the order of files in the list. + *
+ * + * @param bucket the {@link Bucket} containing the files + * @param files an array of {@link File} objects to download + * @param localPaths an array of local paths (including file name) to download the + * files to + * @param callback an implementation of the {@link DownloadFileCallback} interface to + * receive the download progress + * @return an array with pointers to the download state of each file that can be + * passed to {@link #_cancelDownload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelDownload(long) + */ + public long[] downloadFiles(Bucket bucket, File[] files, String[] localPaths, DownloadFileCallback callback) throws KeysNotFoundException { + return downloadFiles(bucket.getId(), getFileIds(files), localPaths, callback); + } + + /** + * Downloads the specified list of files to the provided local paths. + * + *+ * This method will download all files in parallel. The callback will be invoked + * for all files. The order of invoking the callback is undetermined and most + * likely will be different than the order of file ids in the list. + *
+ * + * @param bucketId the id of the bucket containing the files + * @param fileIds an array of file ids to download + * @param localPaths an array of local paths (including file name) to download the + * files to + * @param callback an implementation of the {@link DownloadFileCallback} interface to + * receive the download progress + * @return an array with pointers to the download state of each file that can be + * passed to {@link #_cancelDownload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelDownload(long) + */ + public long[] downloadFiles(String bucketId, String[] fileIds, String[] localPaths, DownloadFileCallback callback) throws KeysNotFoundException { + checkKeys(); + + long[] states = new long[fileIds.length]; + + for (int i = 0; i < fileIds.length; i++) { + states[i] = _downloadFile(bucketId, fileIds[i], localPaths[i], callback); + } + + return states; + } + + /** + * Cancels the file download for the specified download state. + * + * @param downloadState a pointer to the download state returned by the + *downloadFile() methods
+ * @return true if the download was canceled successfully,
+ * false otherwise
+ * @see #downloadFile(Bucket, File, DownloadFileCallback)
+ * @see #downloadFile(Bucket, File, String, DownloadFileCallback)
+ * @see #downloadFile(String, String, String, DownloadFileCallback)
+ */
+ public boolean cancelDownload(long downloadState) {
+ return _cancelDownload(downloadState);
+ }
+
+ /**
+ * Uploads a file to a bucket.
+ *
+ * + * This will upload the file with the same name it has on the local storage. + *
+ * + * @param bucket the {@link Bucket} to upload the file to + * @param localPath the local path (including file name) of the file to upload + * @param callback an implementation of the {@link UploadFileCallback} interface to + * receive the upload progress + * @return a pointer to the upload state that can be passed to + * {@link #_cancelUpload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelUpload(long) + */ + public long uploadFile(Bucket bucket, String localPath, UploadFileCallback callback) throws KeysNotFoundException { + return uploadFile(bucket.getId(), localPath, callback); + } + + /** + * Uploads a file to a bucket. + * + *+ * This will upload the file with the same name it has on the local storage. + *
+ * + * @param bucketId the id of the bucket to upload the file to + * @param localPath the local path (including file name) of the file to upload + * @param callback an implementation of the {@link UploadFileCallback} interface to + * receive the upload progress + * @return a pointer to the upload state that can be passed to + * {@link #_cancelUpload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelUpload(long) + */ + public long uploadFile(String bucketId, String localPath, UploadFileCallback callback) throws KeysNotFoundException { + return uploadFile(bucketId, new java.io.File(localPath).getName(), localPath, callback); + } + + /** + * Uploads a file to a bucket. + * + *+ * This allows uploading the file with a different name than the one it has on + * the local storage. + *
+ * + * @param bucket the {@link Bucket} to upload the file to + * @param fileName the name to assign to the uploaded file + * @param localPath the local path (including file name) of the file to upload + * @param callback an implementation of the {@link UploadFileCallback} interface to + * receive the upload progress + * @return a pointer to the upload state that can be passed to + * {@link #_cancelUpload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelUpload(long) + */ + public long uploadFile(Bucket bucket, String fileName, String localPath, UploadFileCallback callback) throws KeysNotFoundException { + return uploadFile(bucket.getId(), fileName, localPath, callback); + } + + /** + * Uploads a file to a bucket. + * + *+ * This allows uploading the file with a different name than the one it has on + * the local storage. + *
+ * + * @param bucketId the id of the bucket to upload the file to + * @param fileName the name to assign to the uploaded file + * @param localPath the local path (including file name) of the file to upload + * @param callback an implementation of the {@link UploadFileCallback} interface to + * receive the upload progress + * @return a pointer to the upload state that can be passed to + * {@link #_cancelUpload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelUpload(long) + */ + public long uploadFile(String bucketId, String fileName, String localPath, UploadFileCallback callback) throws KeysNotFoundException { + checkKeys(); + return _uploadFile(bucketId, fileName, localPath, callback); + } + + /** + * Uploads the specified list of files. + * + *+ * This will upload the files with the same name they have on the local storage. + *
+ * + *+ * This method will upload all files in parallel. The callback will be invoked + * for all files. The order of invoking the callback is undetermined and most + * likely will be different than the order of file ids in the list. + *
+ * + * @param bucket the {@link Bucket} to upload the files to + * @param localPaths the local paths (including file name) of the files to upload + * @param callback an implementation of the {@link UploadFileCallback} interface to + * receive the upload progress + * @return an array of pointers to the upload state of each file that can be + * passed to {@link #_cancelUpload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelUpload(long) + */ + public long[] uploadFiles(Bucket bucket, String[] localPaths, UploadFileCallback callback) throws KeysNotFoundException { + return uploadFiles(bucket.getId(), localPaths, callback); + } + + /** + * Uploads the specified list of files. + * + *+ * This will upload the files with the same name they have on the local storage. + *
+ * + *+ * This method will upload all files in parallel. The callback will be invoked + * for all files. The order of invoking the callback is undetermined and most + * likely will be different than the order of file ids in the list. + *
+ * + * @param bucketId the id of the bucket to upload the files to + * @param localPaths the local paths (including file name) of the files to upload + * @param callback an implementation of the {@link UploadFileCallback} interface to + * receive the upload progress + * @return an array of pointers to the upload state of each file that can be + * passed to {@link #_cancelUpload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelUpload(long) + */ + public long[] uploadFiles(String bucketId, String[] localPaths, UploadFileCallback callback) throws KeysNotFoundException { + String[] fileNames = new String[localPaths.length]; + for (int i = 0; i < localPaths.length; i++) { + fileNames[i] = new java.io.File(localPaths[i]).getName(); + } + + return uploadFiles(bucketId, fileNames, localPaths, callback); + } + + /** + * Uploads the specified list of files. + * + *+ * This allows uploading the files with a different name than the ones they have + * on the local storage. + *
+ * + *+ * This method will upload all files in parallel. The callback will be invoked + * for all files. The order of invoking the callback is undetermined and most + * likely will be different than the order of file ids in the list. + *
+ * + * @param bucket the {@link Bucket} to upload the files to + * @param fileNames an array of names to assign to the uploaded files + * @param localPaths the local paths (including file name) of the files to upload + * @param callback an implementation of the {@link UploadFileCallback} interface to + * receive the upload progress + * @return an array of pointers to the upload state of each file that can be + * passed to {@link #_cancelUpload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelUpload(long) + */ + public long[] uploadFiles(Bucket bucket, String[] fileNames, String[] localPaths, UploadFileCallback callback) throws KeysNotFoundException { + return uploadFiles(bucket.getId(), fileNames, localPaths, callback); + } + + /** + * Uploads the specified list of files. + * + *+ * This allows uploading the files with a different name than the ones they have + * on the local storage. + *
+ * + *+ * This method will upload all files in parallel. The callback will be invoked + * for all files. The order of invoking the callback is undetermined and most + * likely will be different than the order of file ids in the list. + *
+ * + * @param bucketId the id of the bucket to upload the files to + * @param fileNames an array of names to assign to the uploaded files + * @param localPaths the local paths (including file name) of the files to upload + * @param callback an implementation of the {@link UploadFileCallback} interface to + * receive the upload progress + * @return an array of pointers to the upload state of each file that can be + * passed to {@link #_cancelUpload(long)} + * @throws KeysNotFoundException if the user's keys have not been imported yet + * @see #cancelUpload(long) + */ + public long[] uploadFiles(String bucketId, String[] fileNames, String[] localPaths, UploadFileCallback callback) throws KeysNotFoundException { + checkKeys(); + + long[] states = new long[fileNames.length]; + + for (int i = 0; i < fileNames.length; i++) { + states[i] = _uploadFile(bucketId, fileNames[i], localPaths[i], callback); + } + + return states; + } + + /** + * Cancels the file upload for the specified upload state. + * + * @param uploadState a pointer to the upload state returned by the + *uploadFile() methods
+ * @return true if the upload was canceled successfully,
+ * false otherwise
+ * @see #uploadFile(Bucket, String, UploadFileCallback)
+ * @see #uploadFile(String, String, UploadFileCallback)
+ * @see #uploadFile(Bucket, String, String, UploadFileCallback)
+ * @see #uploadFile(String, String, String, UploadFileCallback)
+ */
+ public boolean cancelUpload(long uploadState) {
+ return _cancelUpload(uploadState);
+ }
+
+ private String[] getBucketIds(Bucket[] buckets) {
+ String[] bucketIds = new String[buckets.length];
+ for (int i = 0; i < buckets.length; i++) {
+ bucketIds[i] = buckets[i].getId();
+ }
+ return bucketIds;
+ }
+
+ private String[] getFileIds(File[] files) {
+ String[] fileIds = new String[files.length];
+ for (int i = 0; i < files.length; i++) {
+ fileIds[i] = files[i].getId();
+ }
+ return fileIds;
+ }
+
+ private java.io.File getAuthFile() throws IllegalStateException {
+ if (configDir == null) {
+ throw new IllegalStateException("config dir is not set");
+ }
+ return new java.io.File(configDir, host + ".auth");
+ }
+
+ private void checkDownloadDir() throws IllegalStateException {
+ if (downloadDir == null) {
+ throw new IllegalStateException("Download directory is not set");
+ }
+ }
+
+ private void checkKeys() throws KeysNotFoundException {
+ if (getKeys("") == null) {
+ throw new KeysNotFoundException();
+ }
+ }
+
+ private interface ProjectRunnable {
+ void run(Project project) throws Exception;
+ }
+
+ private interface BucketRunnable {
+ void run(io.storj.libuplink.mobile.Bucket bucket) throws Exception;
+ }
+
+ private void runInProject(ProjectRunnable runnable) throws Exception {
+ Config config = new Config();
+ Uplink uplink = new Uplink(config, System.getenv("STORJ_TEMP"));
+ try {
+ ProjectOptions options = new ProjectOptions();
+ options.setEncryptionKey(keys.getEncryptionKey().getBytes());
+
+ Project project = uplink.openProject(addr, keys.getApiKey(), options);
+ try {
+ runnable.run(project);
+ } finally {
+ project.close();
+ }
+ } finally {
+ uplink.close();
+ }
+ }
+
+ private void runInBucket(final String bucketId, final BucketRunnable runnable) throws Exception {
+ runInProject(new ProjectRunnable() {
+ @Override
+ public void run(Project project) throws Exception {
+ BucketAccess access = new BucketAccess();
+ access.setPathEncryptionKey(keys.getEncryptionKey().getBytes());
+ io.storj.libuplink.mobile.Bucket bucket = project.openBucket(bucketId, access);
+ try {
+ runnable.run(bucket);
+ } finally {
+ bucket.close();
+ }
+ }
+ });
+ }
+
+ private void _getBuckets(final GetBucketsCallback callback) {
+ try {
+ runInProject(new ProjectRunnable() {
+ @Override
+ public void run(Project project) throws Exception {
+ ListuploadFile() and uploadFiles() methods.
+ *
+ * @see Storj#uploadFile(Bucket, String, UploadFileCallback)
+ * @see Storj#uploadFile(String, String, UploadFileCallback)
+ * @see Storj#uploadFile(Bucket, String, String, UploadFileCallback)
+ * @see Storj#uploadFile(String, String, String, UploadFileCallback)
+ * @see Storj#uploadFiles(Bucket, String[], UploadFileCallback)
+ * @see Storj#uploadFiles(String, String[], UploadFileCallback)
+ * @see Storj#uploadFiles(Bucket, String[], String[], UploadFileCallback)
+ * @see Storj#uploadFiles(String, String[], String[], UploadFileCallback)
+ */
+public interface UploadFileCallback {
+
+ /**
+ * Called when new progress is reported.
+ *
+ * @param filePath
+ * the local path (including file name) of the file being uploaded
+ * @param progress
+ * the current progress from 0 to 1, e.g.
+ * 0.75 means 75% completed
+ * @param uploadedBytes
+ * the number of bytes already uploaded
+ * @param totalBytes
+ * the total bytes to be uploaded
+ */
+ void onProgress(String filePath, double progress, long uploadedBytes, long totalBytes);
+
+ /**
+ * Called if the file was uploaded successfully.
+ *
+ * @param filePath
+ * the local path (including file name) of the uploaded file
+ * @param file
+ * a {@link File} object of the uploaded file
+ */
+ void onComplete(String filePath, File file);
+
+ /**
+ * Called if uploaded the file finished with error.
+ *
+ * @param filePath
+ * the local path (including file name) of the file being uploaded
+ * @param code
+ * the error code
+ * @param message
+ * the error message
+ */
+ void onError(String filePath, int code, String message);
+
+}
diff --git a/android-libstorj/src/main/java/io/storj/libstorj/android/StorjAndroid.java b/android-libstorj/src/main/java/io/storj/libstorj/android/StorjAndroid.java
index 9284de8..f7b9bb1 100644
--- a/android-libstorj/src/main/java/io/storj/libstorj/android/StorjAndroid.java
+++ b/android-libstorj/src/main/java/io/storj/libstorj/android/StorjAndroid.java
@@ -51,12 +51,12 @@ private StorjAndroid() {
* The returned instance will be an existing instance when possible.
* *Calling this method compared to the {@link Storj} constructor will do the required - * initialization for the libstorj library to work correctly on Android. For example:
+ * initialization for the io.storj.libstorj library to work correctly on Android. For example: *