Synnefo » Pithos MacOS & iOS Common Lib

//  ASIPithosObjectRequest.m

//  Based on ASICloudFilesObjectRequest.m

//

// Copyright 2011-2012 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.

#import "ASIPithosObjectRequest.h"

#import "ASIPithos.h"

#import "ASIPithosObject.h"

@interface ASIPithosObjectRequest (Private)

- (void)parseXMLData;

- (void)prepareObjectRequestWithETag:(NSString *)eTag 

                         contentType:(NSString *)contentType 

                     contentEncoding:(NSString *)contentEncoding 

                  contentDisposition:(NSString *)contentDisposition 

                            manifest:(NSString *)manifest 

                             sharing:(NSString *)sharing 

                            isPublic:(NSUInteger)isPublic 

                            metadata:(NSDictionary *)newMetadata;

@end

@implementation ASIPithosObjectRequest

@synthesize objectRequestType;

@synthesize containerName, objectName;

@synthesize currentObject;

#pragma mark -

#pragma mark Constructors

+ (id)storageRequestWithMethod:(NSString *)method pithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                   queryString:(NSString *)queryString {

    NSString *urlString = [NSString stringWithFormat:@"%@/%@/%@", 

                           pithos.storageURL, 

                           [self encodeToPercentEscape:containerName], 

                           [((NSString *)CFURLCreateStringByAddingPercentEscapes(NULL, 

                                                                                 (CFStringRef)objectName, 

                                                                                 NULL, 

                                                                                 (CFStringRef)@"!*'();:@&=+$,?%#[]", 

                                                                                 kCFStringEncodingUTF8)) autorelease]];

    if (queryString)

        urlString = [urlString stringByAppendingString:queryString];

	ASIPithosObjectRequest *request = [[[self alloc] initWithURL:[NSURL URLWithString:urlString]] autorelease];

	[request setRequestMethod:method];

	[request addRequestHeader:@"X-Auth-Token" value:pithos.authToken];

    request.containerName = containerName;

    request.objectName = objectName;

	return request;

}

+ (id)storageRequestWithMethod:(NSString *)method pithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName {

	return [self storageRequestWithMethod:method pithos:pithos containerName:containerName objectName:(NSString *)objectName queryString:nil];

}

#pragma mark -

#pragma mark Memory Management

- (void)dealloc {

    [currentObject release];

    [versions release];

    [hashes release];

    [blockHash release];

    [objectName release];

    [containerName release];

	[super dealloc];

}

#pragma mark -

#pragma mark Internal

- (void)parseXMLData {

    if ((objectRequestType == ASIPithosObjectRequestHashmap)|| (objectRequestType == ASIPithosObjectRequestHashmapWrite)) {

        hashes = [[NSMutableArray alloc] init];

    } else if (objectRequestType == ASIPithosObjectRequestVersions) {

        versions = [[NSMutableArray alloc] init];

    }

    NSXMLParser *parser = [[[NSXMLParser alloc] initWithData:[self responseData]] autorelease];

    [parser setDelegate:self];

    [parser setShouldProcessNamespaces:NO];

    [parser setShouldReportNamespacePrefixes:NO];

    [parser setShouldResolveExternalEntities:NO];

    [parser parse];

}

- (void)prepareObjectRequestWithETag:(NSString *)eTag 

                         contentType:(NSString *)contentType 

                     contentEncoding:(NSString *)contentEncoding 

                  contentDisposition:(NSString *)contentDisposition 

                            manifest:(NSString *)manifest 

                             sharing:(NSString *)sharing 

                            isPublic:(NSUInteger)isPublic 

                            metadata:(NSDictionary *)newMetadata {

    if (eTag)

        [self addRequestHeader:@"ETag" value:eTag];

    if (contentType)

        [self addRequestHeader:@"Content-Type" value:contentType];

    if (contentEncoding)

        [self addRequestHeader:@"Content-Encoding" value:[self encodeToPercentEscape:contentEncoding]];

    if (contentDisposition)

        [self addRequestHeader:@"Content-Disposition" value:[self encodeToPercentEscape:contentDisposition]];

    if (manifest)

        [self addRequestHeader:@"X-Object-Manifest" value:[self encodeToPercentEscape:manifest]];

    if (sharing)

        [self addRequestHeader:@"X-Object-Sharing" value:[self encodeToPercentEscape:sharing]];

    if (isPublic == ASIPithosObjectRequestPublicTrue) {

        [self addRequestHeader:@"X-Object-Public" value:@"true"];

    } else if (isPublic == ASIPithosObjectRequestPublicFalse) {

        [self addRequestHeader:@"X-Object-Public" value:@"false"];

    }

    if (newMetadata) {

        for (NSString *key in [newMetadata keyEnumerator]) {

            [self addRequestHeader:[self encodeToPercentEscape:[NSString stringWithFormat:@"X-Object-Meta-%@", key]] 

                             value:[self encodeToPercentEscape:[newMetadata objectForKey:key]]];

        }

    }

}

