android Parcelable完全解析

浏览数：18 / 时间：2015年06月11日

title: android.os.Parcelable文档自译 date: 2014-12-05 09:16:06

tags:

android.os.Parcelable接口的已知间接子类很多，这里就不列举了：

Class Overview

Interface for classes whose instances can be written to and restored from a

Parcel. Classes implementing the Parcelable interface must also have a static

field called CREATOR, which is an object implementing the Parcelable.Creator

interface.

该Interface用于实例可以被写入，并且可以从Parcel中恢复的classes(对于Parcel暂时只要知道它是一个存放数据的容器就好了，我会在android IPC中写到它)。实现android.os.Parcelable接口的类必须持有一个实现了android.os.Parcelable接口的名为 CREATOR 的静态字段。

android.os.Parcelable接口典型使用方式,这是官网的例子：

package me.androiddemo.canglangwenyue.androiddemo;

import android.os.Parcel;

import android.os.Parcelable;

/**

* Created by canglangwenyue on 12/5/14.

public class MyParcelable implements Parcelable {

private int mData;

public int describeContents() {

return 0;

}

public void writeToParcel(Parcel out, int flags) {

out.writeInt(mData);

}

public static final Parcelable.Creator<MyParcelable> CREATOR

= new Parcelable.Creator<MyParcelable>() {

public MyParcelable createFromParcel(Parcel in) {

return new MyParcelable(in);

}

public MyParcelable[] newArray(int size) {

return new MyParcelable[size];

}

};

private MyParcelable(Parcel in) {

mData = in.readInt();

}

Summary(简介)

Nested Classes(嵌套类)

1.interface Parcelable.ClassLoaderCreator<T>

Specialization of Parcelable.Creator that allows you to receive

the ClassLoader the object is being created in.

解析：专业化的 Parcelable.Creator，允许你接收的Object内部创建的 ClassLoader 对象.

2.interface Parcelable.Creator<T>

Interface that must be implemented and provided as a public CREATOR field that

generates instances of your Parcelable class from a Parcel.

解析：该接口必须被子类实现，而且CREATOR 作为公有字段来提供，CREATOR 用于从 Parcel中实例化你的可包装类.

Constants(常量)

1.int CONTENTS_FILE_DESCRIPTOR

Bit masks for use with describeContents(): each bit represents a kind of object

considered to have potential special significance when marshalled.

解析：用于 describeContents() 的位掩码，每一位代表它编组时附加的特殊含义。

2.int PARCELABLE_WRITE_RETURN_VALUE

Flag for use with writeToParcel(Parcel, int): the object being written is a

return value, that is the result of a function such as "Parcelable

someFunction()", "void someFunction(out Parcelable)", or "void

someFunction(inout Parcelable)".

解析：writeToParcel(Parcel, int)的标志位：作为一个返回值，是"Parcelable

someFunction()", "void someFunction(out Parcelable)", or "void

someFunction(inout Parcelable)"返回的result。

Public Methods(公共method)

1.abstract int describeContents()

Describe the kinds of special objects contained in this Parcelable‘s marshalled

representation.

解析：描述各种特殊对象，它们包含在可包装对象的编组形式中.

2.abstract void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

解析：将该对象展开到Parcel(存放数据的容器)中。

Parcelable适用于通过Intent来传递自定义对象。最后给出一个用Parcelable进行数据传送的例子

1.发送Object的Activity，内容很简单，点击Button，Intent携带Object跳转到MainActivity2(用来接收Object的Activity)。

package me.androiddemo.canglangwenyue.androiddemo;

import android.content.Intent;

import android.support.v7.app.ActionBarActivity;

import android.os.Bundle;

import android.view.Menu;

import android.view.MenuItem;

import android.view.View;

import android.widget.Button;

import java.util.HashMap;

/**

* @author canglangwenyue

* 用来发送信息的Activity

public class MainActivity extends ActionBarActivity {

private Button sendButton;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

sendButton = (Button) findViewById(R.id.send_button);

sendButton.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

Intent intent = new Intent();

Person person = new Person();

person.name = "WenYue";

intent.putExtra("WenYue",person);

intent.setClass(MainActivity.this,MainActivity2.class);

startActivity(intent);

}

});

}

@Override

public boolean onCreateOptionsMenu(Menu menu) {

// Inflate the menu; this adds items to the action bar if it is present.

getMenuInflater().inflate(R.menu.menu_main, menu);

return true;

}

@Override

public boolean onOptionsItemSelected(MenuItem item) {

// Handle action bar item clicks here. The action bar will

// automatically handle clicks on the Home/Up button, so long

// as you specify a parent activity in AndroidManifest.xml.

int id = item.getItemId();

//noinspection SimplifiableIfStatement

if (id == R.id.action_settings) {

return true;

}

return super.onOptionsItemSelected(item);

}

2.MainActivity2用来接收来自MainActivity的Object，并打印Person.name的长度和content。

package me.androiddemo.canglangwenyue.androiddemo;

import android.content.Intent;

import android.support.v7.app.ActionBarActivity;

import android.os.Bundle;

import android.util.Log;

import android.view.Menu;

import android.view.MenuItem;

/**

@author canglangwenyue
接收数据的Intent */
public class MainActivity2 extends ActionBarActivity {
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main_activity2);
Intent intent = getIntent();
Person person = intent.getParcelableExtra("WenYue");
Log.e("MainActivity2 received message‘s length----->",String.valueOf(person.name.length()));
Log.e("MainActivity2 received message content------>",person.name);
}
@Override public boolean onCreateOptionsMenu(Menu menu) { // Inflate the menu; this adds items to the action bar if it is present. getMenuInflater().inflate(R.menu.menu_main_activity2, menu); return true; }
@Override public boolean onOptionsItemSelected(MenuItem item) { // Handle action bar item clicks here. The action bar will // automatically handle clicks on the Home/Up button, so long // as you specify a parent activity in AndroidManifest.xml. int id = item.getItemId();
//noinspection SimplifiableIfStatement
if (id == R.id.action_settings) {
return true;
}
return super.onOptionsItemSelected(item);
} }