title: How to cache using NSURLSession and NSURLCache. Not working
body: <p>I have a test app setup and it successfully downloads content from the network even if the user switches apps while a download is in progress. Great, now I have background downloads in place. Now I want to add caching. There is no point to me downloading images more than once, b/c of system design, given an image URL I can tell you the content behind that URL will never change. So, now I want to cache the results of my download using apple's built in in-memory/on-disk cache that I've read so much about (as opposed to me saving the file manually in NSCachesDirectory and then checking there before making new request, ick). In an <em>attempt</em> to get caching working on top of this working code, I added the following code:</p>
  
  <pre><code>- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
  {
      // Override point for customization after application launch.
  
      // Set app-wide shared cache (first number is megabyte value)
      [NSURLCache setSharedURLCache:[[NSURLCache alloc] initWithMemoryCapacity:60 * 1024 * 1024
                                                                  diskCapacity:200 * 1024 * 1024
                                                                      diskPath:nil]];
  
      return YES;
  }
  </code></pre>
  
  <p>When I create my session, I've added two NEW lines (URLCache and requestCachePolicy).</p>
  
  <pre><code>// Helper method to get a single session object
  - (NSURLSession *)backgroundSession
  {
      static NSURLSession *session = nil;
      static dispatch_once_t onceToken;
      dispatch_once(&amp;onceToken, ^{
          NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration backgroundSessionConfiguration:@"com.example.apple-samplecode.SimpleBackgroundTransfer.BackgroundSession"];
          configuration.URLCache = [NSURLCache sharedURLCache]; // NEW LINE ON TOP OF OTHERWISE WORKING CODE
          configuration.requestCachePolicy = NSURLRequestReturnCacheDataElseLoad;  // NEW LINE ON TOP OF OTHERWISE WORKING CODE
          session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:nil];
      });
      return session;
  }
  </code></pre>
  
  <p>Then, just to be ultra redundant in an attempt to see caching success I switched my NSURLRequest line from</p>
  
  <pre><code>// NSURLRequest *request = [NSURLRequest requestWithURL:downloadURL]; // Old line, I've replaced this with...
  NSURLRequest *request = [NSURLRequest requestWithURL:downloadURL cachePolicy:NSURLRequestReturnCacheDataElseLoad timeoutInterval:2*60]; // New line
  </code></pre>
  
  <p>Now, when I go to download the item a 2nd time, the experience is exaclty like the first!! Takes a long time to download and progress bar is animated slow and steady like an original download. I want the data in the cache immediately!! What am I missing???</p>
  
  <p>----------------------------UPDATE----------------------------</p>
  
  <p>Okay, thanks to Thorsten's answer, I've added the following two lines of code to my <code>didFinishDownloadingToURL</code> delegate method:</p>
  
  <pre><code>- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)downloadURL {
  
      // Added these lines...
      NSLog(@"DiskCache: %@ of %@", @([[NSURLCache sharedURLCache] currentDiskUsage]), @([[NSURLCache sharedURLCache] diskCapacity]));
      NSLog(@"MemoryCache: %@ of %@", @([[NSURLCache sharedURLCache] currentMemoryUsage]), @([[NSURLCache sharedURLCache] memoryCapacity]));
      /*
      OUTPUTS:
      DiskCache: 4096 of 209715200
      MemoryCache: 0 of 62914560
      */
  }
  </code></pre>
  
  <p>This is great. It confirms the cache is growing. I presume since I'm using a downloadTask (downloads to file as opposed to memory), that that's why DiskCache is growing and not memory cache first? I figured everything would go to memory cache until that overflowed and then disk cache would be used and that maybe memory cache was written to disk before the OS kills the app in the background to free up memory. Am I misunderstanding how Apple's cache works?</p>
  
  <p>This is a step forward for sure, but the 2nd time I download the file <em>it takes just as long as the first time</em> (maybe 10 seconds or so) and the following method DOES get executed again:</p>
  
  <pre><code>- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
  {
      // This shouldn't execute the second time around should it? Even if this is supposed to get executed a second time around then shouldn't it be lightning fast? It's not.
      // On all subsequent requests, it slowly iterates through the downloading of the content just as slow as the first time. No caching is apparent. What am I missing?
  }
  </code></pre>
  
  <p>What do you make of my edits above? Why am I not seeing the file returned very quickly on subsequent requests?</p>
  
  <p>How can I confirm if the file is being served from the cache on the 2nd request?</p>