Synnefo » Pithos MacOS Client

//

//  PithosUtilities.h

//  pithos-macos

//

// Copyright 2011 GRNET S.A. All rights reserved.

//

// Redistribution and use in source and binary forms, with or

// without modification, are permitted provided that the following

// conditions are met:

// 

//   1. Redistributions of source code must retain the above

//      copyright notice, this list of conditions and the following

//      disclaimer.

// 

//   2. Redistributions in binary form must reproduce the above

//      copyright notice, this list of conditions and the following

//      disclaimer in the documentation and/or other materials

//      provided with the distribution.

// 

// THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS

// OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

// WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR

// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF

// USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED

// AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

// LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN

// ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

// POSSIBILITY OF SUCH DAMAGE.

// 

// The views and conclusions contained in the software and

// documentation are those of the authors and should not be

// interpreted as representing official policies, either expressed

// or implied, of GRNET S.A.

@class ASIPithosRequest;

@class ASIPithosContainerRequest;

@class ASIPithosObjectRequest;

@class ASIPithosObject;

@interface PithosUtilities : NSObject

+ (ASIPithosObjectRequest *)objectDataRequestWithContainerName:(NSString *)containerName 

                                                    objectName:(NSString *)objectName 

                                                   toDirectory:(NSString *)directoryPath 

                                                 checkIfExists:(BOOL)ifExists 

                                                sharingAccount:(NSString *)sharingAccount;

+ (NSArray *)objectDataRequestsForSubdirWithContainerName:(NSString *)containerName 

                                               objectName:(NSString *)objectName 

                                              toDirectory:(NSString *)directoryPath 

                                            checkIfExists:(BOOL)ifExists 

                                           sharingAccount:(NSString *)sharingAccount;

+ (ASIPithosObjectRequest *)objectBlockDataRequestWithContainerName:(NSString *)containerName 

                                                             object:(ASIPithosObject *)object 

                                                         blockIndex:(NSUInteger)blockIndex 

                                                          blockSize:(NSUInteger)blockSize;

+ (NSIndexSet *)missingBlocksForFile:(NSString *)filePath

                           blockSize:(NSUInteger)blockSize 

                           blockHash:(NSString *)blockHash 

                          withHashes:(NSArray *)hashes;

+ (ASIPithosObjectRequest *)writeObjectDataRequestWithContainerName:(NSString *)containerName

                                                         objectName:(NSString *)objectName

                                                        contentType:(NSString *)contentType 

                                                          blockSize:(NSUInteger)blockSize 

                                                          blockHash:(NSString *)blockHash 

                                                            forFile:(NSString *)filePath 

                                                      checkIfExists:(BOOL)ifExists 

                                                             hashes:(NSArray **)hashes 

                                                     sharingAccount:(NSString *)sharingAccount;

+ (NSIndexSet *)missingBlocksForHashes:(NSArray *)hashes withMissingHashesResponse:(NSString *)missingHashesResponse;

+ (ASIPithosContainerRequest *)updateContainerDataRequestWithContainerName:(NSString *)containerName 

                                                                 blockSize:(NSUInteger)blockSize 

                                                                   forFile:(NSString *)filePath 

                                                                    hashes:(NSArray *)hashes 

                                                     missingHashesResponse:(NSString *)missingHashesResponse 

                                                            sharingAccount:(NSString *)sharingAccount;

+ (ASIPithosContainerRequest *)updateContainerDataRequestWithContainerName:(NSString *)containerName 

                                                                 blockSize:(NSUInteger)blockSize 

                                                                   forFile:(NSString *)filePath 

                                                         missingBlockIndex:(NSUInteger)missingBlockIndex 

                                                            sharingAccount:(NSString *)sharingAccount;

+ (NSArray *)writeObjectDataRequestsWithContainerName:(NSString *)containerName

                                           objectName:(NSString *)objectName

                                            blockSize:(NSUInteger)blockSize 

                                            blockHash:(NSString *)blockHash 

                                         forDirectory:(NSString *)directoryPath 

                                        checkIfExists:(BOOL)ifExists 

                                          objectNames:(NSMutableArray **)objectNames

                                         contentTypes:(NSMutableArray **)contentTypes

                                            filePaths:(NSMutableArray **)filePaths 

                                         hashesArrays:(NSMutableArray **)hashesArrays 

                              directoryObjectRequests:(NSMutableArray **) directoryObjectRequests 

                                       sharingAccount:(NSString *)sharingAccount;

+ (NSArray *)deleteObjectRequestsForSubdirWithContainerName:(NSString *)containerName objectName:(NSString *)objectName;

+ (ASIPithosObjectRequest *)copyObjectRequestWithContainerName:(NSString *)containerName 

                                                    objectName:(NSString *)objectName 

                                      destinationContainerName:(NSString *)destinationContainerName 

                                         destinationObjectName:(NSString *)destinationObjectName 

                                                 checkIfExists:(BOOL)ifExists 

                                                sharingAccount:(NSString *)sharingAccount;

+ (NSArray *)copyObjectRequestsForSubdirWithContainerName:(NSString *)containerName 

                                               objectName:(NSString *)objectName 

                                 destinationContainerName:(NSString *)destinationContainerName 

                                    destinationObjectName:(NSString *)destinationObjectName 

                                            checkIfExists:(BOOL)ifExists 

                                           sharingAccount:(NSString *)sharingAccount;

+ (ASIPithosObjectRequest *)moveObjectRequestWithContainerName:(NSString *)containerName 

                                                    objectName:(NSString *)objectName 

                                      destinationContainerName:(NSString *)destinationContainerName 

                                         destinationObjectName:(NSString *)destinationObjectName 

                                                 checkIfExists:(BOOL)ifExists;

+ (NSArray *)moveObjectRequestsForSubdirWithContainerName:(NSString *)containerName 

                                               objectName:(NSString *)objectName 

                                 destinationContainerName:(NSString *)destinationContainerName 

                                    destinationObjectName:(NSString *)destinationObjectName 

                                            checkIfExists:(BOOL)ifExists;

+ (NSUInteger)bytesOfFile:(NSString *)filePath;

+ (NSString *)contentTypeOfFile:(NSString *)filePath error:(NSError **)error;

+ (BOOL)isContentTypeDirectory:(NSString *)contentType;

+ (BOOL)objectExistsAtContainerName:(NSString *)containerName objectName:(NSString *)objectName

                              error:(NSError **)error isDirectory:(BOOL *)isDirectory sharingAccount:(NSString *)sharingAccount;

+ (BOOL)proceedIfObjectExistsAtContainerName:(NSString *)containerName objectName:(NSString *)objectName 

                              sharingAccount:(NSString *)sharingAccount;

+ (NSArray *)objectsWithContainerName:(NSString *)containerName objectNamePrefix:(NSString *)objectNamePrefix

                            delimiter:(NSString *)delimiter sharingAccount:(NSString *)sharingAccount;

+ (NSArray *)objectsForSubdirWithContainerName:(NSString *)containerName objectName:(NSString *)objectName

                                     delimiter:(NSString *)delimiter sharingAccount:(NSString *)sharingAccount;

+ (NSString *)safeObjectNameForContainerName:(NSString *)containerName objectName:(NSString *)objectName;

+ (NSString *)safeSubdirNameForContainerName:(NSString *)containerName subdirName:(NSString *)subdirName;

+ (NSInteger)httpRequestErrorAlertWithRequest:(ASIPithosRequest *)request;

+ (NSInteger)unexpectedResponseStatusAlertWithRequest:(ASIPithosRequest *)request;

+ (NSInteger)fileActionFailedAlertWithTitle:(NSString *)title message:(NSString *)message error:(NSError *)error;

+ (ASIPithosRequest *)prepareRequest:(ASIPithosRequest *)request priority:(NSOperationQueuePriority)priority;

+ (ASIPithosRequest *)prepareRequest:(ASIPithosRequest *)request;

+ (ASIPithosRequest *)copyRequest:(ASIPithosRequest *)request;

@end