These classes have all the code that we need to manage the supported Cloud Services. There is code to list items, rename a file, delete a file, delete a folder, download a file, upload a file, and get information for the logged in user. <\/p>\n\n\n\n
We create an instance of that class by calling the constructor RManager(RServiceItem _serviceItem):<\/p>\n\n\n\n
RManager rManager = new RManager(RServiceItem _serviceItem);<\/code><\/pre>\n\n\n\nwhere rService is an instance of the ServiceItem<\/a> class. <\/p>\n\n\n\nEven though we can create an instance of the Cloud Manager class by calling the default constructor, we strongly advise against it. The instance of the ServiceItem class that we pass to the Cloud Manager class has all the information that we need to authenticate the user when we make a request to that Cloud Service.<\/p><\/blockquote>\n\n\n\n
Methods<\/h2>\n\n\n\n
The Cloud Manager has several methods. Some of them are used internally, but there are some that we need to call in order to manage that Cloud Service:<\/p>\n\n\n\n
- getFilesInFolder<\/strong>(String path): Get the list of items (files and folders) in a folder. The path is the rItem.path<\/a>. We get the response from the method filesListIsReady<\/strong> of the RManagerCallback<\/strong> callback<\/li>
- searchItemsInFolder<\/strong>:(String <\/em>path, String <\/em>key, SearchTypes type): Search for files and folders in a folder. The path is the rItem.path<\/a>. We get the response from the method filesListIsReady<\/strong> of the RManagerCallback<\/strong> callback. The SearchType is an enum with the following two values:
- stFile<\/strong>: Returns files\/folders whose name matches the key<\/li>
- stFileAndContent<\/strong>: Return files\/folders whose name matches the key, but also returns file(s) whose content contains that key<\/li><\/ul><\/li>
- downloadFile<\/strong>(RItem file): We call this method to download a file. We get the response from the onFileToBeDownloaded<\/strong> of the RManagerDownloadCallback<\/strong> callback.<\/li>
- uploadLocalFile<\/strong>(RItem file, String path): We call this method to upload a file to a folder. The path is the rItem.path of that folder. We get the response from the method onFileIsReadyToBeUploaded<\/strong> of the RManagerTransferCallback<\/strong> callback<\/li>
- deleteFile<\/strong>(RItem file): A method to delete a file. We get the response from the method ioTaskCompletedWithResponse<\/strong> of the RManagerCallback<\/strong> callback<\/li>
- deleteFolder<\/strong>(RItem folder): A method to delete a folder. It does not delete the folder recursively. You need to delete the files subfolders that are contained in that folder. We get the response from the method ioTaskCompletedWithResponse<\/strong> of the RManagerCallback<\/strong> callback<\/li>
- renameFile<\/strong>(RItem file, String fileName): A method to rename a file. We get the response from the method ioTaskCompletedWithResponse<\/strong> of the RManagerCallback<\/strong> callback<\/li>
- createFolder<\/strong>(String folderName, String parentFolder): A method to create a new folder (named folderName) in the parentFolder path. We get the response from the method ioTaskCompletedWithResponse<\/strong> of the RManagerCallback<\/strong> callback<\/li><\/ul>\n\n\n\n
We always call the method uploadLocalFile<\/strong> to upload a file, regardless of the file size. If it is needed, the Rainbow SDK will create a session and upload that file in chunks.<\/p>\n\n\n\nCallbacks<\/h2>\n\n\n\n
The Cloud Manager class uses the following delegates:<\/p>\n\n\n\n
- RManagerCallback<\/strong>:
- filesListIsReady<\/strong>(ArrayList<RItem> items): This method is called when the SDK has the list of items (files and folders) in the selected folder (either because we browsed that folder or we searched in that folder)<\/li>
- somethingWasWrong<\/strong>: This method is called every time there was a problem with a request<\/li>
- ioTaskCompletedWithResponse<\/strong>(String newID, CloudManagerActions action): This method is called when we make a request to rename a file, delete a file (or folder) and create a new folder. The action will inform us about the action that took place. When we create a new folder, the newID is the itemID of that folder. In all other cases it is an empty string<\/li><\/ul><\/li>
- RManagerTransferCallback<\/strong>:
- onFileIsReadyToBeUploaded<\/strong>:(RItem file, RTransferItem transferItem, booleaan status): This method is called when we call the method to upload a file. The object transferItem has all the information that we need to upload that file. The status is a flag to indicate if the process was successful or not. You shouldn’t use the transferItem if that flag is NO.<\/li><\/ul><\/li>
- RManagerDownloadCallback<\/strong>:
- onFileToBeDownloaded<\/strong>(RTransferItem transferItem): The object transferItem has all the information that we need to download a file<\/li><\/ul><\/li>
- RManagerAccountCallback<\/strong>
- onAccount<\/strong>(RAccount raccount):The object rAccount<\/a> has some information about the logged in user.<\/li><\/ul><\/li><\/ul>\n\n\n\n
Summary<\/h2>\n\n\n\n