#pragma mark -

#pragma mark HEAD

// HEAD storageURL/container/object

+ (id)objectMetadataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName {

    return [self storageRequestWithMethod:@"HEAD" pithos:pithos containerName:containerName objectName:objectName];

}

// HEAD storageURL/container/object?[version=version]

+ (id)objectMetadataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                              version:(NSString *)version {

    NSString *queryString = nil;

    if (version)

        queryString = [NSString stringWithFormat:@"?version=%@", version];

	return [self storageRequestWithMethod:@"HEAD" pithos:pithos containerName:containerName objectName:objectName queryString:queryString];

}

// HEAD storageURL/container/object?[version=version] [If-Match]

+ (id)objectMetadataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                              version:(NSString *)version 

                              ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectMetadataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfMatchHeader:matchETag];

    return request;

}

// HEAD storageURL/container/object?[version=version] [If-None-Match]

+ (id)objectMetadataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                              version:(NSString *)version 

                          ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectMetadataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;

}

// HEAD storageURL/container/object?[version=version] [If-Modified-Since]

+ (id)objectMetadataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                              version:(NSString *)version 

                      ifModifiedSince:(NSDate *)sinceTimestamp {

    ASIPithosObjectRequest *request = [self objectMetadataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfModifiedSinceHeader:sinceTimestamp];

    return request;

}

// HEAD storageURL/container/object?[version=version] [If-Unmodified-Since]

+ (id)objectMetadataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                              version:(NSString *)version 

                    ifUnmodifiedSince:(NSDate *)sinceTimestamp {

    ASIPithosObjectRequest *request = [self objectMetadataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfUnmodifiedSinceHeader:sinceTimestamp];

    return request;

}

- (NSString *)eTag {

    // Etag, instead of ETag, because CFNetwork changes it

    // http://groups.google.com/group/asihttprequest/browse_thread/thread/7119f1a0ccf26fdf

	return [[self responseHeaders] objectForKey:@"Etag"];

}

- (NSString *)objectHash {

    return [[self responseHeaders] objectForKey:@"X-Object-Hash"];

}

- (NSString *)UUID {

    return [[self responseHeaders] objectForKey:@"X-Object-UUID"];

}

- (NSUInteger)objectContentLength {

    NSString *objectContentLengthString = [[self responseHeaders] objectForKey:@"Content-Length"];

    if (objectContentLengthString)

        return [objectContentLengthString intValue];

    return 0;

}

- (NSString *)contentType {

	return [[self responseHeaders] objectForKey:@"Content-Type"];

}

- (NSDate *)lastModified {

    NSString *lastModifiedString = [[self responseHeaders] objectForKey:@"Last-Modified"];

    if (lastModifiedString)

        return [[self dateFormatterWithFormatId:1] dateFromString:lastModifiedString];

    return nil;

}

- (NSString *)contentEncoding {

	return [self decodeFromPercentEscape:[[self responseHeaders] objectForKey:@"Content-Encoding"]];

}

- (NSString *)contentDisposition {

	return [self decodeFromPercentEscape:[[self responseHeaders] objectForKey:@"Content-Disposition"]];

}

- (NSString *)version {

	return [[self responseHeaders] objectForKey:@"X-Object-Version"];

}

