Android中使用FragmentManager管理fragments

聖騎士Wind的部落格發表於2015-03-07
AndroidFragment

本文將通過一個例子，簡單介紹了Android中通過FragmentManager來管理fragments的方法和程式碼，其核心是呼叫Activity中的getFragmentManager()方法，我們從介紹FragmentManager開始，一起來看看吧。

FragmentManager

為了管理Activity中的fragments，需要使用FragmentManager.

為了得到它，需要呼叫Activity中的getFragmentManager()方法。

因為FragmentManager的API是在Android 3.0，也即API level 11開始引入的，所以對於之前的版本，需要使用support library中的FragmentActivity，並且使用getSupportFragmentManager()方法。

用FragmentManager可以做的工作有：

得到Activity中存在的fragment：

使用findFragmentById()或findFragmentByTag()方法。

將fragment彈出back stack：

popBackStack()：將back stack中最後一次的fragment轉換彈出。如果沒有可以出棧的東西，返回false。

這個函式是非同步的：它將彈出棧的請求加入佇列，但是這個動作直到應用回到事件迴圈才會執行。

為back stack加上監聽器：

addOnBackStackChangedListener()

Performing Fragment Transactions

使用Fragment時，可以通過使用者互動來執行一些動作，比如增加、移除、替換等。

所有這些改變構成一個集合，這個集合被叫做一個transaction。

可以呼叫FragmentTransaction中的方法來處理這個transaction，並且可以將transaction存進由activity管理的back stack中，這樣使用者就可以進行fragment變化的回退操作。

可以這樣得到FragmentTransaction類的例項：

FragmentManager fragmentManager = getFragmentManager();

FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();

每個transaction是一組同時執行的變化的集合。

用add(), remove(), replace()方法，把所有需要的變化加進去，然後呼叫commit()方法，將這些變化應用。

在commit()方法之前，你可以呼叫addToBackStack()，把這個transaction加入back stack中去，這個back stack是由activity管理的，當使用者按返回鍵時，就會回到上一個fragment的狀態。

比如下面的程式碼就是用一個新的fragment取代之前的fragment，並且將前次的狀態儲存在back stack中。

// Create new fragment and transaction
Fragment newFragment = new ExampleFragment();
FragmentTransaction transaction = getFragmentManager().beginTransaction();

// Replace whatever is in the fragment_container view with this fragment,
// and add the transaction to the back stack
transaction.replace(R.id.fragment_container, newFragment);
transaction.addToBackStack(null);

// Commit the transaction
transaction.commit();

在這個例子中，newFragment將取代在R.id.fragment_container容器中的fragment，如果沒有，將直接新增新的fragment。

通過呼叫addToBackStack()，commit()的一系列轉換作為一個transaction被儲存在back stack中，使用者按Back鍵可以返回上一個轉換前的狀態。

當你移除一個fragment的時候，如果commit()之前沒有呼叫addToBackStack()，那個fragment將會是destroyed；如果呼叫了addToBackStack()，這個fragment會是stopped，可以通過返回鍵來恢復。

關於commit()方法

呼叫commit()方法並不能立即執行transaction中包含的改變動作，commit()方法把transaction加入activity的UI執行緒佇列中。

但是，如果覺得有必要的話，可以呼叫executePendingTransactions()方法來立即執行commit()提供的transaction。

這樣做通常是沒有必要的，除非這個transaction被其他執行緒依賴。

注意：你只能在activity儲存它的狀態（當使用者要離開activity時）之前呼叫commit()，如果在儲存狀態之後呼叫commit()，將會丟擲一個異常。

這是因為當activity再次被恢復時commit之後的狀態將丟失。如果丟失也沒關係，那麼使用commitAllowingStateLoss()方法。

例項程式

寫了個小程式實踐了一下fragment的管理，程式不是很完善，就是試試基本用法，先按第一個按鈕新增一個fragment，第二個按鈕將其替換，第三個按鈕將第二個按鈕新增的fragment刪除。

相關程式碼：

第一個fragment：

package com.example.learningfragment;

import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;

public class ExampleFragment extends Fragment
{

    //三個一般必須過載的方法
    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        // TODO Auto-generated method stub
        super.onCreate(savedInstanceState);
        System.out.println("ExampleFragment--onCreate");
    }

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
            Bundle savedInstanceState)
    {
        System.out.println("ExampleFragment--onCreateView");
        return inflater.inflate(R.layout.example_fragment_layout, container, false);

    }

    @Override
    public void onPause()
    {
        // TODO Auto-generated method stub
        super.onPause();
        System.out.println("ExampleFragment--onPause");
    }

    @Override
    public void onResume()
    {
        // TODO Auto-generated method stub
        super.onResume();
        System.out.println("ExampleFragment--onResume");
    }

    @Override
    public void onStop()
    {
        // TODO Auto-generated method stub
        super.onStop();
        System.out.println("ExampleFragment--onStop");
    }

}

