🔥

Alamofire

부제

카테고리

네트워킹

세부 카테고리

서드파티

Combine 카테고리

최종편집일

2022/07/16 15:21

작성중

Using Alamofire

Introduction

Alamofire 는 HTTP 네트워크 요청을 위한 간편한 인터페이스를 제공합니다.

HTTP 기능을 따로 구현한 것이 아니라,

애플의 URL Loading Systerm 을 활용해 만들어진 라이브러리입니다.

Alamofire 의 핵심 시스템은 URLSession 과 URLSessionTask 로 부터 상속받은 서브클래스들입니다.

Alamofire 는 이러한 API 를 감싸서 더 쉽고 간편하게 다양한 기능의 HTTP 통신 기능을 사용할 수 있도록 돕습니다.

그럼에도 Alamofire 의 중심 동작이 어디로 부터 나오는지 알고 있어야합니다.

즉, 애플의 URL Loading System 에 대해 친숙해야합니다.

Alamofire 의 많은 네트워킹 기능들이 시스템의 용량에 의해 제한되기도 합니다.

추가적으로, Alamofire 의 네트워킹(URL Loading System) 은 비동기적으로 실행됩니다.

따라서 비동기 프로그래밍 개념에 대한 이해 또한 필요합니다.

Alamofire 의 이전 버전에서는 Alamofire.request() 라는 예시를 사용했습니다.

이 API 에서는 Alamofire prefix 가 필요한 것 처럼 나타내어져 있지만, 사실 없어도 괜찮습니다.

import Alamofire 를 한 모든 파일에서 글로벌하게 request 메서드를 사용할 수 있습니다.

 Alamofire 5 부터는 이 기능이 제거되었습니다.

대신 AF 키워드를 통해 글로벌하게 Session.default 를 참조하게 됩니다.

이를 통해 더이상 Session API 를 글로벌하게 복제할 필요가 없어졌으며 gloabal 네임 스페이스를 오염시키지 않으면서 같은 기능을 간편하게 제공할 수 있게 되었습니다.

유사하게 af 프로퍼티를 extension 해, Alamofire 의 기능과 다른 extension 의 기능들을 분리해둘 수 있습니다.

Making Requests

Alamofire 에서의 HTTP request 는 정말 간편합니다.

URL 을 String 으로 전달하는 것만으로 response 를 받아올 수 있습니다.

모든 예시는 import Alamofire 를 한 파일에서만 사용가능합니다.

AF.request("https://httpbin.org/get").response { response in
    debugPrint(response)
}
Swift
복사

request 메서드의 정의는 아래와 같습니다.

open func request<Parameters: Encodable>(_ convertible: URLConvertible,
                                         method: HTTPMethod = .get,
                                         parameters: Parameters? = nil,
                                         encoder: ParameterEncoder = URLEncodedFormParameterEncoder.default,
                                         headers: HTTPHeaders? = nil,
                                         interceptor: RequestInterceptor? = nil) -> DataRequest
Swift
복사

이 메서드는 DataRequest 를 생성합니다.

파라미터

•

convertible : 모든 URL 로 변환가능한 타입의 값을 전달 받습니다.

•

method : HTTP 메서드의 타입을 결정할수 있습니다

◦

예: GET, POST, PUT, DELETE,PATCH

•

parameters :

•

encoder : 어떤 형식으로 인코딩을 할것인지에 따른 인코더를 결정할 수 있습니다

◦

예 : JSON 인코더

•

headers:

•

interceptor:

이 API 의 두번쨰 버전은 더 간단합니다.

open func request(_ urlRequest: URLRequestConvertible, 
                  interceptor: RequestInterceptor? = nil) -> DataRequest
Swift
복사

모든 URL 로 변환가능한 타입(URLRequestConvertible 프로토콜을 준수하는 타입)의 값을 전달 받습니다.

메서드는 이 타입에 대한 DataRequest 를 생성합니다.