- (NSDate *)versionTimestamp {

    NSString *versionTimestampString = [[self responseHeaders] objectForKey:@"X-Object-Version-Timestamp"];

    if (versionTimestampString)

        return [[self dateFormatterWithFormatId:1] dateFromString:versionTimestampString];

    return nil;

}

- (NSString *)modifiedBy {

	return [[self responseHeaders] objectForKey:@"X-Object-Modified-By"];

}

- (NSString *)manifest {

	return [self decodeFromPercentEscape:[[self responseHeaders] objectForKey:@"X-Object-Manifest"]];

}

- (NSString *)sharing {

	return [self decodeFromPercentEscape:[[self responseHeaders] objectForKey:@"X-Object-Sharing"]];

}

- (NSString *)sharedBy {

	return [self decodeFromPercentEscape:[[self responseHeaders] objectForKey:@"X-Object-Shared-By"]];

}

- (NSString *)publicURI {

	return [[self responseHeaders] objectForKey:@"X-Object-Public"];

}

- (NSDictionary *)metadata {

    if (metadata == nil) {

        metadata = [self getHeadersDictionaryForPrefix:@"X-Object-Meta-"];

        [metadata retain];

    }

    return metadata;

}

- (NSString *)allowedTo {

    return [[self responseHeaders] objectForKey:@"X-Object-Allowed-To"];

}

- (ASIPithosObject *)object {

    ASIPithosObject *object = [ASIPithosObject object];

    object.name = objectName;

    object.hash = [self eTag];

    object.objectHash = [self objectHash];

    object.UUID = [self UUID];

    object.contentType = [self contentType];

    object.contentEncoding = [self contentEncoding];

    object.contentDisposition = [self contentDisposition];

    object.lastModified = [self lastModified];

    object.version = [self version];

    object.versionTimestamp = [self versionTimestamp];

    object.modifiedBy = [self modifiedBy];

    object.manifest = [self manifest];

    object.sharing = [self sharing];

    object.sharedBy = [self sharedBy];

    object.publicURI = [self publicURI];

    object.metadata = (NSMutableDictionary *)[self metadata];

    object.allowedTo = [self allowedTo];

    if (objectRequestType == ASIPithosObjectRequestData) {

        object.bytes = [self objectContentLength];

        object.data = [self responseData];

    } else if (objectRequestType == ASIPithosObjectRequestHashmap) {

        object.bytes = [self bytes];

    }

    return object;

}

#pragma mark -

#pragma mark GET

// GET storageURL/container/object

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName {

    return [self storageRequestWithMethod:@"GET" pithos:pithos containerName:containerName objectName:objectName];

}

// GET storageURL/container/object?[version=version]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version {

    NSString *queryString = nil;

    if (version)

        queryString = [NSString stringWithFormat:@"?version=%@", version];

	return [self storageRequestWithMethod:@"GET" pithos:pithos containerName:containerName objectName:objectName queryString:queryString];

}

// GET storageURL/container/object?[version=version] [If-Match]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                          ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfMatchHeader:matchETag];

    return request;

}

// GET storageURL/container/object?[version=version] [If-None-Match]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                      ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;

}

// GET storageURL/container/object?[version=version] [If-Modified-Since]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                  ifModifiedSince:(NSDate *)sinceTimestamp {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfModifiedSinceHeader:sinceTimestamp];

    return request;

}

// GET storageURL/container/object?[version=version] [If-Unmodified-Since]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                ifUnmodifiedSince:(NSDate *)sinceTimestamp {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfUnmodifiedSinceHeader:sinceTimestamp];

    return request;

}

// GET storageURL/container/object?[version=version] [Range [If-Range]]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                            range:(NSString *)rangeString {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestRangeHeader:rangeString];

    return request;

}

// GET storageURL/container/object?[version=version] [Range [If-Range]]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                            range:(NSString *)rangeString 

                      ifRangeETag:(NSString *)rangeETag {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestRangeHeader:rangeString ifRangeETag:rangeETag];

    return request;

}

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                            range:(NSString *)rangeString 

                 ifRangeTimestamp:(NSDate *)rangeTimestamp {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestRangeHeader:rangeString ifRangeTimestamp:rangeTimestamp];

    return request;

}