它的佈局：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="left"
        android:textSize="20dip"
        android:text="@string/fragment1"
           />
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/num1"
           />
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/num2"
        />  
</LinearLayout>

第二個fragment:

package com.example.learningfragment;

import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;

public class NewFragment extends Fragment
{

    //三個一般必須過載的方法
    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        // TODO Auto-generated method stub
        super.onCreate(savedInstanceState);
        System.out.println("NewFragment--onCreate");
    }

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
            Bundle savedInstanceState)
    {
        System.out.println("NewFragment--onCreateView");
        return inflater.inflate(R.layout.new_fragment_layout, container, false);

    }

    @Override
    public void onPause()
    {
        // TODO Auto-generated method stub
        super.onPause();
        System.out.println("NewFragment--onPause");
    }

}
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" > 
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="20dip"
        android:gravity="left"
        android:text="@string/fragment2"
           />  
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/num3"
           />
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/num4"
        />  
</LinearLayout>

主Activity：

package com.example.learningfragment;

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import android.support.v4.app.FragmentManager;
import android.support.v4.app.FragmentTransaction;
import android.view.View;
import android.widget.Button;

public class LearnFragment extends FragmentActivity
{
    Button btn1;
    Button btn2;
    Button btn3;
    ExampleFragment fragmentE;
    NewFragment fragmentN;
    FragmentManager fragmentManager;

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

        //獲得Fragment管理所需要的類的物件
        fragmentManager = getSupportFragmentManager();

    }

    private void findViews()
    {
        btn1 = (Button) findViewById(R.id.btn1);
        btn2 = (Button) findViewById(R.id.btn2);
        btn3 = (Button) findViewById(R.id.btn3);

    }

    private void setListeners()
    {
        //第一個按鈕，增加一個ExampleFragment
        btn1.setOnClickListener(new Button.OnClickListener()
        {

            public void onClick(View v)
            {    

                //在程式中加入ExampleFragment                
                fragmentE = new ExampleFragment();

                FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
                fragmentTransaction.add(R.id.linear1,fragmentE);
                fragmentTransaction.addToBackStack(null);            
                fragmentTransaction.commit();                
            }

        }
        );

        //第二個按鈕，用一個NewFragment替換前面增加的那個fragment
        btn2.setOnClickListener(new Button.OnClickListener()
        {

            public void onClick(View v)
            {                
                fragmentN = new NewFragment();
                FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
                fragmentTransaction.replace(R.id.linear1,fragmentN);
                fragmentTransaction.addToBackStack(null);
                fragmentTransaction.commit();

            }

        }
        );

        //第三個按鈕，移除fragment
        btn3.setOnClickListener(new Button.OnClickListener()
        {

            public void onClick(View v)
            {

                FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
                fragmentTransaction.remove(fragmentN);
                fragmentTransaction.addToBackStack(null);
                fragmentTransaction.commit();

            }

        }
        );
    }

}
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/linear1"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    >
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="20dip"
        android:gravity="center_horizontal"
        android:text="@string/layout1"
           />
    <Button
        android:id="@+id/btn1"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/btn1"      
        />

    <fragment 
        android:name="com.example.learningfragment.ExampleFragment"
        android:id="@+id/fragment1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"

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

    <LinearLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:id="@+id/linear2"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        >
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="20dip"
        android:gravity="center_horizontal"
        android:text="@string/layout2"
           />
     <Button
        android:id="@+id/btn3"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/btn3"      
        />
     </LinearLayout>

</LinearLayout>

資源：

<resources>

    <string name="app_name">LearningFragment</string>
    <string name="hello_world">Hello world!</string>
    <string name="menu_settings">Settings</string>
    <string name="title_activity_learn_fragment">LearnFragment</string>

    <string name="layout1">LinearLayout1</string>
    <string name="layout2">LinearLayout2</string>

    <string name="fragment1">FragmentType1</string>
    <string name="fragment2">FragmentType2</string>

    <string name="num1">NO.1</string>
    <string name="num2">NO.2</string>
    <string name="num3">NO.3</string>
    <string name="num4">NO.4</string>

    <string name="btn1">Add fragment</string>
    <string name="btn2">Replace fragment</string>
    <string name="btn3">Remove fragment</string>

</resources>

程式執行截圖：

相關文章