앞선 버전의 파라미터들은 모두 위 값안에 캡슐화 되어 있습니다.

HTTP Methods

HTTPMethod 타입은 HTTP 메서드들을 정의해놓았습니다,

public struct HTTPMethod: RawRepresentable, Equatable, Hashable {
    public static let connect = HTTPMethod(rawValue: "CONNECT")
    public static let delete = HTTPMethod(rawValue: "DELETE")
    public static let get = HTTPMethod(rawValue: "GET")
    public static let head = HTTPMethod(rawValue: "HEAD")
    public static let options = HTTPMethod(rawValue: "OPTIONS")
    public static let patch = HTTPMethod(rawValue: "PATCH")
    public static let post = HTTPMethod(rawValue: "POST")
    public static let put = HTTPMethod(rawValue: "PUT")
    public static let trace = HTTPMethod(rawValue: "TRACE")

    public let rawValue: String

    public init(rawValue: String) {
        self.rawValue = rawValue
    }
}
Swift
복사

AF.requset 에 다음과 같이 활용이 가능합니다

AF.request("https://httpbin.org/get")
AF.request("https://httpbin.org/post", method: .post)
AF.request("https://httpbin.org/put", method: .put)
AF.request("https://httpbin.org/delete", method: .delete)
Swift
복사

HTTP 메서드들은 다른 의미를 가지고 있기 때문에 서버가 기대하는 방식의 파라미터 인코딩이 필요합니다.

따라서 기억을 잘해두고 잘 써먹어야 겠죠?

예를들어, GET 요청에서는 body 데이터를 포함시킬 수 없습니다.

에러가 발생해요!

Alamofire 는 URLRequest 의 extension 또한 제공해요.

이 확장은 httpMethod 프로퍼티와 브릿징(호환) 됩니다!

public extension URLRequest {
    /// Returns the `httpMethod` as Alamofire's `HTTPMethod` type.
    var method: HTTPMethod? {
        get { return httpMethod.flatMap(HTTPMethod.init) }
        set { httpMethod = newValue?.rawValue }
    }
}
Swift
복사

만약 Alamofire 가 사용하고자 하는 HTTPMethod 를 제공하지 않는다면 custom value 를 추가하면 된답니다.

extension HTTPMethod {
    static let custom = HTTPMethod(rawValue: "CUSTOM")
}

AF.request("https://httpbin.org/headers", method: .custom)
Swift
복사

Setting Other URLRequest Properties

Alamofire 의 request 생성 메서드는 커스텀을 위한 흔한 파라미터를 제공하지만,

가끔은 불충분할 때가 있을 수 있죠.

파라미터들에 의해 생성된 URLRequest 는 RequestModifier 클로져를 사용함으로써 변경이 가능합니다.

예를 들어, URLRequest 의 timoutInterval 이 5초로 설정하고자 한다면 .

클로져 내부에서 request 를 수정하면 됩니다.

AF.request("https://httpbin.org/get", requestModifier: { $0.timeoutInterval = 5 }).response(...)
Swift
복사

RequestModifier 는 trailing closuer 구문으로도 사용이 가능합니다.

AF.request("https://httpbin.org/get") { urlRequest in
    urlRequest.timeoutInterval = 5
    urlRequest.allowsConstrainedNetworkAccess = false
}
.response(...)
Swift
복사

RequestModifier 는 URL 을 사용해서 만들어진 request 에만 적용이 가능합니다.

URLRequestConvertible 를 준수하는 값으로 부터 직접 생성된 값에는 적용이 불가능해요!

생성시에 request가 한번 수정되어야 하는 경우에 만 URLRequestConvertible 타입을 사용하는 것을 추천 드립니다

나중에 변경이 불가능하니까요! ㅎㅎ

Request Parameters and Parameter Encoders

Alamofire 는 Encodable 을 준수하는 타입을 요청에 대한 파라미터로 사용할 수 있습니다.