// GET storageURL/container/object?[version=version] [Range] [If-Match]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                            range:(NSString *)rangeString 

                          ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestRangeHeader:rangeString];

    [request addRequestIfMatchHeader:matchETag];

    return request;    

}

// GET storageURL/container/object?[version=version] [Range] [If-None-Match]

+ (id)objectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          version:(NSString *)version 

                            range:(NSString *)rangeString 

                      ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectDataRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestRangeHeader:rangeString];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;

}

- (NSData *)data {

    return [self responseData];

}

// GET storageURL/container/object?format=xml&hashmap=

+ (id)objectHashmapRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName {

    ASIPithosObjectRequest *request = [self storageRequestWithMethod:@"GET" pithos:pithos containerName:containerName objectName:objectName queryString:@"?format=xml&hashmap="];

    request.objectRequestType = ASIPithosObjectRequestHashmap;

    return request;

}

// GET storageURL/container/object?format=xml&hashmap=[&version=version]

+ (id)objectHashmapRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                             version:(NSString *)version {

    NSString *queryString = @"?format=xml&hashmap=";

    if (version)

        queryString = [queryString stringByAppendingString:[NSString stringWithFormat:@"&version=%@", version]];

	ASIPithosObjectRequest *request = [self storageRequestWithMethod:@"GET" pithos:pithos containerName:containerName objectName:objectName queryString:queryString];

    request.objectRequestType = ASIPithosObjectRequestHashmap;

    return request;

}

// GET storageURL/container/object?format=xml&hashmap=[&version=version] [If-Match]

+ (id)objectHashmapRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                             version:(NSString *)version 

                             ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectHashmapRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfMatchHeader:matchETag];

    return request;

}

// GET storageURL/container/object?format=xml&hashmap=[&version=version] [If-NoneMatch]

+ (id)objectHashmapRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                             version:(NSString *)version 

                         ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectHashmapRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;

}

// GET storageURL/container/object?format=xml&hashmap=[&version=version] [If-Modified-Since]

+ (id)objectHashmapRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                             version:(NSString *)version 

                     ifModifiedSince:(NSDate *)sinceTimestamp {

    ASIPithosObjectRequest *request = [self objectHashmapRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfModifiedSinceHeader:sinceTimestamp];

    return request;

}

// GET storageURL/container/object?format=xml&hashmap=[&version=version] [If-Unmodified-Since]

+ (id)objectHashmapRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                             version:(NSString *)version 

                   ifUnmodifiedSince:(NSDate *)sinceTimestamp {

    ASIPithosObjectRequest *request = [self objectHashmapRequestWithPithos:pithos containerName:containerName objectName:objectName version:version];

    [request addRequestIfUnmodifiedSinceHeader:sinceTimestamp];

    return request;

}

- (NSUInteger)blockSize {

    if (hashes == nil)

        [self parseXMLData];

    return blockSize;

}

- (NSString *)blockHash {

    if (hashes == nil)

        [self parseXMLData];

    return blockHash;

}

- (NSArray *)hashes {

    if (hashes == nil)

        [self parseXMLData];

    return hashes;

}

- (NSUInteger)bytes {

    if (hashes == nil)

        [self parseXMLData];

    return bytes;

}

// GET storageURL/container/object?format=xml&version=list

+ (id)objectVersionsRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName {

    ASIPithosObjectRequest *request = [self storageRequestWithMethod:@"GET" pithos:pithos containerName:containerName objectName:objectName queryString:@"?format=xml&version=list"];

    request.objectRequestType = ASIPithosObjectRequestVersions;

    return request;

}

// GET storageURL/container/object?format=xml&version=list [If-Match]

+ (id)objectVersionsRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                              ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectVersionsRequestWithPithos:pithos containerName:containerName objectName:objectName];

    [request addRequestIfMatchHeader:matchETag];

    return request;

}

// GET storageURL/container/object?format=xml&version=list [If-None-Match]

+ (id)objectVersionsRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self objectVersionsRequestWithPithos:pithos containerName:containerName objectName:objectName];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;

}

// GET storageURL/container/object?format=xml&version=list [If-Modified-Since]

+ (id)objectVersionsRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                      ifModifiedSince:(NSDate *)sinceTimestamp {

    ASIPithosObjectRequest *request = [self objectVersionsRequestWithPithos:pithos containerName:containerName objectName:objectName];

    [request addRequestIfModifiedSinceHeader:sinceTimestamp];

    return request;

}

