2 // PithosFileUtilities.h
5 // Copyright 2011 GRNET S.A. All rights reserved.
7 // Redistribution and use in source and binary forms, with or
8 // without modification, are permitted provided that the following
11 // 1. Redistributions of source code must retain the above
12 // copyright notice, this list of conditions and the following
15 // 2. Redistributions in binary form must reproduce the above
16 // copyright notice, this list of conditions and the following
17 // disclaimer in the documentation and/or other materials
18 // provided with the distribution.
20 // THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
21 // OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
22 // WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
24 // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
27 // USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28 // AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 // LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
30 // ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31 // POSSIBILITY OF SUCH DAMAGE.
33 // The views and conclusions contained in the software and
34 // documentation are those of the authors and should not be
35 // interpreted as representing official policies, either expressed
36 // or implied, of GRNET S.A.
38 @class ASIPithosRequest;
39 @class ASIPithosObjectRequest;
41 @interface PithosFileUtilities : NSObject
43 + (ASIPithosObjectRequest *)objectDataRequestWithContainerName:(NSString *)containerName
44 objectName:(NSString *)objectName
45 toDirectory:(NSString *)directoryPath
46 checkIfExists:(BOOL)ifExists;
47 + (NSArray *)objectDataRequestsForSubdirWithContainerName:(NSString *)containerName
48 objectName:(NSString *)objectName
49 toDirectory:(NSString *)directoryPath
50 checkIfExists:(BOOL)ifExists;
52 + (ASIPithosObjectRequest *)writeObjectDataRequestWithContainerName:(NSString *)containerName
53 objectName:(NSString *)objectName
54 contentType:(NSString *)contentType
55 blockSize:(NSUInteger)blockSize
56 blockHash:(NSString *)blockHash
57 forFile:(NSString *)filePath
58 checkIfExists:(BOOL)ifExists
59 hashes:(NSArray **)hashes;
60 + (NSIndexSet *)missingBlocksForHashes:(NSArray *)hashes withMissingHashesResponse:(NSString *)missingHashesResponse;
61 + (ASIPithosObjectRequest *)updateObjectDataRequestWithContainerName:(NSString *)containerName
62 objectName:(NSString *)objectName
63 contentType:(NSString *)contentType
64 blockSize:(NSUInteger)blockSize
65 forFile:(NSString *)filePath
66 hashes:(NSArray *)hashes
67 missingHashesResponse:(NSString *)missingHashesResponse;
68 + (ASIPithosObjectRequest *)updateObjectDataRequestWithContainerName:(NSString *)containerName
69 objectName:(NSString *)objectName
70 contentType:(NSString *)contentType
71 blockSize:(NSUInteger)blockSize
72 forFile:(NSString *)filePath
73 missingBlockIndex:(NSUInteger)missingBlockIndex;
74 + (NSArray *)writeObjectDataRequestsWithContainerName:(NSString *)containerName
75 objectName:(NSString *)objectName
76 blockSize:(NSUInteger)blockSize
77 blockHash:(NSString *)blockHash
78 forDirectory:(NSString *)directoryPath
79 checkIfExists:(BOOL)ifExists
80 objectNames:(NSMutableArray **)objectNames
81 contentTypes:(NSMutableArray **)contentTypes
82 filePaths:(NSMutableArray **)filePaths
83 hashesArrays:(NSMutableArray **)hashesArrays;
86 + (NSUInteger)bytesOfFile:(NSString *)filePath;
87 + (NSString *)contentTypeOfFile:(NSString *)filePath error:(NSError **)error;
88 + (BOOL)objectExistsAtContainerName:(NSString *)containerName objectName:(NSString *)objectName
89 responseString:(NSString **)responseString error:(NSError **)error isDirectory:(BOOL *)isDirectory;
90 + (int)deleteObjectAtContainerName:(NSString *)containerName objectName:(NSString *)objectName
91 responseStatusMessage:(NSString **)responseStatusMessage error:(NSError **)error;
93 + (NSInteger)httpRequestErrorAlertWithRequest:(ASIPithosRequest *)request;
94 + (NSInteger)unexpectedResponseStatusAlertWithRequest:(ASIPithosRequest *)request;