Inherits from NSObject
Declared in RKTestHelpers.h

Overview

The RKTestHelpers class provides a number of helpful utility methods for use in unit or integration tests for RestKit applications.

Tasks

Stubbing Routes

Working with the Cache

  • + disableCaching

    Disables caching by setting a new [NSURLCache sharedURLCache] instance in which the memory and disk limits have been set to zero.

  • + cacheResponseForRequest:withResponseData:

    Creates, stores, and returns a NSCachedURLResponse object containing an NSHTTPURLResponse for the given request with a 200 (OK) status code.

  • + cacheResponseForURL:HTTPMethod:headers:withData:

    Creates, stores, and returns a NSCachedURLResponse object containing an NSHTTPURLResponse for the given URL and HTTP method with the given response data and a 200 (OK) status code.

Class Methods

cacheResponseForRequest:withResponseData:

Creates, stores, and returns a NSCachedURLResponse object containing an NSHTTPURLResponse for the given request with a 200 (OK) status code.

+ (NSCachedURLResponse *)cacheResponseForRequest:(NSURLRequest *)request withResponseData:(NSData *)responseData

Parameters

request

The request to cache the response for.

responseData

The response data to be stored in the cache.

Return Value

The cached URL response that was stored to the cache.

Declared In

RKTestHelpers.h

cacheResponseForURL:HTTPMethod:headers:withData:

Creates, stores, and returns a NSCachedURLResponse object containing an NSHTTPURLResponse for the given URL and HTTP method with the given response data and a 200 (OK) status code.

+ (NSCachedURLResponse *)cacheResponseForURL:(NSURL *)URL HTTPMethod:(NSString *)HTTPMethod headers:(NSDictionary *)requestHeaders withData:(NSData *)responseData

Parameters

URL

The URL to cache the response for.

HTTPMethod

The HTTP method of the request (i.e. ‘GET’, ‘POST’, ‘PUT’, ‘PATCH’, or ‘DELETE’).

responseData

The response data to be stored in the cache.

Return Value

The cached URL response that was stored to the cache.

Declared In

RKTestHelpers.h

copyFetchRequestBlocksMatchingPathPattern:toBlocksMatchingRelativeString:onObjectManager:

Finds all registered fetch request blocks matching the given path pattern and adds a new fetch request block that returns the same value as the origin block that matches the given relative string portion of a URL object.

+ (void)copyFetchRequestBlocksMatchingPathPattern:(NSString *)pathPattern toBlocksMatchingRelativeString:(NSString *)relativeString onObjectManager:(RKObjectManager *)nilOrObjectManager

Parameters

pathPattern

The path pattern that matches the fetch request blocks to be copied.

relativeString

The relative string portion of the NSURL objects that the new blocks will match exactly.

nilOrObjectManager

The object manager to stub the route on. If nil, the shared object manager be be used.

Declared In

RKTestHelpers.h

disableCaching

Disables caching by setting a new [NSURLCache sharedURLCache] instance in which the memory and disk limits have been set to zero.

+ (void)disableCaching

Declared In

RKTestHelpers.h

stubRouteForClass:method:withPathPattern:onObjectManager:

Stubs the route with the given class and method with a given path pattern.

+ (RKRoute *)stubRouteForClass:(Class)objectClass method:(RKRequestMethod)method withPathPattern:(NSString *)pathPattern onObjectManager:(RKObjectManager *)nilOrObjectManager

Parameters

objectClass

The class of the route to stub.

method

The method of the route to stub.

pathPattern

The path pattern to return instead in place of the current route’s value.

nilOrObjectManager

The object manager to stub the route on. If nil, the shared object manager be be used.

Return Value

The new stubbed route object that was added to the route set of the target object manager.

Declared In

RKTestHelpers.h

stubRouteForRelationship:ofClass:pathPattern:onObjectManager:

Stubs the relationship route for a given class with a given path pattern.

+ (RKRoute *)stubRouteForRelationship:(NSString *)relationshipName ofClass:(Class)objectClass pathPattern:(NSString *)pathPattern onObjectManager:(RKObjectManager *)nilOrObjectManager

Parameters

relationshipName

The name of the relationship to stub the route of.

objectClass

The class of the route to stub.

pathPattern

The path pattern to return instead in place of the current route’s value.

nilOrObjectManager

The object manager to stub the route on. If nil, the shared object manager be be used.

Return Value

The new stubbed route object that was added to the route set of the target object manager.

Declared In

RKTestHelpers.h

stubRouteNamed:withPathPattern:onObjectManager:

Stubs the route with the given name with a given path pattern.

+ (RKRoute *)stubRouteNamed:(NSString *)routeName withPathPattern:(NSString *)pathPattern onObjectManager:(RKObjectManager *)nilOrObjectManager

Parameters

routeName

The name of the route to stub.

pathPattern

The path pattern to return instead in place of the current route’s value.

nilOrObjectManager

The object manager to stub the route on. If nil, the shared object manager be be used.

Return Value

The new stubbed route object that was added to the route set of the target object manager.

Declared In

RKTestHelpers.h