ARConnection+Private.m

Go to the documentation of this file.

// ActiveResourceKit ARConnection+Private.m
//
// Copyright © 2012, Roy Ratcliffe, Pioneering Software, United Kingdom
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
//  The above copyright notice and this permission notice shall be included in
//  all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EITHER
// EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO
// EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
// OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
//
//------------------------------------------------------------------------------

#import "ARConnection+Private.h"

// for ARDimOf
#import "ARMacros.h"

// for ARHTTPGetMethod and friends
#import "ARHTTPMethods.h"

@implementation ARConnection(Private)

- (NSDictionary *)defaultHeaders
{
    return [NSDictionary dictionary];
}

- (NSDictionary *)buildRequestHeaderFieldsUsingHeaders:(NSDictionary *)headers forHTTPMethod:(NSString *)HTTPMethod
{
    NSMutableDictionary *headerFields = [NSMutableDictionary dictionaryWithDictionary:[self defaultHeaders]];
    [headerFields addEntriesFromDictionary:[self HTTPFormatHeaderForHTTPMethod:HTTPMethod]];
    if (headers)
    {
        [headerFields addEntriesFromDictionary:headers];
    }
    return [headerFields copy];
}

//------------------------------------------------------------------------------
#pragma mark                                            Format Header for Method
//------------------------------------------------------------------------------

- (NSDictionary *)HTTPFormatHeaderForHTTPMethod:(NSString *)HTTPMethod
{
    NSString *const HTTPMethods[] =
    {
        ARHTTPGetMethod,
        ARHTTPPutMethod,
        ARHTTPPostMethod,
        ARHTTPDeleteMethod,
        ARHTTPHeadMethod,
    };
    NSString *const headerNames[] =
    {
        @"Accept",
        @"Content-Type",
        @"Content-Type",
        @"Accept",
        @"Accept",
    };
    // Is this too ugly? A dictionary could implement the look-up. But that
    // requires building a static dictionary initially and does not allow
    // optimisation of searching. Using a simple linear look-up speeds up the
    // more common request types, i.e. GET requests. There is a cost, that of
    // slower look-up for less common types, e.g. HEAD. Is this a reasonable
    // trade-off?
    NSUInteger index;
    for (index = 0; index < ARDimOf(HTTPMethods); index++)
    {
        if ([HTTPMethod isEqualToString:HTTPMethods[index]])
        {
            break;
        }
    }
    NSDictionary *formatHeader;
    if (index < ARDimOf(HTTPMethods))
    {
        formatHeader = [NSDictionary dictionaryWithObject:[[self format] MIMEType] forKey:headerNames[index]];
    }
    else
    {
        formatHeader = [NSDictionary dictionary];
    }
    return formatHeader;
}

@end