-Today's Learning Content-

• JSON
• API
• Swift Network

---

📌 1. 네트워크 기본 개념

개념 정리

Swift에서 네트워크 통신은 앱과 서버 간 데이터를 주고받는 작업을 의미한다. 주로 URLSession을 사용해 HTTP 요청을 보내고, 서버로부터 응답을 받아 JSON 데이터를 처리하거나 이미지, 파일 등을 다운로드하는 방식으로 구현된다.

1) JSON은 누구?

JSONJavaScript Object Notation)은 데이터를 표현하기 위한 경량의 데이터 포맷이다. 대부분의 서버와 클라이언트 간의 데이터 교환에서 사용된다.

• 특징:

  • 사람이 읽고 쓰기 쉽다.
  • 컴퓨터가 쉽게 파싱하고 생성할 수 있다.
  • 주로 Key-Value 의 쌍으로 이루어진다.

• JSON 예시:

{
  "name": "John",
  "age": 25,
}

2) API란

APIApplication Programming Interface)는 응용 프로그램이 서로 소통할 수 있도록 돕는 중간 매개체다. 일반적으로 서버와 클라이언트 간의 데이터를 주고받기 위해 사용된다.

실생활 예시

• 음식 주문 앱에서 가게의 정보를 가져올 때 서버에 요청을 보내고 응답을 받는다. 이 과정이 API를 통해 이루어진다.
• 인터넷에서 광고를 클릭하거나 검색을 통해 특정 웹사이트로 이동하는 것도 웹 API의 일종이다.

3) Swift Codable

Codable은 Swift에서 JSON 데이터를 구조체 또는 클래스와 쉽게 변환할 수 있게 해주는 프로토콜이다.

사용법 예시

struct User: Codable {
    let name: String
    let age: Int
}

// JSON 데이터를 Swift 객체로 디코딩  
if let jsonData = jsonString.data(using: .utf8) {
    let user = try? JSONDecoder().decode(User.self, from: jsonData)
}

4) URL 구조

URL(Uniform Resource Locator)은 웹 상에서 자원을 찾기 위한 주소다.

<URL 예시: https://api.example.com/users?name=John>

- 프로토콜: https  
- 도메인: api.example.com  
- 경로: /users  
- 쿼리 파라미터: "name=John"

5) REST API

REST API는 HTTP 프로토콜을 기반으로 자원을 CRUD(Create, Read, Update, Delete) 방식으로 처리할 때 사용하는 아키텍처다.

<주요 메소드>

- GET: 데이터 조회  
- POST: 데이터 생성  
- PUT: 데이터 수정  
- DELETE: 데이터 삭제  

---

📌 2. URL Session

개념 정리

Swift에서 URLSession은 네트워크 데이터를 전송하고 받기 위한 API로, HTTP 요청을 통해 서버와 통신할 때 사용된다. 비동기 작업을 지원하며, 데이터 요청, 파일 다운로드 및 업로드와 같은 다양한 작업을 처리할 수 있다.

1) URLSession이란?

URLSession은 네트워크 데이터를 전송하고 받기 위한 클래스다. 비동기적으로 작업을 처리하여 사용자 경험(UX)을 개선한다.

2) URLSession Configuration

URLSession을 설정할 때 다양한 Configuration을 사용할 수 있다.

Configuration 타입

• default: 기본 설정으로 일반적인 네트워킹에 사용
• ephemeral: 캐시와 쿠키를 저장하지 않는 임시 세션
• background: 앱이 백그라운드에서도 다운로드 작업을 계속하도록 함

// Configuration 사용 예시
let config = URLSessionConfiguration.default
let session = URLSession(configuration: config)

3) URLSession Task

URLSession은 세 가지 주요 작업(Task)을 제공한다.

1. dataTask: 간단한 데이터 요청에 사용
2. downloadTask: 파일 다운로드 시 사용
3. uploadTask: 파일 업로드 시 사용