이렇게 전달된 파라미터들은 ParameterEncoder 프로토콜을 준수하는 타입에 전달됩니다.

그 후 URLRequest 에 추가 되어 네트워크로 보내지죠.

Alamofire에는 기본적으로 ParameterEcoder 을 준수하는 2가지 타입이 존재합니다.

•

JSONParameterEncoder

•

URLEncodedFormParameterEncoder

이 두 타입은 요새 핫한 대부분의 인코딩 서비스를 제공합니다

struct Login: Encodable {
    let email: String
    let password: String
}

let login = Login(email: "test@test.test", password: "testPassword")

AF.request("https://httpbin.org/post",
           method: .post,
           parameters: login,
           encoder: JSONParameterEncoder.default).response { response in
    debugPrint(response)
}
Swift
복사

URLEncodedFormParameterEncoder

URLEncodedFormParameterEncoder 는 URL 인코딩 된 string 에 값을 인코딩해 넣습니다.

URL 쿼리 문자열에 파라미터들을 끼워넣거나, HTTP body 에 넣습니다.

인코딩된 string 을 어누부분에 끼워넣을 것인지는 destination 을 설정하면 됩니다.

URLEncodedFormParameterEncoder.Destination 열거형은 3가지 case 를 가집니다.

•

.methodDependent : get, head, delete 요청을 나태내느 쿼리에 기반하여 어디에 넣을 지 판단합니다. 인코딩된 쿼리 string 을 HTTP body 또는 HTTP 메서드의 request 에 적용합니다.

•

.queryString : 인코딩된 string 은 URL request 의 쿼리에 추가합니다

•

.httpBody : 인코딩된 string 을 URLRequest 의 HTTP body 추가합니다.

The Content-Type HTTP header of an encoded request with HTTP body is set to application/x-www-form-urlencoded; charset=utf-8, if Content-Type is not already set.

Internally, URLEncodedFormParameterEncoder uses URLEncodedFormEncoder to perform the actual encoding from an Encodable type to a URL encoded form String. This encoder can be used to customize the encoding for various types, including Array using the ArrayEncoding, Bool using the BoolEncoding, Data using the DataEncoding, Date using the DateEncoding, coding keys using the KeyEncoding, and spaces using the SpaceEncoding.

아직 이부분은 정확하게 이해를 못하게 두어서 원문으로 두겠습니다! 강해져서 돌아올게요!

let parameters = ["foo": "bar"]

// All three of these calls are equivalent
AF.request("https://httpbin.org/get", parameters: parameters) // encoding defaults to `URLEncoding.default`
AF.request("https://httpbin.org/get", parameters: parameters, encoder: URLEncodedFormParameterEncoder.default)
AF.request("https://httpbin.org/get", parameters: parameters, encoder: URLEncodedFormParameterEncoder(destination: .methodDependent))

// https://httpbin.org/get?foo=bar
Swift
복사

위 세줄의 코드는 모두 같은 요청을 합니다!

let parameters: [String: [String]] = [
    "foo": ["bar"],
    "baz": ["a", "b"],
    "qux": ["x", "y", "z"]
]

// All three of these calls are equivalent
AF.request("https://httpbin.org/post", method: .post, parameters: parameters)
AF.request("https://httpbin.org/post", method: .post, parameters: parameters, encoder: URLEncodedFormParameterEncoder.default)
AF.request("https://httpbin.org/post", method: .post, parameters: parameters, encoder: URLEncodedFormParameterEncoder(destination: .httpBody))

// HTTP body: "qux[]=x&qux[]=y&qux[]=z&baz[]=a&baz[]=b&foo[]=bar"
Swift
복사

위 세줄의 post request 도 차만가지로 같은 요청을 보냅니다.

다만 이번엔 메서드가 post 이므로 post 방식에 맞게 HTTP body 에 파라미터가 인코딩되어 삽입된 모습이죠!

진짜 간편해보이네요,,, 왜 쓰는지 알겠다

Configuring the Sorting of Encoded Values

Swift 4.2 부터 Dictionary 는 앱 실행시마다 내부적으로 순서가 뒤바뀝니다(랜덤)

이 현상은 인코딩된 파라미터들의 순서가 뒤바뀔 수 있다는 점에서 중요합니다...

기본적으로 URLEncodedFormEncoder 는 인코딩된 키 밸류 쌍을 sorting 합니다.

이러한 과정은 Encodable 을 준수하는 타입의 결과물로 항상 일정하지만, 타입에 구현된 실제 인코딩 순서와는 맞지 않을 수 있습니다.

alphabetizeKeyValuePairs 를 false 로 설정해서 구현한 순서대로 인코딩 되도록 할 수 있/습니다.

Dictionary 의 순서가 랜덤하더라도 말이지요.

URLEncodedFormParameterEncoder 를 새로 만들어서 alphabetizeKeyValuePairs 를 명시해줄 수 잇습니다.

let encoder = URLEncodedFormParameterEncoder(encoder: URLEncodedFormEncoder(alphabetizeKeyValuePairs: false))
Java
복사

Configuring the Encoding of Array Parameters

JSONParameterEncoder

JSONParameterEncoder 는 Encodable 한 값들은 Swift 의 JSONEncoder 를 사용하여 인코딩합니다.

그렇게 인코딩된 결과는 URLRequest 의 httpBody 에 삽입됩니다.

인코딩된 request 의 HTTP header 필드중 Content-Type는 application/json 으로 설정해주어야합니다!!

AF.request(url, method: .get, parameters: nil, encoding: URLEncoding.default, headers: ["Content-Type" : "application/json", "Accept":"application/json"]) 
    
Java
복사

Configuring a Custom JSONEncoder

JSONParameterEncoder 의 동작을 커스터마이징할 수 있습니다.

원하는 대로 JSONEncoder의 인스턴스를 생성해서 JSONParameterEncoder 의 파라미터로 전달해주면 됩니다.

let encoder = JSONEncoder()
encoder.dateEncoding = .iso8601 // 커스텀 1 
encoder.keyEncodingStrategy = .convertToSnakeCase // 커스텀 2
let parameterEncoder = JSONParameterEncoder(encoder: encoder) // 인스턴스를 활용해 인스턴스 생성

AF.request(url, method: .get, parameters: nil, encoder: encoder, headers: ["Content-Type" : "application/json", "Accept":"application/json"]) 
Java
복사

let url = URL(string: "https://httpbin.org/get")!
var urlRequest = URLRequest(url: url)

let parameters = ["foo": "bar"]
let encodedURLRequest = try URLEncodedFormParameterEncoder.default.encode(parameters, 
                                                                          into: urlRequest)
Java
복사

ParameterEncoder API 는 Alamofire 밖에서도 사용이 가능합니다.

URLRequest 의 파라미터를 인코딩하는데 직접적으로 사용이 가능해요!

HTTP Headers

Alamofire 에는 HTTPHeaders 타입이 존재합니다.

이 타입은 HTTP 헤더의 name value 쌍을 순서 보존적이고, case-insensitive(?) 하게 나타냅니다.

HTTPHeader 타입들은 한쌍의 name value 페어를캡슐화할 뿐더러, 자주 사용되는 헤더들에 대해 static value 를 제공합니다!

