Android Bundle总结

 

 

版本

修改内容

日期

修改人

1.0

初稿

2013/03/06

skywang

 

 

 

 



1 Bundle介绍

Bundle主要用于传递数据;它保存的数据,是以key-value(键值对)的形式存在的。

 

我们经常使用Bundle在Activity之间传递数据,传递的数据可以是boolean、byte、int、long、float、double、string等基本类型或它们对应的数组,也可以是对象或对象数组。当Bundle传递的是对象或对象数组时,必须实现Serializable 或Parcelable接口。下面分别介绍Activity之间如何传递基本类型、传递对象。

 

2传递基本类型

Bundle提供了各种常用类型的putXxx()/getXxx()方法,用于读写基本类型的数据。Bundle操作基本数据类型的API表格如下所示:

 

写数据的方法如下:


// "com.test" is the package name of the destination class
// "com.test.Activity02" is the full class path of the destination class
Intent intent = new Intent().setClassName("com.bundletest", "com.bundletest.Bundle02");

Bundle bundle = new Bundle();
bundle.putString("name", "skywang");
bundle.putInt("height", 175);
intent.putExtras(bundle);

startActivity(intent);

// end current class
finish();


对应的读数据的方法如下:

Bundle bundle = this.getIntent().getExtras();  
  
String name = bundle.getString("name");  
int height = bundle.getInt("height");



3传递Parcelable类型的对象

3.1 Parcelable说明

Parcelable是Android自定义的一个接口,它包括了将数据写入Parcel和从Parcel中读出的API。一个实体(用类来表示),如果需要封装到bundle消息中去,可以通过实现Parcelable接口来实现。


Parcelable和Serializable的API如下表:


3.2 Parcelable接口说明

public interface Parcelable {
    //内容描述接口,基本不用管
    public int describeContents();
    //写入接口函数,打包
    public void writeToParcel(Parcel dest, int flags);
    //读取接口,目的是要从Parcel中构造一个实现了Parcelable的类的实例处理。因为实现类在这里还是不可知的,所以需要用到模板的方式,继承类名通过模板参数传入。
    //为了能够实现模板参数的传入,这里定义Creator嵌入接口,内含两个接口函数分别返回单个和多个继承类实例。
    public interface Creator<T> {
        public T createFromParcel(Parcel source);
        public T[] newArray(int size);
 }
}



3.3 Parcelable接口的实现方法

从parcelable接口定义中,我们可以看到,实现parcelable接口,需要我们实现下面几个方法:
(01)describeContents方法。内容接口描述,默认返回0就可以;
(02)writeToParcel 方法。该方法将类的数据写入外部提供的Parcel中.即打包需要传递的数据到Parcel容器保存,以便从parcel容器获取数据,该方法声明如下:
writeToParcel(Parcel dest, int flags) 具体参数含义见doc文档
(3.)静态的Parcelable.Creator接口,本接口有两个方法:
createFromParcel(Parcelin)  从Parcel容器中读取传递数据值,封装成Parcelable对象返回逻辑层。
newArray(int size) 创建一个类型为T,长度为size的数组,仅一句话(returnnew T[size])即可。方法是供外部类反序列化本类数组使用。

 

4传递Serializable类型的对象

4.1 Serializable说明

Serializable是一个对象序列化的接口。一个类只有实现了Serializable接口,它的对象才是可序列化的。因此如果要序列化某些类的对象,这些类就必须实现Serializable接口。而实际上,Serializable是一个空接口,没有什么具体内容,它的目的只是简单的标识一个类的对象可以被序列化。

4.2 Serializable接口的实现方法

很简单,只要implements Serializable接口就可以了

 

5 demo演示程序

下面是对实现上述三种数据传递方式的BundleTest(demo程序)进行简要介绍

5.1 demo概要

BundleTest共包含了4个java文件和2个layout文件(main.xml和main2.xml)

Bundle01.java     —— 默认的主Activity窗口。

Bundle02.java     —— 主Activity用于跳转的目的窗口。

Book.java            —— 实现Parcelable接口的类

Person.java        —— 实现Serializable接口的类

main.xml             —— Bundle01.java的layout文件

main2.xml           —— Bundle02.java的layout文件

 

工程文件结构如下所示:

 

