KotlinのAPI通信でファイルダウンロードを実装する方法！初心者にもわかるネットワーク通信の基本

先生と生徒の会話形式で理解しよう

生徒

「Kotlinで画像やPDFなどのファイルをダウンロードするには、どうすればいいんですか？」

先生

「それはAPI通信を使って、ファイルのデータを受け取って保存する方法だね。KotlinではOkHttpを使えば簡単にダウンロードできるよ。」

生徒

「プログラミング初心者でも大丈夫ですか？なんだか難しそうで…」

先生

「大丈夫。一つひとつ丁寧に解説していくから、安心して一緒に学んでいこう！」

1. API通信でファイルをダウンロードするとは？

ファイルダウンロードとは、インターネット上のサーバーから画像・PDF・ZIPファイルなどを自分のスマホやパソコンに保存することです。Kotlinでは、HTTP通信でファイルの中身（バイトデータ）を受け取り、ローカルに保存することでダウンロードを実現します。

2. 使用するライブラリの準備

今回は、Kotlinで人気のあるOkHttpという通信ライブラリを使います。シンプルなコードでネットワーク通信が行えるので、初心者にもおすすめです。

Gradleのdependenciesに次のように追加してください：


dependencies {
    implementation("com.squareup.okhttp3:okhttp:4.12.0")
}

3. Kotlinでファイルダウンロードを実装してみよう

それでは、KotlinでファイルをAPIからダウンロードしてローカルに保存する基本的なコードを見てみましょう。


import okhttp3.OkHttpClient
import okhttp3.Request
import java.io.File
import java.io.FileOutputStream

fun main() {
    val client = OkHttpClient()
    val request = Request.Builder()
        .url("https://example.com/sample.pdf")
        .build()

    client.newCall(request).execute().use { response ->
        val inputStream = response.body?.byteStream()
        val file = File("downloaded_sample.pdf")
        val outputStream = FileOutputStream(file)

        inputStream?.copyTo(outputStream)
        outputStream.close()
        println("ファイルを保存しました: ${file.absolutePath}")
    }
}

inputStreamはサーバーから送られてきたファイルの中身を読み取るための仕組みで、outputStreamはそれを書き込むために使います。

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

4. 実行結果のイメージ

上記コードを実行すると、次のような出力が表示されます：


ファイルを保存しました: /Users/yourname/projects/downloaded_sample.pdf

このようにして、ファイルのダウンロードが成功して保存されたことが確認できます。

5. 画像やZIPなど他のファイルにも対応可能

今回の例ではPDFをダウンロードしましたが、画像ファイル（JPEG、PNG）やZIPファイル、音声ファイル（MP3）など、さまざまな形式のファイルも同様の方法で扱えます。

保存時のファイル名と拡張子を変えるだけでOKです。

6. ファイルサイズが大きいときの注意点

大きなファイル（数百MB以上）をダウンロードするときは、メモリの使用量や通信の途中切断に注意する必要があります。そのため、useやcopyToでしっかりとリソースを解放することが大切です。

また、通信の失敗に備えて、エラーハンドリングも追加しましょう。

7. エラー処理を追加して安全に

ダウンロード中にエラーが発生することもあるので、try-catchで処理を安全に守るようにしましょう。


try {
    client.newCall(request).execute().use { response ->
        val inputStream = response.body?.byteStream()
        val file = File("downloaded_sample.pdf")
        val outputStream = FileOutputStream(file)

        inputStream?.copyTo(outputStream)
        outputStream.close()
        println("ファイルを保存しました: ${file.absolutePath}")
    }
} catch (e: Exception) {
    println("ダウンロード中にエラーが発生しました: ${e.message}")
}