Swift 개발 - HTTP 통신

iOS 개발 시 HTTP 통신하는 방법을 알아보겠습니다.

 

먼저 URL 을 생성하는 방법을 알아보겠습니다.

// 일반적인 URL 생성
let url = URL(string: "https://itunes.apple.com/search?media=music&entity=song&term=IU")

// 기본 URL 이 있고 경우에 따라 다른 URL 을 뒤에 붙이는 경우
let baseUrl = URL(string: "https://itunes.apple.com")
let requestUrl = URL(string: "/search?media=music&entity=song&term=IU", relativeTo: baseUrl)!

// QueryParameter 를 좀 더 안정적으로 분리해서 구현하려면 URLComponent 와 URLQueryItem 을 사용
var urlComponent = URLComponents(string: "https://itunes.apple.com/search?")!
let mediaQuery = URLQueryItem(name: "media", value: "music")
let entityQuery = URLQueryItem(name: "entity", value: "song")
let termQuery = URLQueryItem(name: "term", value: "IU")
urlComponent.queryItems?.append(mediaQuery)
urlComponent.queryItems?.append(entityQuery)
urlComponent.queryItems?.append(termQuery)

 

위와 같이 다양한 방법으로 생성한 URL 로 HTTP 통신을 하기 위해서는 URLSession 을 이용합니다. URLSession 은 URLSessionConfiguration 을 통해 생성이 되고 이 URLSession 은 URLTask 를 통해 실제 서버 통신을 하게 됩니다.

 

코드로 살펴보면 아래와 같습니다.

// 1. URL 생성
var urlComponent = URLComponents(string: "https://itunes.apple.com/search?")!
let mediaQuery = URLQueryItem(name: "media", value: "music")
let entityQuery = URLQueryItem(name: "entity", value: "song")
let termQuery = URLQueryItem(name: "term", value: "IU")
urlComponent.queryItems?.append(mediaQuery)
urlComponent.queryItems?.append(entityQuery)
urlComponent.queryItems?.append(termQuery)
let requestUrl = urlComponent.url!

// 2. URLSession 객체를 통해 전송 및 응답값 처리 로직 작성
let config = URLSessionConfiguration.default
let session = URLSession(configuration: config)

let dataTask = session.dataTask(with: requestUrl) { (data, response, error) in
	// 에러 처리
  	guard error == nil else { return }

  	guard let statusCode = (response as? HTTPURLResponse)?.statusCode else { return }
  	let successRange = 200 ..< 300

	// 응답 코드 에러 처리
  	guard successRange.contains(statusCode) else {
    	// handle response error
    	return
  	}

  	guard let data = data else { return }

  	// 후처리 (여기서는 응답 받은 데이터를 문자열 형태로 출력해보았습니다.)
  	let responseString = String(data: data, encoding: .utf8)
    	print("\(responseString ?? "empty response data")")
}

// 3. URLTask 실행
dataTask.resume()

 

URLSessionConfiguration 은 Default 외에도 Emphemeral(쿠키, 캐시를 저장하지 않는 정책을 시행할 때), Background(앱이 백그라운드에 있을 때 통신할 시)가 있습니다.

URLTask 도 기본적인 DataTask 외에도 UploadTask, DownloadTask 가 있습니다.

 

위와 같이 URLTask 에 URL 을 전달할 수도 있지만 HTTP 통신 시 Header 나 Body 에 값을 추가해야 하는 경우는 아래와 같이 URLRequest 를 만들어 전달할 수 있습니다.

// 1. 전송할 값 준비
let param = ["id": "test", "pwd": "1234"] // JSON 객체로 변환할 딕셔너리 준비
let paramData = try! JSONSerialization.data(withJSONObject: param, options: [])

// 2. URL 객체 정의
let url = URL(string: "https://~~~~");

// 3. URLRequest 객체 정의 및 요청 내용 담기
var request = URLRequest(url: url!)
request.httpMethod = "POST"
request.httpBody = paramData

// 4. HTTP 메시지에 포함될 헤더 설정
request.addValue("applicaion/json", forHTTPHeaderField: "Content-Type")
request.setValue(String(paramData.count), forHTTPHeaderField: "Content-Length")

// 5. URLSession 객체를 통해 전송 및 응답값 처리 로직 작성
let task = URLSession.shared.dataTask(with: request) {(data, response, error) in
    guard let data = data, error == nil else { 
    	// check for fundamental networking error
      	print("error=\(error)")
      	return
    }

    guard let statusCode = (response as? HTTPURLResponse)?.statusCode else { return }
        let successRange = 200 ..< 300

    guard successRange.contains(statusCode) else {
        // handle response error
        return
    }

    let responseString = String(data: data, encoding: .utf8)
    print("responseString = \(responseString)")

}

// 6. POST 전송
task.resume()