5.2代码

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.bundletest"
      android:versionCode="1"
      android:versionName="1.0">
	
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".Bundle01"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
		<activity android:name=".Bundle02"> </activity>
    </application>
    <uses-sdk android:minSdkVersion="11" />
</manifest>




main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
	<TextView  
		android:layout_width="fill_parent" 
		android:layout_height="wrap_content" 
		android:text="@string/app_01"
		/>

	<Button  
		android:id="@+id/btnBasic" 
		android:layout_width="fill_parent" 
		android:layout_height="wrap_content" 
		android:text="@string/text_basic"
		/>

	<Button  
		android:id="@+id/btnPar" 
		android:layout_width="fill_parent" 
		android:layout_height="wrap_content" 
		android:text="@string/text_par"
		/>

	<Button  
		android:id="@+id/btnSer" 
		android:layout_width="fill_parent" 
		android:layout_height="wrap_content" 
		android:text="@string/text_ser"
		/>



</LinearLayout>




main2.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
	<TextView  
		android:layout_width="fill_parent" 
		android:layout_height="wrap_content" 
		android:text="@string/app_02"
		/>

	<Button  
		android:id="@+id/btnBack" 
		android:layout_width="fill_parent" 
		android:layout_height="wrap_content" 
		android:text="@string/text_jump_back"
		/>
    
</LinearLayout>




strings.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello MyBundleTest!</string>
    <string name="app_name">MyBundleTest</string>
    <string name="app_01">Bundle_01</string>
    <string name="app_02">Bundle_02</string>
    <string name="text_basic">Bundle Basic Data</string>
    <string name="text_par">Bundle Parcelable Data</string>
    <string name="text_ser">Bundle Seriable Data</string>
    <string name="text_jump_back">Jump Back to Bundler01</string>
</resources>




Bundle01.java

package com.bundletest;

import android.app.Activity;
import android.os.Bundle;  
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.content.Intent;
import android.util.Log;

public class Bundle01 extends Activity implements View.OnClickListener{

	private static final String TAG = "skywang-->Bundle01";

	private Button mBtnBasic = null;
	private Button mBtnPar = null;
	private Button mBtnSer = null;

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);

		mBtnBasic = (Button) findViewById(R.id.btnBasic);
		mBtnBasic.setOnClickListener(this);

		mBtnPar = (Button) findViewById(R.id.btnPar);
		mBtnPar.setOnClickListener(this);

		mBtnSer = (Button) findViewById(R.id.btnSer);
		mBtnSer.setOnClickListener(this);
	}


	@Override
	public void onClick(View view) {
		switch (view.getId()) {
			case R.id.btnBasic:
				sendBasicDataThroughBundle();
				break;
			case R.id.btnPar:
				sendParcelableDataThroughBundle();
				break;
			case R.id.btnSer:
				sendSeriableDataThroughBundle();
				break;
			default:
				break;

		}
	}

	// sent basic data, such as int, strin, etc...  through bundle
    private void sendBasicDataThroughBundle(){  
		// "com.test" is the package name of the destination class
		// "com.test.Activity02" is the full class path of the destination class
		Intent intent = new Intent().setClassName("com.bundletest", "com.bundletest.Bundle02");
		
		Bundle bundle = new Bundle();
		bundle.putString("name", "skywang");
		bundle.putInt("height", 175);
		intent.putExtras(bundle);
		
		startActivity(intent);

		// end current class
		finish();
	}

	// sent object through Pacelable
    private void sendParcelableDataThroughBundle(){  
		Intent intent = new Intent().setClassName("com.bundletest", "com.bundletest.Bundle02");

        Book mBook = new Book();
        mBook.setBookName("Android");
        mBook.setAuthor("skywang");
        mBook.setPublishTime(2013);

        Bundle mBundle = new Bundle();
        mBundle.putParcelable("ParcelableValue", mBook);
        intent.putExtras(mBundle);
          
        startActivity(intent);
		finish();
    }

	// sent object through seriable
    private void sendSeriableDataThroughBundle(){  
		Intent intent = new Intent().setClassName("com.bundletest", "com.bundletest.Bundle02");

		Person mPerson = new Person();
        mPerson.setName("skywang");
        mPerson.setAge(24);

        Bundle mBundle = new Bundle();
        mBundle.putSerializable("SeriableValue",mPerson);
        intent.putExtras(mBundle);
          
        startActivity(intent);
		finish();
    }

}




