2022年8月2日

松本

AndroidでREST APIを取り扱うお話

facebook
twitter

前回のお話でREST APIを気軽に確認する内容を書きましたが、今回は実際にスマホアプリ内でREST APIのやりとりを行う方法をまとめます。

以前はOkHttpというライブラリを使うことが多く、現在もそれが主流になりますが、今回はkotlinで使えるRetrofitと呼ばれるライブラリを使っていきましょう

1 インストール
2 使い方
3 まとめ

インストール

通信するので当然アプリ側にインターネット接続の設定をする必要があります。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="[パッケージ名]">

    <uses-permission android:name="android.permission.INTERNET" /> ← 追加

</manifest>

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

package="[パッケージ名]">

<uses-permission android:name="android.permission.INTERNET" /> ← 追加

</manifest>

/app/build.gradleにRetrofitを書きましょう。
JSONでやりとりするのでGsonも入れましょう。

    def retrofit_version = '2.6.2'
    implementation "com.squareup.retrofit2:retrofit:$retrofit_version"
    implementation "com.squareup.retrofit2:converter-gson:$retrofit_version"

def retrofit_version = '2.6.2'

implementation "com.squareup.retrofit2:retrofit:$retrofit_version"

implementation "com.squareup.retrofit2:converter-gson:$retrofit_version"

バージョンは2022.08時点ですが、多分3年くらい変わってない気がします…

これで簡単にsyncを押すと利用可能です。

使い方

使い方と言ってもREST APIの基本的な設定（メソッドやヘッダーなど）をInterface、データの構造をクラス化して、各画面で呼び出す感じとなります。
名前は何でもいいですが、こんな感じで各ファイルにまとめたいと思います。

Interface	ApiService.kt
Model	ApiModel.kt
Fragment	MainFragment.kt

GETの場合

例として架空のREST APIを用意します。

内容

メンバー情報取得

詳細

メンバー情報を取得する

URI

/gray/

METHOD

GET

認証

Authorization: Bearer ais7Uki8d300ibGhQOee51die

パラメータ

No parameters

レスポンス

{
  "code": 200,
  "message": "",
  "members": [
    {
     "id": 1,
     "name": "Takuro",
     "type": "Guiter",
    },
    {
     "id": 2,
     "name": "Teru",
     "type": "Vocal",
    },
  ]
}

