Merge branch 'develop'

Author: BB9z

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2014-2016, 2018-2020 RFUI.
+Copyright (c) 2014-2016, 2018-2021 RFUI.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

RFAPI.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'RFAPI'
-  s.version          = '2.0.0'
+  s.version          = '2.1.0'
   s.summary          = 'RFAPI is a network request library specially designed for API requests. It is a URL session wrapper base on AFNetworking.'
 
   s.homepage         = 'https://github.com/RFUI/RFAPI'

Sources/RFAPI/RFAPI.h

@@ -1,7 +1,7 @@
 /*
  RFAPI
 
- Copyright © 2014-2016, 2018-2020 BB9z
+ Copyright © 2014-2016, 2018-2021 BB9z
  https://github.com/RFUI/RFAPI
  
  The MIT License (MIT)
@@ -230,6 +230,9 @@ FOUNDATION_EXTERN NSErrorDomain __nonnull const RFAPIErrorDomain;
 /// Customization URL request object
 @property (nullable) NSMutableURLRequest *__nonnull (^requestCustomization)(NSMutableURLRequest *__nonnull request);
 
+/// Allow transform resesoinse object in the processing queue. The return value will become the final responseObject.
+@property (nullable) id __nullable (^responseObjectTransformer)(RFAPIDefine *__nonnull define, id __nullable responseObject);
+
 /// Identifier for request. If `nil`, the api name will be used.
 @property (nullable) NSString *identifier;
 
@@ -279,6 +282,9 @@ FOUNDATION_EXTERN NSErrorDomain __nonnull const RFAPIErrorDomain;
 /// This may be used to test whether the UI is in a proper state when network latency.
 @property NSTimeInterval debugDelayRequestSend;
 
+/// If no nil, simulate the request fail with the given error code.
+@property NSInteger debugRequestFailWithCode;
+
 /// This value will be passed to the task object.
 @property (nullable) NSDictionary *userInfo;
 

Sources/RFAPI/RFAPI.m

@@ -194,6 +194,13 @@ - (void)cancelOperationsWithGroupIdentifier:(nullable NSString *)identifier {
             [self.networkActivityIndicatorManager showMessage:message];
         });
     }
+
+    if (context.debugRequestFailWithCode != 0) {
+        NSError *error = [NSError errorWithDomain:RFAPIErrorDomain code:context.debugRequestFailWithCode userInfo:@{ NSLocalizedDescriptionKey: [NSString.alloc initWithFormat:@"Debug error, code: %@", @(context.debugRequestFailWithCode)] }];
+        [self _RFAPI_executeTaskCallback:task failure:error];
+        return task;
+    }
+
     dispatch_block_t work = ^{
         if (task.isEnd) return;
         [dataTask resume];
@@ -218,6 +225,7 @@ - (void)transferContext:(RFAPIRequestConext *)context toTask:(_RFAPISessionTask
     task.failure = context.failure;
     task.complation = context.finished;
     task.combinedComplation = context.combinedComplation;
+    task.responseObjectTransformer = context.responseObjectTransformer;
     task.debugDelayRequestSend = context.debugDelayRequestSend;
     task.userInfo = context.userInfo;
 }
@@ -362,6 +370,9 @@ - (void)_RFAPI_handleTaskComplete:(_RFAPISessionTask *)task response:(NSURLRespo
                     [self _RFAPI_executeTaskCallback:task failure:error];
                 }
                 else {
+                    if (task.responseObjectTransformer) {
+                        modelObject = task.responseObjectTransformer(task.define, modelObject);
+                    }
                     [self _RFAPI_executeTaskCallback:task success:modelObject];
                 }
                 return;

Sources/RFAPI/URLSession/RFAPISessionTask.h

@@ -2,7 +2,7 @@
 RFAPISessionTask
 RFAPI
 
-Copyright © 2019-2020 BB9z
+Copyright © 2019-2021 BB9z
 https://github.com/RFUI/RFAPI
 
 The MIT License (MIT)
@@ -47,6 +47,8 @@ typedef void(^RFAPITaskComplation)(id __nullable responseObject, NSURLResponse *
 @property (nullable) NSDictionary *userInfo;
 @property NSTimeInterval debugDelayRequestSend;
 
+@property (nullable) id __nullable (^responseObjectTransformer)(RFAPIDefine *__nonnull define, id __nullable responseObject);
+
 #pragma mark - States
 
 @property (readonly, copy, nullable, nonatomic) NSURLRequest *currentRequest;