// GET storageURL/container/object?format=xml&version=list [If-Unmodified-Since]

+ (id)objectVersionsRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                    ifUnmodifiedSince:(NSDate *)sinceTimestamp {

    ASIPithosObjectRequest *request = [self objectVersionsRequestWithPithos:pithos containerName:containerName objectName:objectName];

    [request addRequestIfUnmodifiedSinceHeader:sinceTimestamp];

    return request;

}

- (NSArray *)versions {

    if (versions == nil)

        [self parseXMLData];

    return versions;

}

#pragma mark -

#pragma mark PUT, COPY, MOVE

// PUT storageURL/container/object (from ASIPithosObject with data)

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName object:(ASIPithosObject *)object {

    NSUInteger isPublic = ASIPithosObjectRequestPublicIgnore;

    if (object.publicURI) {

        isPublic = ASIPithosObjectRequestPublicTrue;

        if ([object.publicURI isEqualToString:@""])

            isPublic = ASIPithosObjectRequestPublicFalse;

    }

    return [self writeObjectDataRequestWithPithos:pithos containerName:containerName 

                                              objectName:object.name 

                                                    eTag:object.hash 

                                             contentType:object.contentType 

                                         contentEncoding:object.contentEncoding 

                                      contentDisposition:object.contentDisposition 

                                                manifest:object.manifest 

                                                 sharing:object.sharing 

                                                isPublic:isPublic

                                                metadata:object.metadata 

                                                    data:object.data];

}

// PUT storageURL/container/object (from ASIPithosObject with data) [If-Match]

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName object:(ASIPithosObject *)object 

                               ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self writeObjectDataRequestWithPithos:pithos containerName:containerName object:object];

    [request addRequestIfMatchHeader:matchETag];

    return request;

}

// PUT storageURL/container/object (from ASIPithosObject with data) [If-None-Match]

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName object:(ASIPithosObject *)object 

                           ifNoneMatch:(NSString *)matchETag  {

    ASIPithosObjectRequest *request = [self writeObjectDataRequestWithPithos:pithos containerName:containerName object:object];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;

}

// PUT storageURL/container/object (from NSData)

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                                  eTag:(NSString *)eTag 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                                  data:(NSData *)data {

	ASIPithosObjectRequest *request = [self storageRequestWithMethod:@"PUT" pithos:pithos containerName:containerName objectName:objectName];

    [request prepareObjectRequestWithETag:eTag 

                              contentType:contentType 

                          contentEncoding:contentEncoding 

                       contentDisposition:contentDisposition 

                                 manifest:manifest 

                                  sharing:sharing 

                                 isPublic:isPublic 

                                 metadata:metadata];

	[request appendPostData:data];

    request.requestMethod = @"PUT";

	return request;

}

// PUT storageURL/container/object (from NSData) [If-Match]

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                                  eTag:(NSString *)eTag 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                                  data:(NSData *)data 

                               ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self writeObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                               eTag:eTag 

                                                                        contentType:contentType 

                                                                    contentEncoding:contentEncoding 

                                                                 contentDisposition:contentDisposition 

                                                                           manifest:manifest 

                                                                            sharing:sharing 

                                                                           isPublic:isPublic 

                                                                           metadata:metadata 

                                                                               data:data];

    [request addRequestIfMatchHeader:matchETag];

    return request;                                                                          

}

// PUT storageURL/container/object (from NSData) [If-None-Match]

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                                  eTag:(NSString *)eTag 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                                  data:(NSData *)data 

                           ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self writeObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                               eTag:eTag 

                                                                        contentType:contentType 

                                                                    contentEncoding:contentEncoding 

                                                                 contentDisposition:contentDisposition 

                                                                           manifest:manifest 

                                                                            sharing:sharing 

                                                                           isPublic:isPublic 

                                                                           metadata:metadata 

                                                                               data:data];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;                                                                          

}

// PUT storageURL/container/object (from file)

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                                  eTag:(NSString *)eTag 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                                  file:(NSString *)filePath {

	ASIPithosObjectRequest *request = [self storageRequestWithMethod:@"PUT" pithos:pithos containerName:containerName objectName:objectName];

    [request prepareObjectRequestWithETag:eTag 

                              contentType:contentType 

                          contentEncoding:contentEncoding 

                       contentDisposition:contentDisposition 

                                 manifest:manifest 

                                  sharing:sharing 

                                 isPublic:isPublic 

                                 metadata:metadata];

	request.shouldStreamPostDataFromDisk = YES;

    request.postBodyFilePath = filePath;

    request.requestMethod = @"PUT";

	return request;    

}

// PUT storageURL/container/object (from file) [If-Match]

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                                  eTag:(NSString *)eTag 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                                  file:(NSString *)filePath 

                               ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self writeObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                               eTag:eTag 

                                                                        contentType:contentType 

                                                                    contentEncoding:contentEncoding 

                                                                 contentDisposition:contentDisposition 

                                                                           manifest:manifest 

                                                                            sharing:sharing 

                                                                           isPublic:isPublic 

                                                                           metadata:metadata 

                                                                               file:filePath];

    [request addRequestIfMatchHeader:matchETag];

    return request;                                                                          

}

// PUT storageURL/container/object (from file) [If-None-Match]

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                                  eTag:(NSString *)eTag 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                                  file:(NSString *)filePath 

                           ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self writeObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                               eTag:eTag 

                                                                        contentType:contentType 

                                                                    contentEncoding:contentEncoding 

                                                                 contentDisposition:contentDisposition 

                                                                           manifest:manifest 

                                                                            sharing:sharing 

                                                                           isPublic:isPublic 

                                                                           metadata:metadata 

                                                                               file:filePath];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;                                                                          

}

// PUT storageURL/container/object (from hashes)

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                             blockSize:(NSUInteger)blockSize 

                             blockHash:(NSString *)blockHash 

                                hashes:(NSArray *)hashes 

                                 bytes:(NSUInteger)bytes {

	ASIPithosObjectRequest *request = [self storageRequestWithMethod:@"PUT" pithos:pithos containerName:containerName objectName:objectName queryString:@"?format=xml&hashmap="];

    [request prepareObjectRequestWithETag:nil 

                              contentType:contentType 

                          contentEncoding:contentEncoding 

                       contentDisposition:contentDisposition 

                                 manifest:manifest 

                                  sharing:sharing 

                                 isPublic:isPublic 

                                 metadata:metadata];

    NSString *dataString = [NSString stringWithFormat:@"<?xml version=\"1.0\" encoding=\"UTF-8\"?><object name=\"%@\" bytes=\"%lu\" block_size=\"%lu\" block_hash=\"%@\">", 

                            [(NSString *)CFXMLCreateStringByEscapingEntities(NULL, (CFStringRef)objectName , NULL) autorelease], 

                            bytes, blockSize, blockHash];

    for (NSString *hash in hashes) {

        dataString = [dataString stringByAppendingFormat:@"<hash>%@</hash>", hash];

    }

    dataString = [dataString stringByAppendingString:@"</object>"];

	[request appendPostData:[dataString dataUsingEncoding:NSUTF8StringEncoding]];

    request.requestMethod = @"PUT";

    request.objectRequestType = ASIPithosObjectRequestHashmapWrite;

	return request;

}

// PUT storageURL/container/object (from hashes) [If-Match]

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                             blockSize:(NSUInteger)blockSize 

                             blockHash:(NSString *)blockHash 

                                hashes:(NSArray *)hashes 

                                 bytes:(NSUInteger)bytes 

                               ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self writeObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                        contentType:contentType 

                                                                    contentEncoding:contentEncoding 

                                                                 contentDisposition:contentDisposition 

                                                                           manifest:manifest 

                                                                            sharing:sharing 

                                                                           isPublic:isPublic 

                                                                           metadata:metadata 

                                                                          blockSize:blockSize 

                                                                          blockHash:blockHash 

                                                                             hashes:hashes 

                                                                              bytes:bytes];

    [request addRequestIfMatchHeader:matchETag];

    return request;                                                                          

}

// PUT storageURL/container/object (from hashes) [If-None-Match]