{

"code": 200,

"message": "",

"members": [

{

"id": 1,

"name": "Takuro",

"type": "Guiter",

{

"id": 2,

"name": "Teru",

"type": "Vocal",

]

}

こんな感じです。

認証用のトークンをheaderに設定して、GETで叩くとメンバー情報を取得できるという感じですね。

まずはデータクラスをまとめましょう。
今回はレスポンスの値を渡すので、ApiModel.ktに以下のように定義します。

class ResponseMembers(
    val code: Int,
    val message: String,
    val members: ArrayList<Members>,
)

class Members(
   val id: Int,
   val name: String,
   val type: String,
)

class ResponseMembers(

val code: Int,

val message: String,

val members: ArrayList<Members>,

)

class Members(

val id: Int,

val name: String,

val type: String,

)

[members]は複数の配列で来るので、Membersの配列として定義します。

定義ができたところで、Interfaceに書いちゃいましょう。

    /*
    *  メンバー情報を取得
    */

    @Headers("User-Agent:" + user_agent)
    @GET("users/")
    fun getMembers(@Header("Authorization") token: String): Call<ResponseMembers>

* メンバー情報を取得

@Headers("User-Agent:" + user_agent)

@GET("users/")

fun getMembers(@Header("Authorization") token: String): Call<ResponseMembers>

@Headersには今回UserAgentを設定してます。
@GETや@POSTや@PUT、@DELETEもあるので簡単にメソッドを設定できますね。

getMembers関数を定義してます。
引数は認証用のtokenを渡すことでHeaderに記載されます。
戻り値は先ほど定義した[ResponseMembers]ですね。

これで設定完了です。

実際に呼び出す場合は

        val token = "sdasdasdsa"
        val service = Retrofit.Builder()
            .baseUrl("https://hoge.api.net/")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
            .create(ApiService::class.java)

        thread {
            try {
                val response = service.getMembers(token).execute()
                // レスポンスコード
                if(response.code() == 200){
                    response.body()?.let{
                        val members: ArrayList<Members> = it.members
                        members.forEach { member->
                          Log.d("test", "id:"+member.id)
                          Log.d("test", "name:"+member.name)
                          Log.d("test", "type:"+member.type)
                        }
                    }
                }else{
                    response.errorBody()?.let {
                        // エラー時の処理
                    }
                }

            }catch (e:HttpException){
                Log.e("text", e.localizedMessage)
            }
        }

val token = "sdasdasdsa"

val service = Retrofit.Builder()

.baseUrl("https://hoge.api.net/")

.addConverterFactory(GsonConverterFactory.create())

.build()

.create(ApiService::class.java)

thread {

try {

val response = service.getMembers(token).execute()

// レスポンスコード

if(response.code() == 200){

response.body()?.let{

val members: ArrayList<Members> = it.members

members.forEach { member->

Log.d("test", "id:"+member.id)

Log.d("test", "name:"+member.name)

Log.d("test", "type:"+member.type)

}

}else{

response.errorBody()?.let {

// エラー時の処理

}

}catch (e:HttpException){

Log.e("text", e.localizedMessage)

}

簡単な実装ですが、これで簡単に取得できます。
シンプルで簡単にできますよね。
ただ、TextViewに反映しようとするとメインスレッドでないと怒られるのでそこだけ注意してください

POSTの場合

POSTの場合も実は簡単です。

内容

メンバー情報新規登録

詳細

メンバー情報を新規登録する

URI

/gray/

METHOD

POST

認証

Authorization: Bearer ais7Uki8d300ibGhQOee51die

パラメータ

{
   "name": "Jiro",
   "type": "Guiter",
}

{

"name": "Jiro",

"type": "Guiter",

}

レスポンス

{
  "code": 200,
  "message": "success",
    {
     "id": 3,
     "name": "Jiro",
     "type": "Guiter",
    },
}

{

"code": 200,

"message": "success",

{

"id": 3,

"name": "Jiro",

"type": "Guiter",

}

モデルクラスを設定しましょう

class ResponseApi(
    val code: Int,
    val message: String,
    val member: Members,
)

class PostMember(
   val name: String,
   val type: String,
)

class ResponseApi(

val code: Int,

val message: String,

val member: Members,

)

class PostMember(

val name: String,

val type: String,

)

インターフェースです

    /*
    *  メンバー情報を新規登録
    */

    @Headers("User-Agent:" + user_agent)
    @POST("users/")
    fun postMember(@Header("Authorization") token: String, @Body post: postmember): Call<ResponseApi>

* メンバー情報を新規登録

@Headers("User-Agent:" + user_agent)

@POST("users/")

fun postMember(@Header("Authorization") token: String, @Body post: postmember): Call<ResponseApi>

取得時とあまり変わりません。変わった点はメソッドがPOSTになったのと、@Bodyでデータクラスを渡すところですね。

それでは実装しましょう。

        val postData = PostMember(name = "omiokurigeinin-shinichi", type = "guiter")

        val token = "sdasdasdsa"
        val service = Retrofit.Builder()
            .baseUrl("https://hoge.api.net/")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
            .create(ApiService::class.java)

        thread {
            try {
                val response = service.postMember(token, postData).execute()
                // レスポンスコード
                if(response.code() == 200){
                }else{
                    response.errorBody()?.let {
                        // エラー時の処理
                    }
                }

            }catch (e:HttpException){
                Log.e("text", e.localizedMessage)
            }
        }

val postData = PostMember(name = "omiokurigeinin-shinichi", type = "guiter")

val token = "sdasdasdsa"

val service = Retrofit.Builder()

.baseUrl("https://hoge.api.net/")

.addConverterFactory(GsonConverterFactory.create())

.build()

.create(ApiService::class.java)

thread {

try {

val response = service.postMember(token, postData).execute()

// レスポンスコード

if(response.code() == 200){

}else{

response.errorBody()?.let {

// エラー時の処理

}

}catch (e:HttpException){

Log.e("text", e.localizedMessage)

}

GETとの違いは引き渡す値をまとめて引数に渡してますね。
これだけで簡単にPOST通信することが可能です。

PUT通信の場合

PUTは主に更新系で使うメソッドですが、この場合もPOSTとよく似た形です。

内容

メンバー情報の変更

詳細

メンバー情報を変更する

URI

/gray/{id}

METHOD

PUT

認証

Authorization: Bearer ais7Uki8d300ibGhQOee51die

パラメータ

{
   "name": "Takuro",
   "type": "Guiter",
}

{

"name": "Takuro",

"type": "Guiter",

}

レスポンス

{
  "code": 200,
  "message": "success",
    {
     "id": 3,
     "name": "Takuro",
     "type": "Guiter",
    },
}

{

"code": 200,

"message": "success",

{

"id": 3,

"name": "Takuro",

"type": "Guiter",

}

変更するIDをURIにつけてPUTします。例） /gray/1

データクラスは既存のものを流用できるのでInterfaceを作ります。

    /*
    *  メンバー情報を変更
    */

    @Headers("User-Agent:" + user_agent)
    @POST("users/{id}")
    fun putMember(@Header("Authorization") token: String, @Path("id") id: Int, @Body post: postmember): Call<ResponseApi>

* メンバー情報を変更

@Headers("User-Agent:" + user_agent)

@POST("users/{id}")

fun putMember(@Header("Authorization") token: String, @Path("id") id: Int, @Body post: postmember): Call<ResponseApi>

putMember関数の第二引数に変更するIDを渡します。

実装は以下のようになります。

        val postData = PostMember(name = "Hisashi", type = "guiter")
        val id = 3

        val token = "sdasdasdsa"
        val service = Retrofit.Builder()
            .baseUrl("https://hoge.api.net/")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
            .create(ApiService::class.java)

        thread {
            try {
                val response = service.putMember(token, id, postData).execute()
                // レスポンスコード
                if(response.code() == 200){
                }else{
                    response.errorBody()?.let {
                        // エラー時の処理
                    }
                }

            }catch (e:HttpException){
                Log.e("text", e.localizedMessage)
            }
        }

val postData = PostMember(name = "Hisashi", type = "guiter")

val id = 3

val token = "sdasdasdsa"

val service = Retrofit.Builder()

.baseUrl("https://hoge.api.net/")

.addConverterFactory(GsonConverterFactory.create())

.build()

.create(ApiService::class.java)

thread {

try {

val response = service.putMember(token, id, postData).execute()

// レスポンスコード

if(response.code() == 200){

}else{

response.errorBody()?.let {

// エラー時の処理

}

}catch (e:HttpException){

Log.e("text", e.localizedMessage)

}

これでPUTが行えます。

今回は取り上げませんがDELETEも同様な感じで実装が可能です。

まとめ

油断すると新しいトレンドがどんどん出てくるスマホアプリ開発ですが、Retrofitを使うと、わかりやすく実装できるので、非常に楽ですね。

次はSwiftでもREST APIの使い方の紹介ができればいいかなと思います。

個人的にはViewModelを使っていきたいのでそっちを勉強がてら投稿するかもしれませんが…

Web制作、Webサービスに関する技術やノウハウを発信するコラムサイト

AndroidでREST APIを取り扱うお話

インストール

使い方

GETの場合

POSTの場合

PUT通信の場合

まとめ

関連記事

【phpdotenv】PHPで環境変数を取り扱うお話

【CAPTCHA系】reCAPTCHAの代替サービスを紹介するお話

Webアクセシビリティの基本を学ぼう！