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 initWithServiceItem:<\/p>\n\n\n\n
RManager *rManager = [[RManager alloc]initWithServiceItem:rServiceItem];<\/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 init method, 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>:(NSString*)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 RManagerDelegate<\/strong> delegate<\/li>
- searchItemsInFolder<\/strong>:(NSString*)path <\/em>forKey<\/strong>:<\/strong>(<\/em>NSString*<\/em>)key forType:<\/strong>(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> block.<\/li>
- uploadLocalFile<\/strong>:(RItem)file toPath<\/strong>:(NSString)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 RManagerTransferDelegate<\/strong> delegate<\/li>
- deleteFile<\/strong>:(RItem*)file: A method to delete a file. We get the response from the method ioTaskCompletedWithResponse<\/strong> of the RManagerDelegate<\/strong> delegate<\/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 RManagerDelegate<\/strong> delegate<\/li>
- renameFile<\/strong>:(RItem)file toFileName<\/strong>:(NSString)fileName: A method to rename a file. We get the response from the method ioTaskCompletedWithResponse<\/strong> of the RManagerDelegate<\/strong> delegate<\/li>
- createFolder<\/strong>:(NSString)folderName atPath<\/strong>:(NSString)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 RManagerDelegate<\/strong> delegate<\/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\nDelegates<\/h2>\n\n\n\n
The Cloud Manager class uses the following delegates:<\/p>\n\n\n\n
- RManagerDelegate<\/strong>:
- filesListIsReady<\/strong>: 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). That list is saved in the property availableFiles<\/strong> of the Cloud Manager instance (this will change in the future)<\/li>
- somethingWasWrong<\/strong>: This method is called every time there was a problem with a request<\/li>
- ioTaskCompletedWithResponse<\/strong>:(NSString*)newID forAction<\/strong>:(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>
- RManagerTransferDelegate<\/strong>:
- onFileIsReadyToBeUploaded<\/strong>:(RItem)file withSyncObj<\/strong>:(RTransferItem)upObj andStatus<\/strong>:(BOOL)status: This method is called when we call the method to upload a file. The object upObj 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 upObj if that flag is NO.<\/li><\/ul><\/li><\/ul>\n\n\n\n
Blocks<\/h2>\n\n\n\n
The Cloud Manager also uses the following blocks:<\/p>\n\n\n\n
- (^onFileToBeDownloaded<\/strong>)(RTransferItem *downObj): The object downObj has all the information that we need to download a file<\/li>
- (^onAccount<\/strong>)(RAccount *rAccount): The object rAccount<\/a> has some information about the logged in user.<\/li><\/ul>\n\n\n\n
Summary<\/h2>\n\n\n\n