AndroidアプリでJSONArrayを解析する方法を解説！初心者向けステップバイステップガイド

AndroidでJSONArrayを解析するには？

この記事では、AndroidアプリでJSONArray（JSON配列）を解析する方法を、実際のコード例とともに段階的に解説します。JSONデータの取り扱いは、Web APIと連携するAndroidアプリ開発において必須のスキルです。

手順1：新しいプロジェクトを作成する

まず、Android Studioを開き、File → New Project を選択して、必要な情報をすべて入力し、新しいプロジェクトを作成します。

手順2：レイアウトファイル（activity_main.xml）にコードを追加する

res/layout/activity_main.xml に以下のコードを記述します。ここでは、解析結果を表示するためのTextViewを画面中央に配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <TextView
        android:id="@+id/textView"
        android:textSize="24sp"
        android:textStyle="bold"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true" />
</RelativeLayout>

手順3：MainActivity.javaにJSON解析コードを実装する

src/MainActivity.java に以下のコードを追加します。このサンプルでは、名前・年齢・性別を含むJSON文字列を定義し、JSONObject と JSONArray クラスを使ってデータを取り出しています。

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;
public class MainActivity extends AppCompatActivity {
    TextView textView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.textView);
        String strJson = "{ \"Basic info\"
            :[{\"Name\":\"Mash\",\"Age\":\"27\"," +
            "\"Gender\":\"Male\"},{\"Name\":\"Niyaz\",\"Age\":\"23\"," +
            "\"Gender\":\"Male\"}]}";
        String data = "";
        try {
            JSONObject jsonRootObject = new JSONObject(strJson);
            JSONArray jsonArray = jsonRootObject.optJSONArray("Basic info");
            int i=0;
            while (i < jsonArray.length()) {
                JSONObject jsonObject = jsonArray.getJSONObject(i);
                int age = Integer.parseInt(jsonObject.optString("Age"));
                String name = jsonObject.optString("Name");
                String gender = jsonObject.optString("Gender");
                data += "Node"+i+" : \n Name= "+ name +" \n
                    Age= "+ age +" \n Gender= "+ gender + " \n ";
                i++;
            }
            textView.setText(data);
        } catch (JSONException e) {e.printStackTrace();}
    }
}

コードのポイント：

• new JSONObject(strJson) でJSON文字列全体をルートオブジェクトとしてパースします。
• optJSONArray("Basic info") でキー「Basic info」に対応するJSONArrayを取得します。
• while ループで配列の要素数分だけ繰り返し処理を行い、各要素から「Name」「Age」「Gender」の値を optString() メソッドで抽出します。
• 取得したデータは文字列として連結され、最後にTextViewへセットされて画面に表示されます。
• JSONException の例外処理も忘れずに行いましょう。

手順4：AndroidManifest.xmlを確認する

androidManifest.xml に以下のコードが正しく記述されていることを確認します。このサンプルではインターネット通信を使用しないため、特別なパーミッションの追加は不要です。

<?xml version="1.0" encoding="utf-8"?>
<manifest
    xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">
    <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" />
                <category
                    android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリを実行して結果を確認する

それでは、実際にアプリケーションを実行してみましょう。実機のAndroidスマートフォンをパソコンに接続していることを前提としています。Android Studioからアプリを起動するには、プロジェクト内のいずれかのアクティビティファイルを開き、ツールバーの実行（Run）アイコンをクリックします。表示された選択肢から自分のモバイルデバイスを選択すると、接続した端末上でアプリが起動します。

正常に動作すれば、画面中央のTextViewに以下のようにJSON配列から抽出されたデータが表示されます。

Node0 : 
 Name= Mash 
 Age= 27 
 Gender= Male 
 Node1 : 
 Name= Niyaz 
 Age= 23 
 Gender= Male

まとめ

このように、AndroidアプリでのJSONArray解析は、JSONObject と JSONArray クラスを組み合わせることで簡単に実装できます。実際のアプリ開発では、サーバーから取得したAPIレスポンスに対して同様の手順でパース処理を行うことになります。JSONの扱いに慣れておくと、ネットワーク通信を伴うアプリ開発がぐっとスムーズになりますよ。