目前公司的Swift项目网络请求使用的是第三方开源库Alamofire，在使用的过程中有遇到过2种参数格式无法正确传递到后端的情况；
1）参数包含空数组
直接会被过滤删除掉
2）参数包含二维数组
会把二维数组转换为一维数组
下面将结合Alamofire参数编码部分的源码来一步一步的分析为啥不满足这2种参数格式。
1、首先看下实际结果
这里有必要先说下测试接口使用 httpbin.org来进行测试的好处；因为它在被调用后可以返回服务端所接收到的所有参数；在我们这里仅仅调试参数，所以比使用抓包工具要更方便一些，可以直接查看print的结果。
1）发起一个网络请求
// GET请求
AF.request("http://httpbin.org/get", method: .get, parameters: ["name": "kang", "score": 90, "nulllArr": [], "twoDArr": [["1","2"],["3","4"]]]).responseJSON { (response) in
switch response.result {
case .success(let value):
print(value)
case .failure(let error):
print(error)
}
}
输出结果：
{
args = {
name = kang;
score = 90;
"twoDArr[][]" = (
1,
2,
3,
4
);
};
headers = {
Accept = "*/*";
"Accept-Encoding" = "br;q=1.0, gzip;q=0.9, deflate;q=0.8";
"Accept-Language" = "en;q=1.0";
Host = "httpbin.org";
"User-Agent" = "Test/1.0 ( build:1; iOS 14.0.0) Alamofire/5.2.2";
"X-Amzn-Trace-Id" = "Root=1-5f8d57cd-039301d94fe8ad1d6311287c";
};
origin = "";
url = "http://httpbin.org/get?name=kang&score=90&twoDArr[][]=1&twoDArr[][]=2&twoDArr[][]=3&twoDArr[][]=4";
}
// POST请求
AF.request("http://httpbin.org/post", method: .post, parameters: ["name": "kang", "score": 90, "nulllArr": [], "twoDArr": [["1","2"],["3","4"]]]).responseJSON { (response) in
switch response.result {
case .success(let value):
print(value)
case .failure(let error):
print(error)
}
}
输出结果：
{
args = {
};
data = "";
files = {
};
form = {
name = kang;
score = 90;
"twoDArr[][]" = (
1,
2,
3,
4
);
};
headers = {
Accept = "*/*";
"Accept-Encoding" = "br;q=1.0, gzip;q=0.9, deflate;q=0.8";
"Accept-Language" = "en;q=1.0";
"Content-Length" = 106;
"Content-Type" = "application/x-www-form-urlencoded; charset=utf-8";
Host = "httpbin.org";
"User-Agent" = "Test/1.0 (; build:1; iOS 14.0.0) Alamofire/5.2.2";
"X-Amzn-Trace-Id" = "Root=1-5f8e5cd1-5aa70b642cee70930c0eedd7";
};
json = "<null>";
origin = "";
url = "https://httpbin.org/post";
}
可以看到无论是GET还是POST，空数组被过滤掉了，以及二维数组变成了一维数组
2）通过抓包工具Charles验证
// GET请求抓包
image-20201019172543187.png
// POST请求抓包
image-20201019173944744.png
可以看到请求的参数以及接口返回的参数和上面print的结果是一样的：空数组nullArr不见了，二维数组twoDArr被转换成了一维数组。这和我们定义参数格式初衷不一样了，需要和后台的同事重新沟通定义参数格式。
2、源码调试分析
宿主工程目前是通过Pod管理第三方依赖库，并且Xcode12已经支持在同一个workspace下不同project之间进行断点调试。
前面的func调用不用看，我们直接看参数处理的部分：
ParameterEncoding.swift -> URLEncoding
// MARK: Encoding
public func encode(_ urlRequest: URLRequestConvertible, with parameters: Parameters?) throws -> URLRequest {
var urlRequest = try urlRequest.asURLRequest()
guard let parameters = parameters else { return urlRequest }
// 根据请求方法不同判断处理参数是放在url后面还是body
if let method = urlRequest.method, destination.encodesParametersInURL(for: method) {
guard let url = urlRequest.url else {
throw AFError.parameterEncodingFailed(reason: .missingURL)
}
if var urlComponents = URLComponents(url: url, resolvingAgainstBaseURL: false), !parameters.isEmpty {
let percentEncodedQuery = (urlComponents.percentEncodedQuery.map { $0 + "&" } ?? "") + query(parameters)
urlComponents.percentEncodedQuery = percentEncodedQuery
urlRequest.url = urlComponents.url
}
} else {
if urlRequest.value(forHTTPHeaderField: "Content-Type") == nil {
urlRequest.setValue("application/x-www-form-urlencoded; charset=utf-8", forHTTPHeaderField: "Content-Type")
}
urlRequest.httpBody = Data(query(parameters).utf8)
}
return urlRequest
}
从上面源码可以看到，无论哪种请求方式都有调用到 query(parameters) 处理参数
处理参数的核心代码就是以下3个方法
private func query(_ parameters: [String: Any]) -> String {
// 创建一个数组，参数类型是2个字符串的元组类型，用于分别存储key、value
var components: [(String, String)] = []
// 将参数key按照字母正序的方式排序，然后遍历每个key
for key in parameters.keys.sorted(by: <) {
let value = parameters[key]!
// 根据value类型具体处理参数
components += queryComponents(fromKey: key, value: value)
}
// 按照key1=value1&key2=value2的格式拼接返回参数字符串
return components.map { "\($0)=\($1)" }.joined(separator: "&")
}
// 递归遍历参数的每一层，将其展开为一维
public func queryComponents(fromKey key: String, value: Any) -> [(String, String)] {
// 创建一个数组，参数类型是2个字符串的元组类型，用于分别存储key、value
var components: [(String, String)] = []
// 根据参数字典中的value类型是字典、数组、整型、布尔分别处理
switch value {
case let dictionary as [String: Any]:
for (nestedKey, value) in dictionary {
components += queryComponents(fromKey: "\(key)[\(nestedKey)]", value: value)
}
case let array as [Any]:
for value in array {
components += queryComponents(fromKey: arrayEncoding.encode(key: key), value: value)
}
case let number as NSNumber:
if number.isBool {
components.append((escape(key), escape(boolEncoding.encode(value: number.boolValue))))
} else {
components.append((escape(key), escape("\(number)")))
}
case let bool as Bool:
components.append((escape(key), escape(boolEncoding.encode(value: bool))))
default:
components.append((escape(key), escape("\(value)")))
}
return components
}
// 对特殊字符进行URL编码
public func escape(_ string: String) -> String {
string.addingPercentEncoding(withAllowedCharacters: .afURLQueryAllowed) ?? string
}
1）对于我们测试参数，空数组"nulllArr": []
由于是一个空数组，里面没有任何参数，所以在方法queryComponents遍历后就直接返回一个空数组var components: [(String, String)] = [] 给 components += queryComponents(fromKey: key, value: value)，而这里数组的拼接必须是有元素才可以的，空数组是不会加过去的。
这里我们可以看看数组Array定义的 += 方法：
@frozen public struct Array<Element> {
@inlinable public static func += (lhs: inout [Element], rhs: [Element])
}
在 https://swift.org/ 查看Swift源码stdlib--public--core--Array.swift可以看到
extension Array {
@inlinable
public static func += (lhs: inout Array, rhs: Array) {
lhs.append(contentsOf: rhs)
}
}
@inlinable
@_semantics("array.append_element")
public mutating func append(_ newElement: __owned Element) {
_makeUniqueAndReserveCapacityIfNotUnique()
let oldCount = _getCount()
_reserveCapacityAssumingUniqueBuffer(oldCount: oldCount)
_appendElementAssumeUniqueAndCapacity(oldCount, newElement: newElement)
}
当rhs右边的数组有元素的时候数组buffer缓存才会加；这里说得有点偏了，如果感兴趣可以去仔细看看这个方法的具体实现。
2）对于二维数组："twoDArr": [["1","2"],["3","4"]]]
由于是二维，所以在执行方法queryComponents的时候会递归调用，将里面的元素全部展开变成了一维数组，"twoDArr [] [] ": ["1","2","3","4"]，对于key后面有2个中括号，这个是可以通过Alamofire下面代码进行控制的，默认情况下是带中括号的
public init(destination: Destination = .methodDependent,
arrayEncoding: ArrayEncoding = .brackets,
boolEncoding: BoolEncoding = .numeric) {
self.destination = destination
self.arrayEncoding = arrayEncoding
self.boolEncoding = boolEncoding
}
public enum ArrayEncoding {
case brackets
case noBrackets
func encode(key: String) -> String {
switch self {
case .brackets:
return "\(key)[]"
case .noBrackets:
return key
}
}
}
由于我们这里是二维数组，所以方法queryComponents递归调用了2次，所以有2个中括号，也间接说明参数是一个二维数组参数。
总结
从实际参数请求结果到一步一步分析第三方库源码，我们找到了导致这个结果的具体原因。Alamofire参数处理有字典、数组、整型、布尔等，在本文中只是对空数组、二维数组进行了验证，其它类型原理是一样的，可以得出使用Alamofire发起网络请求：
1）参数中如果有空字典、空数组都会被过滤掉；
2）如果有字典、数组嵌套的情况，都会被一层层展开成一维；
3）参数key是按照字母正序进行排序的，如果某些接口对参数的顺序也有要求可以在key之前加入正序的字母。
在github上面，Alamofire/issues也有人遇到过类似本文参数的问题，参考官方评论使用Encodable类型而不用 Parameters 字典，经过验证还是存在这种参数格式问题，具体可以参看源码ParameterEncoder.swift去进行调试。
网友评论