中嶋悟
名前：中嶋 悟（なかじま さとる） ニックネーム：サトルン 年齢：28歳 性別：男性 職業：会社員（IT系メーカー・マーケティング部門） 通勤場所：東京都千代田区・本社オフィス 通勤時間：片道約45分（電車＋徒歩） 居住地：東京都杉並区・阿佐ヶ谷の1LDKマンション 出身地：神奈川県横浜市 身長：175cm 血液型：A型 誕生日：1997年5月12日 趣味：比較記事を書くこと、カメラ散歩、ガジェット収集、カフェ巡り、映画鑑賞（特に洋画）、料理（最近はスパイスカレー作りにハマり中） 性格：分析好き・好奇心旺盛・マイペース・几帳面だけど時々おおざっぱ・物事をとことん調べたくなるタイプ 1日（平日）のタイムスケジュール 6:30 起床。まずはコーヒーを淹れながらニュースとSNSチェック 7:00 朝食（自作のオートミールorトースト）、ブログの下書きや記事ネタ整理 8:00 出勤準備 8:30 電車で通勤（この間にポッドキャストやオーディオブックでインプット） 9:15 出社。午前は資料作成やメール返信 12:00 ランチはオフィス近くの定食屋かカフェ 13:00 午後は会議やマーケティング企画立案、データ分析 18:00 退社 19:00 帰宅途中にスーパー寄って買い物 19:30 夕食＆YouTubeやNetflixでリラックスタイム 21:00 ブログ執筆や写真編集、次の記事の構成作成 23:00 読書（比較記事のネタ探しも兼ねる） 23:45 就寝準備 24:00 就寝
はじめにOkHttpとRetrofitの違いを知る理由
OkHttp は 低レベルの HTTP クライアント であり通信の土台を作る道具です 押さえておきたいのはこの点であり OkHttp 単体でも URL へのリクエスト送信やレスポンスの受け取りは可能です 一方 Retrofit は 高レベルの API クライアント であり複数のエンドポイントを一つのインタフェースとして扱える設計になっています Retrofit は OkHttp を内部に組み込みながら API を宣言的に定義できる点が最大の魅力 つまり OkHttp が通信の土台であり Retrofit はその上に成り立つ建物のような関係です
この二つを混同せずに使い分けることで アプリの安定性と保守性を高められ 生産性 の向上や エラーハンドリングの統一 などの効果を期待できます ここから 具体的な使い分けと実装のコツを見ていきましょう
仕組みと使い分けのポイント
Retrofit は OkHttp を下地として使います つまり Retrofit を使うときは内部的に OkHttp が通信を実行します Retrofit は API の呼び出しを宣言的に定義できる点が魅力です アノテーション を利用して GET POST などの操作を定義し 返り値の型を任意のオブジェクトへ変換するコンバータを組み合わせます これによりネットワークの詳細を意識せずに API を呼び出せます また Retrofit は複数の形で結果を受け取ることをサポートするための コールアダプタ と コンバータファクトリ を組み合わせます これらを選ぶことで非同期処理の形や JSON などのデータ変換を自由に選べます
実際の実装では次のような流れになります OkHttp のクライアントを作成し その上に Retrofit のインスタンスを作ります そしてインタフェースを定義して API を呼び出します 実行時には Retrofit が内部で OkHttp を使い リクエストを送信し レスポンスを適切なデータ型に変換します この流れを理解しておくと 仕様変更にも対応しやすくなります
この表を読み解くと OkHttp は通信の基盤であり Retrofit は API 呼び出しの設計図だと分かります 基盤と設計図 の違いを理解すると それぞれを適切な場面で使えるようになります
実務での使い分けの具体例と注意点
実務ではまずアプリの要件を見極め どのくらいの柔軟性や拡張性が必要かを考えます 安定性 と 保守性 を両立させるために OkHttp の設定（タイムアウト 接続プール キャッシュの利用など）を適切に行い その上で Retrofit を導入するケースが多いです 例えば複数の API エンドポイントを持つアプリなら Retrofit の恩恵は大きく いちいち低レベルの通信処理を自分で書く手間を減らせます ただし シンプルな通信だけで十分な場合は OkHttp のみで事足りることもあります
ここからは実装のコツをいくつか挙げます 最初は Retrofit を選ぶ のが現実的です 初期段階で API 呼び出しをすべて型安全に記述できるため 読みやすさと変更のしやすさが向上します コンバータの選択 は要注意です Json のパースエンジンを Gson から Moshi へ移行する際の影響範囲を把握しておくとよいです エラーハンドリング は Retrofit 側で統一的に行い 失敗時の共通処理を用意しておくと保守が楽になります
このように OkHttp と Retrofit の役割を正しく理解して組み合わせると 多くの場面でコードがきれいになり バグの発生を抑えられます 自分のプロジェクトに合った組み合わせを選ぶことが大事です
友だちとの昼休みの雑談がきっかけで OkHttp と Retrofit の違いを深掘りしたことがあります ツッコミどころは アノテーションの使い方とコンバータの選択でした 友だちは宣言的に API を書く Retrofit の魅力だけを語っていましたが 私は同時に OkHttp の接続プールとタイムアウトの設定がアプリの体感速度を左右する点にも注目しました つまり 速さを求めるなら根底の通信基盤を強化しつつ Retrofit で宣言的に書く という二段構えが現実的という結論に落ち着きました もし友だちが将来の自分のためにコストを下げたいと考えるなら まずは Retrofit の使い方を完璧にしてから OkHttp の詳細設定へ踏み込むのが良いという話をしました
ITの人気記事