커스텀 HTTPHeaders 를 Request 에 값으로 건네주면 됩니다. (편하죠?

let headers: HTTPHeaders = [
    "Authorization": "Basic VXNlcm5hbWU6UGFzc3dvcmQ=",
    "Accept": "application/json"
]

AF.request("https://httpbin.org/headers", headers: headers).responseDecodable(of: DecodableType.self) { response in
    debugPrint(response)
}
Swift
복사

HTTPHeaders 는 HTTPHeader 값들의 배열로 구성할 수 도 있습니다!

let headers: HTTPHeaders = [
    .authorization(username: "Username", password: "Password"),
    .accept("application/json")
]

AF.request("https://httpbin.org/headers", headers: headers).responseDecodable(of: DecodableType.self) { response in
    debugPrint(response)
}
Swift
복사

가독성이 좋아졌죠?

앱 내에서 바꾸지 않고 사용되는 HTTP 헤더들은 URLSessionConfiguration 에 설정해둠으로써 URLSession 에서 생성되는 모든 URLSessionTask 에 자동으로 적용할 수 있습니다!!

자세한정보는 Session Configurations 에서 확인하세요

Alamofire 의 Session 은 모든 Request 에 대해 기본 헤더값을 가집니다.

그 값들은 아래와 같습니다.

•

Accept-Encoding, which defaults to br;q=1.0, gzip;q=0.8, deflate;q=0.6, per RFC 7230 §4.2.3.

•

Accept-Language, which defaults to up to the top 6 preferred languages on the system, formatted like en;q=1.0, per RFC 7231 §5.3.5.

•

User-Agent, which contains versioning information about the current app. For example: iOS Example/1.0 (com.alamofire.iOS-Example; build:1; iOS 13.0.0) Alamofire/5.0.0, per RFC 7231 §5.5.3.

이러한 헤더값을 커스터마이징할 필요가 있다면 URLSessionConfiguration 을 생성해야합니다.

headers 프로퍼티는 업데이트 되어야하며, configuration 을 새 Session 인스턴스에 적용되어야합니다.

URLSessionConfiguration.af.default 을 사용해서 Alomfire 의 기본 헤더들을 유지하면서 새 구성을 커스터마이징하세요

Response Validation

기본적으로 Alamofire 는 response 의 컨텐츠와는 상관없이

reponse 핸들러 이전에 validate() 를 호출해서 에러를 발생시킬 수 있습니다.

허용불가능한 status code 또는 MIME type 을 걸러내는 데 이 메서드를 호출하세요

Automatic Validation

validate() API 는 자동으로

•

status code 가 200..<300 안에 해당하는지 확인하고,

•

response의 Content-Type 헤더의 값이 request 의 Accept  헤더 값과 일치하는지 확인합니다

AF.request("https://httpbin.org/get").validate().responseData { response in
    debugPrint(response)
}

//위 코드는 아래와 동일한 response 를 받아옵니다.

AF.request("https://httpbin.org/get")
    .validate(statusCode: 200..<300)
    .validate(contentType: ["application/json"])
    .responseData { response in
        switch response.result {
        case .success:
            print("Validation Successful")
        case let .failure(error):
            print(error)
        }
    }
Swift
복사

Response Handling

제일 중요하다고도 할 수 잇는 파트인 것 같네요.

Alamofire 에는 두가지 request 방식이 존재합니다.

•

DataRequest 

•

DownloadRequest

가 바로 그것인데요.

두 방식 모두 각자에 해당하는 response type을 가집니다

•

DataResponse<Success, Failure: Error>

•

DownloadResponse<Success, Failure: Error>

이 두가지 response 타입 둘다 동일한 두개의 제네릭으로 구성되어있습니다!

기본적으로 모든 response 값은 AFError 타입을 생성합니다.

Alamofire 는 더간단한

•

AFDataResponse<Success>

•

AFDownloadResponse<Success>

를 사용합니다

이 public API 내부에는 AFError 의 에러타입을 항상 보유합니다.

DataRequest 의 서브클래스인 UploadRequest 도 똑같이 DataResponse 타입을 사용합니다.

Alamofire 에서 만들어진 DataRequest 와 UploadRequest 의 DataResponse 를 다루는 데에는,responseDecodable 와 같은 response handler 를 체이닝하면 됩니다.

AF.request("https://httpbin.org/get").responseDecodable(of: DecodableType.self) { response in
    debugPrint(response)
}
Swift
복사

위 예시에서 responseDecodable 핸들러는 DataRequest 에 더해져 사용되고 잇습니다.

DataRequest 의 실행이 완료되면 핸들러가 실행됩니다.

핸들러로 전달된 클로져는 DataResponse<DecodableType, AFError> 의 값을 받아서

서버로 부터 응답이 올때까지 실행이 block 되는 것이 아닙니다!

이 클로져는 callback 에 추가되어 응답왔을 때, 실행됩니다.

request 의 결과는 response 클로져 내무에서만 사용이 가능합니다.

즉, 모든 response 데이터에 대한 가공은 이 클로져 내부에서 실행되어야합니다.

Alamofire 에는 5가지 다른 data response 핸들러들이 있습니다.

// Response Handler - Unserialized Response
func response(queue: DispatchQueue = .main, 
              completionHandler: @escaping (AFDataResponse<Data?>) -> Void) -> Self

// Response Serializer Handler - Serialize using the passed Serializer
func response<Serializer: DataResponseSerializerProtocol>(queue: DispatchQueue = .main,
                                                          responseSerializer: Serializer,
                                                          completionHandler: @escaping (AFDataResponse<Serializer.SerializedObject>) -> Void) -> Self

// Response Data Handler - Serialized into Data
func responseData(queue: DispatchQueue = .main,
                  dataPreprocessor: DataPreprocessor = DataResponseSerializer.defaultDataPreprocessor,
                  emptyResponseCodes: Set<Int> = DataResponseSerializer.defaultEmptyResponseCodes,
                  emptyRequestMethods: Set<HTTPMethod> = DataResponseSerializer.defaultEmptyRequestMethods,
                  completionHandler: @escaping (AFDataResponse<Data>) -> Void) -> Self

// Response String Handler - Serialized into String
func responseString(queue: DispatchQueue = .main,
                    dataPreprocessor: DataPreprocessor = StringResponseSerializer.defaultDataPreprocessor,
                    encoding: String.Encoding? = nil,
                    emptyResponseCodes: Set<Int> = StringResponseSerializer.defaultEmptyResponseCodes,
                    emptyRequestMethods: Set<HTTPMethod> = StringResponseSerializer.defaultEmptyRequestMethods,
                    completionHandler: @escaping (AFDataResponse<String>) -> Void) -> Self

// Response Decodable Handler - Serialized into Decodable Type
func responseDecodable<T: Decodable>(of type: T.Type = T.self,
                                     queue: DispatchQueue = .main,
                                     dataPreprocessor: DataPreprocessor = DecodableResponseSerializer<T>.defaultDataPreprocessor,
                                     decoder: DataDecoder = JSONDecoder(),
                                     emptyResponseCodes: Set<Int> = DecodableResponseSerializer<T>.defaultEmptyResponseCodes,
                                     emptyRequestMethods: Set<HTTPMethod> = DecodableResponseSerializer<T>.defaultEmptyRequestMethods,
                                     completionHandler: @escaping (AFDataResponse<T>) -> Void) -> Self
Swift
복사

Response Handler

response 핸들러는 어떠한 response 데이터도 평가하지 않습니다.

단순히 모든 정보를 URLSessionDelegate 로부터 직접 받아오기만 합니다.

AF.request("https://httpbin.org/get").response { response in
    debugPrint("Response: \(response)")
}
Swift
복사

Response 의 Result 타입의 장점을 활용하려면 다른 response seriailizer 를 사용하는 것이 좋습니다

Response Data Handler

responseData 핸들러는 DataResponseSeriailizer 를 사용해서 Data 를 추출하고 유효화 합니다.

만약 에러가 발생하지 않고 Data 가 반환되면, response 의 Result 값에는 .success 가 담겨있을 것입니다.

value 는 Data 타입으로 반환됩니다.

AF.request("https://httpbin.org/get").responseData { response in
    debugPrint("Response: \(response)")
}
Swift
복사

Response String Handler

responseString 핸들러는 StringResponseSerializer 를 사용해서 Data 를 추출하고 String 타입으로 변환 합니다.

만약 에러가 발생하지 않고 Data 가 String 으로 변환되면, response 의 Result 값에는 .success 가 담겨있을 것입니다.

value 는 String 타입으로 반환됩니다.

AF.request("https://httpbin.org/get").responseData { response in
    debugPrint("Response: \(response)")
}
Swift
복사

Response Decodable Handler

responseDecodable 핸들러는 DecodableResponseSerializer 를 사용해서 Data 를 추출하고 , 전달해준 Decodable 타입으로 변환합니다.

이 과정은 명시된 DataDecoder 에 의해 이루어집니다.

에러가 발생하지 않고 모든 서버 데이터가 Decodable 타입으로 디코딩 되면 response 의 Result 는 .success 값이 들어 있습니다.

또한 value 에는 전달된 타입으로 변환된 인스턴스가 존재합니다.

만약 에러가 발생하지 않고 Data 가 반환되면, response 의 Result 값에는 .success 가 담겨있을 것입니다.

struct DecodableType: Decodable { let url: String }

AF.request("https://httpbin.org/get").responseDecodable(of: DecodableType.self) { response in
    debugPrint("Response: \(response)")
}
Swift
복사

Chained Response Handlers

response 핸들러는 연달아 사용도 가능합니다.

Alamofire.request("https://httpbin.org/get")
    .responseString { response in
        print("Response String: \(response.value)")
    }
    .responseDecodable(of: DecodableType.self) { response in
        print("Response DecodableType: \(response.value)")
    }
Swift
복사

단 이경우 네트워크로 부터 데이터를 두번 요청합니다. 따라서 디버깅용도로만 사용하세요

Response Handler Queue

response 핸들러에 전달된 클로져는 .main 큐 에서 실행됩니다.

하지만 구체적인 DispatchQueue 를 명시해주어 이 큐에서 실행하도록 할 수 있습니다.

실질적인 serialization 작업(데이터 >> 다른 타입으로의 변환 )은 항상 백그라운드(rootQueue 또는 serializationQueue)에서 실행됩니다.

let utilityQueue = DispatchQueue.global(qos: .utility)

AF.request("https://httpbin.org/get").responseDecodable(of: DecodableType.self, queue: utilityQueue) { response in
    print("This closure is executed on utilityQueue.")
    debugPrint(response)
}
Swift
복사

Response Caching

Authentication

인증은 system framework 수준의 URLCredential 과 URLAuthenticationChallenge 에 의해서 이루어집니다.

HTTP Basic Authentication

Request 의 authenticate 메서드를 사용하면 자동으로 URLCredential 을 제공합니다.

let user = "user"
let password = "password"

AF.request("https://httpbin.org/basic-auth/\(user)/\(password)")
    .authenticate(username: user, password: password)
    .responseDecodable(of: DecodableType.self) { response in
        debugPrint(response)
    }
Swift
복사

Authentication with URLCredential

URLCredential 을 직접 선언하여 전달할 수 도 있습니다.

let user = "user"
let password = "password"

let credential = URLCredential(user: user, password: password, persistence: .forSession)

AF.request("https://httpbin.org/basic-auth/\(user)/\(password)")
    .authenticate(with: credential)
    .responseDecodable(of: DecodableType.self) { response in
        debugPrint(response)
    }
Swift
복사

Manual Authentication

항상 Authenticate 가 필요한 API 와 통신한다거나 유사한 헤더가 필요하다면, 수동으로 추가해줄 수 있습니다

let user = "user"
let password = "password"

let headers: HTTPHeaders = [.authorization(username: user, password: password)]

AF.request("https://httpbin.org/basic-auth/user/password", headers: headers)
    .responseDecodable(of: DecodableType.self) { response in
        debugPrint(response)
    }
Swift
복사

작성예정

Alamofire/Usage.md at master · Alamofire/Alamofire

https://github.com/Alamofire/Alamofire/blob/master/Documentation/Usage.md#downloading-data-to-a-file