【Android】カスタムオブジェクトをParcelableにする方法をサンプルコードで解説

このチュートリアルでは、Androidアプリ開発において、独自に定義したカスタムクラス（カスタムオブジェクト）をParcelable対応にする方法を、サンプルコードとともにわかりやすく解説します。

Parcelableとは、オブジェクトを直列化してIntentやBundle経由でActivity間などに受け渡すためのAndroid標準インターフェースです。Java標準のSerializableよりも高速に動作するため、Android開発ではParcelableの実装が推奨されています。

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

Android Studioを起動し、メニューから「File」→「New Project」を選択します。必要な項目をすべて入力して、新しいプロジェクトを作成してください。

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

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"
    android:orientation="vertical">
    <Button
        android:id="@+id/parcelObject"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentTop="true"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="27dp"
        android:text="クリック"/>
</LinearLayout>

このレイアウトでは、Parcelableオブジェクトの値を画面に表示するためのボタンを1つ配置しています。

手順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.view.View;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
    ParcelObject sample;

    @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        findViewById(R.id.parcelObject).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                sample = new ParcelObject("sairamkrishna Mammahe");
                Toast.makeText(MainActivity.this, sample.getName(), Toast.LENGTH_LONG).show();
            }
        });
    }
}

ボタンがクリックされると、ParcelObjectのインスタンスを生成し、その名前をToastで表示します。

手順4：ParcelObject.java（カスタムParcelableクラス）を作成する

src/ParcelObject.java を新規作成し、以下のコードを記述します。これが本題となる、Parcelableインターフェースを実装したカスタムクラスです。

package com.example.myapplication;

import android.os.Parcel;
import android.os.Parcelable;

class ParcelObject implements Parcelable {
    private String name;

    protected ParcelObject(Parcel in) {
        this.name = in.readString();
    }

    public ParcelObject(String name) {
        this.name = name;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public static final Creator<ParcelObject> CREATOR = new Creator<ParcelObject>() {
        @Override
        public ParcelObject createFromParcel(Parcel in) {
            return new ParcelObject(in);
        }

        @Override
        public ParcelObject[] newArray(int size) {
            return new ParcelObject[size];
        }
    };

    @Override
    public int describeContents() {
        return 0;
    }

    @Override
    public void writeToParcel(Parcel dest, int flags) {
        dest.writeString(this.name);
    }
}

Parcelable実装のポイント

• writeToParcel()：オブジェクトのデータをParcelに書き出します。書き込む順序は復元時の読み込み順序と一致させてください。
• Parcelを受け取るコンストラクタ：Parcelからデータを読み込み、オブジェクトを復元します。
• CREATOR：Parcelからオブジェクトを生成するためのファクトリです。createFromParcel()とnewArray()を実装します。
• describeContents()：特別な内容（FileDescriptorなど）を含まない場合は0を返します。

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

それでは、アプリケーションを実行してみましょう。ここでは、実機のAndroid端末がPCに接続されているものとします。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「実行（Run）」アイコンをクリックします。デバイス選択画面で接続したモバイル端末を選ぶと、端末に次のような初期画面が表示されます。

続いてボタンをタップすると、以下のようにToastでParcelObjectに格納された名前が表示されます。