React Nativeのネットワーク通信の裏側
— NSURLSessionとOkHttpが実際にやっていること

// NSURLSession は3つの主要コンポーネントで構成される

// 1. Configuration — セッション全体の設定
NSURLSessionConfiguration *config =
    [NSURLSessionConfiguration defaultSessionConfiguration];
config.timeoutIntervalForRequest = 30;   // リクエストタイムアウト
config.timeoutIntervalForResource = 300;  // リソースタイムアウト
config.HTTPCookieStorage = [NSHTTPCookieStorage sharedHTTPCookieStorage];

// 2. Session — 通信の実行主体
NSURLSession *session =
    [NSURLSession sessionWithConfiguration:config];

// 3. Task — 個々のリクエスト
NSURLSessionDataTask *task =
    [session dataTaskWithURL:url
           completionHandler:^(NSData *data, NSURLResponse *resp, NSError *err) {
        // レスポンス処理
    }];
[task resume];

// HTTPCookieStorage はアプリ全体で共有されるシングルトン
NSHTTPCookieStorage *store =
    [NSHTTPCookieStorage sharedHTTPCookieStorage];

// Set-Cookie ヘッダーを受信すると自動的にここに保存される
// 次回のリクエストで自動的に Cookie ヘッダーに付与される

// 保存済み Cookie の確認
NSArray *cookies = [store cookiesForURL:url];

// Cookie の手動削除
for (NSHTTPCookie *cookie in store.cookies) {
    [store deleteCookie:cookie];
}

// Cookie の永続化ポリシー
store.cookieAcceptPolicy = NSHTTPCookieAcceptPolicyAlways;
// → アプリを再起動しても Cookie は保持される
// → expires/max-age に従って自動的に期限切れ処理される

# ATS が許可する通信の条件
- プロトコル: HTTPS 必須（HTTP は拒否）
- TLS バージョン: TLS 1.2 以上
- 暗号スイート: Forward Secrecy 対応のもの
- 証明書: SHA-256 以上のハッシュ、2048bit 以上の RSA キー

# ATS に違反した場合のエラー
Error Domain=NSURLErrorDomain Code=-1022
"The resource could not be loaded because the
 App Transport Security policy requires the use
 of a secure connection."

<!-- 開発時のみ: localhost への HTTP を許可 -->
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSExceptionDomains</key>
    <dict>
        <key>localhost</key>
        <dict>
            <key>NSExceptionAllowsInsecureHTTPLoads</key>
            <true/>
        </dict>
    </dict>
</dict>

<!-- 本番では絶対にやらないこと: 全 HTTP を許可 -->
<!-- <key>NSAllowsArbitraryLoads</key><true/> -->

// OkHttp の CookieJar はシンプルなインターフェース
public interface CookieJar {
    // リクエスト時: この URL に送るべき Cookie を返す
    List<Cookie> loadForRequest(HttpUrl url);

    // レスポンス時: サーバーから受け取った Cookie を保存する
    void saveFromResponse(HttpUrl url, List<Cookie> cookies);
}

// デフォルト実装: NO_COOKIES（何も保存しない）
CookieJar NO_COOKIES = new CookieJar() {
    public List<Cookie> loadForRequest(HttpUrl url) {
        return Collections.emptyList();
    }
    public void saveFromResponse(HttpUrl url, List<Cookie> cookies) {
        // 何もしない
    }
};

import { Platform } from 'react-native';

// プラットフォームのデフォルトタイムアウトに依存せず、
// 自前で統一的なタイムアウトを設定する
const TIMEOUT_MS = Platform.select({
  ios: 30000,      // iOS: デフォルト60秒より短く
  android: 30000,  // Android: デフォルト10秒より長く
  default: 30000,
});

async function apiFetch(url: string, options?: RequestInit) {
  const controller = new AbortController();
  const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);

  try {
    return await fetch(url, { ...options, signal: controller.signal });
  } finally {
    clearTimeout(timeoutId);
  }
}

// React Native の HTTP ハンドラーをカスタマイズする例
// ネイティブモジュールとして実装

#import <React/RCTHTTPRequestHandler.h>

@implementation RCTHTTPRequestHandler (CustomConfig)

- (NSURLSessionConfiguration *)customSessionConfiguration {
    NSURLSessionConfiguration *config =
        [NSURLSessionConfiguration defaultSessionConfiguration];

    // タイムアウトを統一
    config.timeoutIntervalForRequest = 30;

    // キャッシュポリシー
    config.requestCachePolicy = NSURLRequestReloadIgnoringLocalCacheData;

    // HTTP/2 の有効化（デフォルトで有効だが明示）
    config.HTTPShouldUsePipelining = YES;

    return config;
}

@end

// React Native の OkHttpClient をカスタマイズする例
public class CustomOkHttpFactory implements OkHttpClientFactory {
    public OkHttpClient createNewNetworkModuleClient() {
        return new OkHttpClient.Builder()
            // タイムアウトを統一
            .connectTimeout(30, TimeUnit.SECONDS)
            .readTimeout(30, TimeUnit.SECONDS)
            .writeTimeout(30, TimeUnit.SECONDS)

            // Cookie永続化
            .cookieJar(new PersistentCookieJar())

            // ログインターセプター（デバッグ用）
            .addInterceptor(new HttpLoggingInterceptor())

            // 証明書ピニング
            .certificatePinner(new CertificatePinner.Builder()
                .add("api.example.com", "sha256/AAAA...")
                .build())

            .build();
    }
}