【Android】VolleyでJSON配列オブジェクトの要素を読み取る方法を徹底解説

はじめに

Volleyは、Googleが提供するAndroidアプリ向けのHTTP通信ライブラリです。ネットワーク通信をシンプルかつ効率的に実装できるため、APIからデータを取得する際によく利用されています。

本記事では、Volleyを使ってサーバーからJSON形式の配列データを取得し、その中に含まれる各オブジェクトの要素（値）を読み取って表示する方法を、ステップごとにわかりやすく解説します。

ステップ1：新しいプロジェクトを作成する

まずはAndroid Studioで新しいプロジェクトを作成しましょう。メニューバーの「File」→「New Project」を選択し、必要な項目をすべて入力してプロジェクトを作成します。

ステップ2：レイアウトファイルを編集する

次に、res/layout/activity_main.xmlに以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:app="https://schemas.android.com/apk/res-auto"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:gravity="center"
android:layout_height="match_parent"
tools:context=".MainActivity">
<TextView
android:id="@+id/text"
android:textSize="30sp"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>

上記のコードでは、JSON配列から読み取ったオブジェクトの情報を画面に表示するためのTextViewを中央に配置しています。

ステップ3：MainActivity.javaを編集する

続いて、src/MainActivity.javaに以下のコードを追加します。ここが今回の処理の核心部分です。

package com.example.myapplication;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.widget.TextView;
import android.widget.Toast;
import com.android.volley.Request;
import com.android.volley.RequestQueue;
import com.android.volley.Response;
import com.android.volley.VolleyError;
import com.android.volley.toolbox.StringRequest;
import com.android.volley.toolbox.Volley;
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;
public class MainActivity extends AppCompatActivity {
    TextView textView;
    RequestQueue queue;
    String URL = "https://www.mocky.io/v2/597c41390f0000d002f4dbd1";
    @RequiresApi(api = Build.VERSION_CODES.N)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.text);
        queue = Volley.newRequestQueue(this);
        StringRequest request = new StringRequest(Request.Method.GET, URL, new Response.Listener<String>() {
            @Override
            public void onResponse(String response) {
                textView.setText(response.toString());
                try {
                    JSONObject object=new JSONObject(response);
                    JSONArray array=object.getJSONArray("users");
                    for(int i=0;i<array.length();i++) {
                        JSONObject object1=array.getJSONObject(i);
                        String name =object1.getString("name");
                        textView.setText(name);
                    }
                } catch (JSONException e) {
                    e.printStackTrace();
                }
            }
        }, new Response.ErrorListener() {
            @Override
            public void onErrorResponse(VolleyError error) {
                Log.d("error",error.toString());
            }
        });
        queue.add(request);
    }
}

このコードのポイントは以下の通りです。

• JSONObject：レスポンス全体をJSONオブジェクトとして解析します。
• getJSONArray("users")：「users」というキーに紐づくJSON配列を取得します。
• forループ：配列の長さ分だけ繰り返し処理を行い、各インデックスからgetJSONObject(i)で個々のオブジェクトを取り出します。
• getString("name")：各オブジェクトから「name」キーの値を読み取り、TextViewに表示します。

また、通信エラーが発生した場合にはErrorListenerによってログに出力される仕組みになっています。

ステップ4：AndroidManifest.xmlを編集する

インターネット通信を行うため、AndroidManifest.xmlにインターネット権限を追加します。以下のコードを追記してください。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.myapplication">
    <uses-permission android:name="android.permission.INTERNET" />
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
</application>
</manifest>

ステップ5：build.gradleに依存関係を追加する

Volleyライブラリを使用できるよう、build.gradleのdependenciesブロックに以下の依存関係を追加します。

apply plugin: 'com.android.application'
android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "com.example.myapplication"
        minSdkVersion 15
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.volley:volley:1.1.0'
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

特に重要なのは implementation 'com.android.volley:volley:1.1.0' の行です。これによりVolleyの機能がプロジェクト内で使えるようになります。

アプリを実行してみよう

それでは、作成したアプリケーションを実行してみましょう。ここでは実際のAndroidスマートフォンがパソコンに接続されていることを前提としています。

1. Android Studioでプロジェクト内の任意のアクティビティファイルを開きます。
2. ツールバーの「Run」アイコンをクリックします。
3. 接続済みのモバイルデバイスを選択します。

正常に動作すれば、実機の画面にJSON配列から読み取ったユーザー名が表示されます。

まとめ

本記事では、VolleyのStringRequestを使ってJSONデータを取得し、JSONArrayとJSONObjectを組み合わせて配列内の各オブジェクト要素を読み取る方法を紹介しました。APIから複数件のデータを扱う場面は実務でも非常に多いため、ぜひマスターしておきましょう。