+ (id)writeObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                           contentType:(NSString *)contentType 

                       contentEncoding:(NSString *)contentEncoding 

                    contentDisposition:(NSString *)contentDisposition 

                              manifest:(NSString *)manifest 

                               sharing:(NSString *)sharing 

                              isPublic:(NSUInteger)isPublic 

                              metadata:(NSDictionary *)metadata 

                             blockSize:(NSUInteger)blockSize 

                             blockHash:(NSString *)blockHash 

                                hashes:(NSArray *)hashes 

                                 bytes:(NSUInteger)bytes 

                           ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self writeObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                        contentType:contentType 

                                                                    contentEncoding:contentEncoding 

                                                                 contentDisposition:contentDisposition 

                                                                           manifest:manifest 

                                                                            sharing:sharing 

                                                                           isPublic:isPublic 

                                                                           metadata:metadata 

                                                                          blockSize:blockSize 

                                                                          blockHash:blockHash 

                                                                             hashes:hashes 

                                                                              bytes:bytes];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;                                                                          

}

// PUT storageURL/container/object (copy from source)

+ (id)copyObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          contentType:(NSString *)contentType 

                      contentEncoding:(NSString *)contentEncoding 

                   contentDisposition:(NSString *)contentDisposition 

                             manifest:(NSString *)manifest 

                              sharing:(NSString *)sharing 

                             isPublic:(NSUInteger)isPublic 

                             metadata:(NSDictionary *)metadata 

                  sourceContainerName:(NSString *)sourceContainerName 

                     sourceObjectName:(NSString *)sourceObjectName

                        sourceAccount:(NSString *)sourceAccount

                        sourceVersion:(NSString *)sourceVersion {

	ASIPithosObjectRequest *request = [self storageRequestWithMethod:@"PUT" pithos:pithos containerName:containerName objectName:objectName];

    [request prepareObjectRequestWithETag:nil 

                              contentType:contentType 

                          contentEncoding:contentEncoding 

                       contentDisposition:contentDisposition 

                                 manifest:manifest 

                                  sharing:sharing 

                                 isPublic:isPublic 

                                 metadata:metadata];

    [request addRequestHeader:@"Content-Length" value:@"0"];

    [request addRequestHeader:@"X-Copy-From" 

                        value:[self encodeToPercentEscape:[NSString stringWithFormat:@"/%@/%@", sourceContainerName, sourceObjectName]]];

    if (sourceAccount)

        [request addRequestHeader:@"X-Source-Account" 

                            value:[self encodeToPercentEscape:sourceAccount]];

    if (sourceVersion)

        [request addRequestHeader:@"X-Source-Version" value:sourceVersion];

    return request;

}

// PUT storageURL/container/object (copy from source) [If-Match]

+ (id)copyObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          contentType:(NSString *)contentType 

                      contentEncoding:(NSString *)contentEncoding 

                   contentDisposition:(NSString *)contentDisposition 

                             manifest:(NSString *)manifest 

                              sharing:(NSString *)sharing 

                             isPublic:(NSUInteger)isPublic 

                             metadata:(NSDictionary *)metadata 

                  sourceContainerName:(NSString *)sourceContainerName 

                     sourceObjectName:(NSString *)sourceObjectName

                        sourceAccount:(NSString *)sourceAccount

                        sourceVersion:(NSString *)sourceVersion 

                              ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self copyObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                       contentType:contentType 

                                                                   contentEncoding:contentEncoding 

                                                                contentDisposition:contentDisposition 

                                                                          manifest:manifest 

                                                                           sharing:sharing 

                                                                          isPublic:isPublic 

                                                                          metadata:metadata 

                                                               sourceContainerName:sourceContainerName 

                                                                  sourceObjectName:sourceObjectName 

                                                                     sourceAccount:sourceAccount

                                                                     sourceVersion:sourceVersion];

    [request addRequestIfMatchHeader:matchETag];

    return request;                                                                          

}

// PUT storageURL/container/object (copy from source) [If-None-Match]

+ (id)copyObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          contentType:(NSString *)contentType 

                      contentEncoding:(NSString *)contentEncoding 

                   contentDisposition:(NSString *)contentDisposition 

                             manifest:(NSString *)manifest 

                              sharing:(NSString *)sharing 

                             isPublic:(NSUInteger)isPublic 

                             metadata:(NSDictionary *)metadata 

                  sourceContainerName:(NSString *)sourceContainerName 

                     sourceObjectName:(NSString *)sourceObjectName

                        sourceAccount:(NSString *)sourceAccount

                        sourceVersion:(NSString *)sourceVersion 

                          ifNoneMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self copyObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                       contentType:contentType 

                                                                   contentEncoding:contentEncoding 

                                                                contentDisposition:contentDisposition 

                                                                          manifest:manifest 

                                                                           sharing:sharing 

                                                                          isPublic:isPublic 

                                                                          metadata:metadata 

                                                               sourceContainerName:sourceContainerName 

                                                                  sourceObjectName:sourceObjectName 

                                                                     sourceAccount:sourceAccount

                                                                     sourceVersion:sourceVersion];

    [request addRequestIfNoneMatchHeader:matchETag];

    return request;                                                                          

}

// COPY storageURL/container/object (copy to destination)

+ (id)copyObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          contentType:(NSString *)contentType 

                      contentEncoding:(NSString *)contentEncoding 

                   contentDisposition:(NSString *)contentDisposition 

                             manifest:(NSString *)manifest 

                              sharing:(NSString *)sharing 

                             isPublic:(NSUInteger)isPublic 

                             metadata:(NSDictionary *)metadata 

             destinationContainerName:(NSString *)destinationContainerName 

                destinationObjectName:(NSString *)destinationObjectName

                   destinationAccount:(NSString *)destinationAccount

                        sourceVersion:(NSString *)sourceVersion {

    NSString *queryString = nil;

    if (!contentType)

        queryString = @"?ignore_content_type=";

	ASIPithosObjectRequest *request = [self storageRequestWithMethod:@"COPY" pithos:pithos containerName:containerName objectName:objectName queryString:queryString];

    [request prepareObjectRequestWithETag:nil 

                              contentType:contentType 

                          contentEncoding:contentEncoding 

                       contentDisposition:contentDisposition 

                                 manifest:manifest 

                                  sharing:sharing 

                                 isPublic:isPublic 

                                 metadata:metadata];

    [request addRequestHeader:@"Destination" 

                        value:[self encodeToPercentEscape:[NSString stringWithFormat:@"/%@/%@", destinationContainerName, destinationObjectName]]];

    if (destinationAccount)

        [request addRequestHeader:@"Destination-Account" 

                            value:[self encodeToPercentEscape:destinationAccount]];

    if (sourceVersion)

        [request addRequestHeader:@"X-Source-Version" value:sourceVersion];

    return request;

}

// COPY storageURL/container/object (copy to destination) [If-Match]

+ (id)copyObjectDataRequestWithPithos:(ASIPithos *)pithos containerName:(NSString *)containerName objectName:(NSString *)objectName 

                          contentType:(NSString *)contentType 

                      contentEncoding:(NSString *)contentEncoding 

                   contentDisposition:(NSString *)contentDisposition 

                             manifest:(NSString *)manifest 

                              sharing:(NSString *)sharing 

                             isPublic:(NSUInteger)isPublic 

                             metadata:(NSDictionary *)metadata 

             destinationContainerName:(NSString *)destinationContainerName 

                destinationObjectName:(NSString *)destinationObjectName

                   destinationAccount:(NSString *)destinationAccount

                        sourceVersion:(NSString *)sourceVersion 

                              ifMatch:(NSString *)matchETag {

    ASIPithosObjectRequest *request = [self copyObjectDataRequestWithPithos:pithos containerName:containerName objectName:objectName 

                                                                       contentType:contentType 

                                                                   contentEncoding:contentEncoding 

                                                                contentDisposition:contentDisposition 

                                                                          manifest:manifest 

                                                                           sharing:sharing 

                                                                          isPublic:isPublic 

                                                                          metadata:metadata 

                                                          destinationContainerName:destinationContainerName 

                                                             destinationObjectName:destinationObjectName 

                                                                destinationAccount:destinationAccount

                                                                     sourceVersion:sourceVersion];

    [request addRequestIfMatchHeader:matchETag];