URLSessionによる通信

Swiftのネットワーク通信において、URLSession は標準的かつ強力なAPIであり、HTTPやHTTPSなどのプロトコルを使用してサーバーとの通信を行う際に利用されます。以下では、URLSessionの基本的な使い方、構造、デリゲートの活用、非同期通信、エラーハンドリングなどについて詳しく説明します。

---

1. URLSessionの概要

URLSessionはAppleが提供するクラスで、次のようなタスクを管理します：

• HTTP/HTTPS通信

• ファイルのアップロードおよびダウンロード

• バックグラウンド通信

• キャッシュやクッキーの管理

---

2. 通信の基本的な流れ

URLSessionによる通信の基本的なステップは以下の通りです：

1. URLの作成

2. URLRequestの作成（必要に応じて）

3. URLSessionのインスタンス作成

4. URLSessionDataTaskの作成

5. タスクのresume()呼び出し

---

3. シンプルなGET通信の例

swift
import Foundation

if let url = URL(string: "https://api.example.com/data") {
    let task = URLSession.shared.dataTask(with: url) { data, response, error in
        if let error = error {
            print("通信エラー: \(error.localizedDescription)")
            return
        }

        if let httpResponse = response as? HTTPURLResponse {
            print("ステータスコード: \(httpResponse.statusCode)")
        }

        if let data = data {
            do {
                let json = try JSONSerialization.jsonObject(with: data)
                print("取得データ: \(json)")
            } catch {
                print("JSON解析エラー: \(error)")
            }
        }
    }
    task.resume()
}

---

4. POST通信の例（リクエストボディ付き）

swift
var request = URLRequest(url: URL(string: "https://api.example.com/post")!)
request.httpMethod = "POST"
request.addValue("application/json", forHTTPHeaderField: "Content-Type")

let requestBody: [String: Any] = ["name": "Taro", "age": 20]
request.httpBody = try? JSONSerialization.data(withJSONObject: requestBody)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("通信エラー: \(error.localizedDescription)")
        return
    }

    if let data = data {
        // レスポンスデータの処理
    }
}
task.resume()

---

5. URLSessionの構成要素

---

6. 非同期処理とasync/await

Swift 5.5以降、非同期通信をより簡潔に書けるようになりました。

swift
func fetchData() async {
    guard let url = URL(string: "https://api.example.com/data") else { return }

    do {
        let (data, _) = try await URLSession.shared.data(from: url)
        let json = try JSONSerialization.jsonObject(with: data)
        print("取得データ: \(json)")
    } catch {
        print("エラー: \(error)")
    }
}

---

7. URLSessionの構成とカスタマイズ

デフォルト以外の設定が必要な場合、URLSessionConfigurationを使ってカスタムセッションを作成できます。

swift
let config = URLSessionConfiguration.default
config.timeoutIntervalForRequest = 30
config.httpAdditionalHeaders = ["Authorization": "Bearer token"]

let session = URLSession(configuration: config)

---

8. デリゲートを使った通信管理

より細かい制御（進捗表示や認証対応など）を行うには、URLSessionDelegateなどのプロトコルを使って管理できます。

swift
class MyDelegate: NSObject, URLSessionDelegate, URLSessionDataDelegate {
    // 必要に応じてメソッドを実装
}

---

9. エラーハンドリングの注意点

• 通信失敗（ネットワークエラー）

• ステータスコードの確認（例: 404, 500）

• レスポンスのデコードエラー

• タイムアウトや無効なURLの検出

---

まとめ

URLSessionはSwiftにおける基本的なネットワーク通信の手段であり、GET/POSTのリクエスト送信、JSONの取得と解析、非同期処理、バックグラウンド通信、デリゲートによるカスタム処理まで幅広く対応しています。簡易的な利用から高度な制御まで柔軟に対応できるため、ネットワーク通信を行う上で中心的な役割を担うクラスです。