// URLSession 사용 예시
let url = URL(string: "https://api.example.com/data")!
let task = URLSession.shared.dataTask(with: url) { data, response, error in
    if let data = data {
        // 데이터 처리
    }
}
task.resume() // 필수 키워드

여기서 resume() 메소드는 Task를 실행할 때 만드시 사용해 주어야 하는 메소드이다.

🚀 왜 URLSessionTask에서 resume()을 반드시 호출해야 할까?

1️⃣ resume()의 역할

• URLSessionTask(예: dataTask, downloadTask, uploadTask)는 비동기 네트워킹 작업을 위한 객체다. 그러나, 네트워크 요청이 생성된 직후에는 멈춘 상태로 준비만 되어 있을 뿐, 자동으로 실행되지 않는다.

• resume() 메소드는 네트워크 작업을 시작시키는 트리거다. 이 메소드를 호출해야만 네트워크 요청이 서버로 보내지고, 결과를 받아오는 작업이 실행된다.
  

2️⃣ resume()가 필요한 이유

비동기 처리를 위해 준비 상태

• URLSession은 요청을 바로 실행하지 않고 대기 상태로 만든다.
• resume()을 호출하기 전까지는 작업 큐에만 등록된 상태로, 아무런 네트워크 통신도 일어나지 않는다.
  

명확한 작업 관리

• 네트워크 작업의 실행을 명확하게 제어할 수 있다.
• 언제 네트워크 작업을 시작할지 결정할 수 있다.

3️⃣ resume() 호출 예시

let url = URL(string: "https://api.example.com/data")!
let task = URLSession.shared.dataTask(with: url) { data, response, error in
    if let data = data {
        print("Data received: \(data)")
    }
}
// 작업을 시작하려면 반드시 resume() 호출 필요
task.resume()

4️⃣ resume()을 호출하지 않으면?

• 네트워크 요청이 실행되지 않는다.
• 서버와의 통신이 이루어지지 않고, 콜백 클로저도 호출되지 않는다.
• 메모리 누수 또는 작업 누락의 원인이 될 수 있다.

5️⃣ suspend()와의 관계

• resume() 외에도, 네트워크 작업을 일시 중지하려면 suspend()를 사용할 수 있다.
• resume()과 suspend()를 번갈아 호출하여 작업을 제어할 수 있다.

task.suspend()  // 작업 일시 중지
task.resume()   // 일시 중지 후 재개

즉, resume()은 URLSessionTask의 작업 실행을 시작하는 중요한 메소드다. 이 메소드를 호출하지 않으면 네트워크 작업이 대기 상태로만 남아, 요청과 응답 처리가 전혀 이루어지지 않는다.
따라서 URLSession 작업을 사용할 때 반드시 resume()을 호출해 네트워킹 작업을 실행하도록 해야 한다.

4) URLRequest

URLRequest는 HTTP 요청을 생성할 때 사용된다. 요청 메소드, 헤더, 바디 등을 설정할 수 있다.

• HTTP 메소드 설정:

var request = URLRequest(url: url)
request.httpMethod = "POST"  // HTTP 메소드 설정

• HTTP 헤더 추가:

request.addValue("application/json", forHTTPHeaderField: "Content-Type")

• URLQueryItem:
  GET 요청에서 쿼리 파라미터를 추가할 때 사용된다.

var components = URLComponents(string: "https://api.example.com/search")
components?.queryItems = [
    URLQueryItem(name: "query", value: "Swift"),
    URLQueryItem(name: "page", value: "1")
]

if let url = components?.url {
    print(url)  // https://api.example.com/search?query=Swift&page=1
}

---

-Today's Lesson Review-

오늘은 JSON 파일 형식의 인코딩, 디코딩에 대해 학습하고,
API란 무엇인지, Swift에서 네트워킹 통신은 어떻게 하는지에 대해 공부했다.
아직은 모두 어렵고 낯선 개념들이라 반복적인 연습과 많은 공부가 필요할 것 같다.