Bundle02.java

package com.bundletest;

import android.app.Activity;
import android.os.Bundle;  
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.content.Intent;
import android.util.Log;

public class Bundle02 extends Activity implements View.OnClickListener {

	private static final String TAG = "skywang-->Bundle02";

	private Button mBtnBack = null;
	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main2);

		mBtnBack = (Button) findViewById(R.id.btnBack);
		mBtnBack.setOnClickListener(this);

		receiveBasicData();
		receiveParcelableData();
		receiveSeriableData();
	}

	private void receiveBasicData() {
        Bundle bundle = this.getIntent().getExtras();  
          
        String name = bundle.getString("name");  
        int height = bundle.getInt("height");
		if (name != null && height != 0)
		Log.d(TAG, "receice basic data -- " +
				   "name="+name+", height="+height);
	}

	private void receiveParcelableData() {
		Book mBook = (Book)getIntent().getParcelableExtra("ParcelableValue");
		if (mBook != null)
			Log.d(TAG, "receice parcel data -- " +
					   "Book name is: " + mBook.getBookName()+", "+
					   "Author is: " + mBook.getAuthor() + ", "+
					   "PublishTime is: " + mBook.getPublishTime());
	}

	private void receiveSeriableData() {
		Person mPerson = (Person)getIntent().getSerializableExtra("SeriableValue");  
		if (mPerson != null)
			Log.d(TAG, "receice serial data -- " +
					   "The name is:" + mPerson.getName() + ", "+
					   "age is:" + mPerson.getAge());  
	}

	@Override
	public void onClick(View view) {
		switch (view.getId()) {
			case R.id.btnBack:
			{
				// "com.test" is the package name of the destination class
				// "com.test.Activity01" is the full class path of the destination class
				Intent intent = new Intent().setClassName("com.bundletest", "com.bundletest.Bundle01");
				startActivity(intent);
				// end current class
				finish();
			}
				break;
			default:
				break;

		}
	}

}




Book.java

package com.bundletest;

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

public class Book implements Parcelable {  
    private String bookName;  
    private String author;  
    private int publishTime;  
      
    public String getBookName() {  
        return bookName;  
    }  
    public void setBookName(String bookName) {  
        this.bookName = bookName;  
    }  
    public String getAuthor() {  
        return author;  
    }  
    public void setAuthor(String author) {  
        this.author = author;  
    }  
    public int getPublishTime() {  
        return publishTime;  
    }  
    public void setPublishTime(int publishTime) {  
        this.publishTime = publishTime;  
    }  
      
    public static final Parcelable.Creator<Book> CREATOR = new Creator<Book>() {  
		@Override
        public Book createFromParcel(Parcel source) {  
            Book mBook = new Book();  
            mBook.bookName = source.readString();  
            mBook.author = source.readString();  
            mBook.publishTime = source.readInt();  
            return mBook;  
        }  
		@Override
        public Book[] newArray(int size) {  
            return new Book[size];  
        }  
    };  
      
	@Override
    public int describeContents() {  
        return 0;  
    }  

	@Override
    public void writeToParcel(Parcel parcel, int flags) {  
        parcel.writeString(bookName);  
        parcel.writeString(author);  
        parcel.writeInt(publishTime);  
    }  
}




Person.java

package com.bundletest;

import java.io.Serializable;  

public class Person implements Serializable {  

    private static final long serialVersionUID = 1L; 

    private String name;  
    private int age;  
    public String getName() {  
        return name;  
    }  
    public void setName(String name) {  
        this.name = name;  
    }  
    public int getAge() {  
        return age;  
    }  
    public void setAge(int age) {  
        this.age = age;  
    }  
      
}




 

5.3输出图片

Bundle01.java对应的界面如下:

 

点击“Bundle Basic Data”、“Bundle Parcelable Data”、“Bundle Seriable Data”均跳转到如下界面,但它们对应的logcat信息不同。

 

点击“Bundle Basic Data”的logcat如下:

点击“Bundle Parcelable Data”的logcat如下:

点击“Bundle Seriable Data”的logcat如下: