Add the ability to control cupertino_http caching policy (#763)

Author: brianquinlan

pkgs/cupertino_http/CHANGELOG.md

@@ -1,9 +1,13 @@
+## 0.0.4
+
+* Add the ability to control caching policy.
+
 ## 0.0.3
 
 * Follow the project style in the example app.
 * Use `runWithClient` in the example app.
 * Add another README example
-* 
+ 
 ## 0.0.2
 
 * A single comment adjustment.

pkgs/cupertino_http/example/integration_test/url_session_configuration_test.dart

@@ -54,6 +54,15 @@ void testProperties(URLSessionConfiguration config) {
       config.httpShouldUsePipelining = false;
       expect(config.httpShouldUsePipelining, false);
     });
+    test('requestCachePolicy', () {
+      config.requestCachePolicy = URLRequestCachePolicy.returnCacheDataDontLoad;
+      expect(config.requestCachePolicy,
+          URLRequestCachePolicy.returnCacheDataDontLoad);
+      config.requestCachePolicy =
+          URLRequestCachePolicy.reloadIgnoringLocalCacheData;
+      expect(config.requestCachePolicy,
+          URLRequestCachePolicy.reloadIgnoringLocalCacheData);
+    });
     test('sessionSendsLaunchEvents', () {
       config.sessionSendsLaunchEvents = true;
       expect(config.sessionSendsLaunchEvents, true);

pkgs/cupertino_http/lib/cupertino_http.dart

@@ -50,6 +50,18 @@ enum HTTPCookieAcceptPolicy {
   httpCookieAcceptPolicyOnlyFromMainDocumentDomain,
 }
 
+// Controls how response data is cached.
+//
+// See [URLRequestCachePolicy](https://developer.apple.com/documentation/foundation/nsurlrequestcachepolicy).
+enum URLRequestCachePolicy {
+  useProtocolCachePolicy,
+  reloadIgnoringLocalCacheData,
+  returnCacheDataElseLoad,
+  returnCacheDataDontLoad,
+  reloadIgnoringLocalAndRemoteCacheData,
+  reloadRevalidatingCacheData,
+}
+
 // Controls how [URLSessionTask] execute will proceed after the response is
 // received.
 //
@@ -190,6 +202,14 @@ class URLSessionConfiguration
   set httpShouldUsePipelining(bool value) =>
       _nsObject.HTTPShouldUsePipelining = value;
 
+  // Controls how to deal with response caching.
+  //
+  // See [NSURLSessionConfiguration.requestCachePolicy](https://developer.apple.com/documentation/foundation/nsurlsessionconfiguration/1411655-requestcachepolicy)
+  URLRequestCachePolicy get requestCachePolicy =>
+      URLRequestCachePolicy.values[_nsObject.requestCachePolicy];
+  set requestCachePolicy(URLRequestCachePolicy value) =>
+      _nsObject.requestCachePolicy = value.index;
+
   /// Whether the app should be resumed when background tasks complete.
   ///
   /// See [NSURLSessionConfiguration.sessionSendsLaunchEvents](https://developer.apple.com/documentation/foundation/nsurlsessionconfiguration/1617174-sessionsendslaunchevents)
@@ -234,6 +254,7 @@ class URLSessionConfiguration
       'httpCookieAcceptPolicy=$httpCookieAcceptPolicy '
       'httpShouldSetCookies=$httpShouldSetCookies '
       'httpShouldUsePipelining=$httpShouldUsePipelining '
+      'requestCachePolicy=$requestCachePolicy '
       'sessionSendsLaunchEvents=$sessionSendsLaunchEvents '
       'shouldUseExtendedBackgroundIdleMode='
       '$shouldUseExtendedBackgroundIdleMode '

pkgs/cupertino_http/pubspec.yaml

@@ -2,7 +2,7 @@ name: cupertino_http
 description: >
   A macOS/iOS Flutter plugin that provides access to the Foundation URL
   Loading System.
-version: 0.0.3
+version: 0.0.4
 repository: https://github.com/dart-lang/http/tree/master/pkgs/cupertino_http
 
 environment: