5、Adding a fragment without a UI
上面的例子是如何添加fragment到activity中以便提供一个UI。然而，你也可以利用fragment提供后台处理而不需要展现UI。
为了添加没有UI的fragment，可以利用add(Fragment,String)方法从activity添加一个fragment(提供一个唯一的字符串“tag”而不是一个视图ID)。这种方法添加了这个fragment但是由于没有跟activity布局的view关联，不需要接收对onCreateView()的调用，因此不需要实现该方法。
为fragment提供字符串tag的方式并不只适合于非UI Fragment，你也可以为有UI的fragment提供字符串tag，但如果没有UI，只有这一种方式来指定。如果想在activity中获取这个fragment，可以利用findFragmentByTag()方法。
以fragment作为后台处理者的例子可以参考FragmentRetainInstance.java。
6、Managing Fragments
为了在activity中管理fragments，你需要利用FragmentManager。从activity中调用getFragmentManager()方法获取。利用FragmentManager可以做以下事情：
- 获取已经在activity中存在的fragments，利用findFragmentById()来获取在activity布局中提供一个UI的fragments，利用findFragmentByTag()来获取不提供UI的fragments。
- 利用popBackStack()方法从回栈中弹出fragments
- 利用addOnBackStackChangeListener()方法为回栈的变化注册一个监听 器
要查看这些方法更详细的信息，可以查看FragmentManager的文档。除了上面提到的，还有通过FragmentManager开启一个FragmentTransaction，用于执行像add和remove的事务。
7、Performing Fragment Transactions
在activity中使用fragments的最大特性是能够add、remove、replace以及执行与之有关的操作，响应用户的交互。提交到activity的每个变化集称为事务，可以利用FragmentTransaction的API来执行事务。你也可以保存每个事务到由activity管理的回栈中，可以通过fragments的改变来导航回上一个fragment。
可以像下面这样从FragmentManager获取FragmentTransaction的实例：
FragmentManager fragmentManager = getFragmentManager();
FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();每个事务是你想在同一时间执行的变化集。你可以通过add()、remove()和replace()方法为给定的事务设置所有的变化，然后应用这个事务到activity，记住，必须调用commit();
然而，在你调用commit()之前，你可能会调用addToBackStack()方法，以便添加该事务到fragment事务的回栈中，这个回栈由activity管理并且允许用户通过回退按钮回到上一个fragment状态。
例如：下面是你如果用一个fragment代替另一个，并且在回栈中保留上一个状态。
// Create new fragment and transaction
Fragment newFragment = newExampleFragment();
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();如果你添加多个变化到事务中(例如add()或remove()然后调用addToBackStack())，这时，在调用commit()使所有变化都生效之前，这些变化作为一个单独的事务都被加入到回栈中，按回退按钮会使得所有的一起回退。
添加变化到FragmentTransaction中的顺序并不重要，除非：
- 必须最后调用commit()
- 如果你添加多个fragments到同一个容器，这时你添加到容器中的顺序决定了在视图中展示的顺序。
当执行remove一个fragment事务时没有调用addToBackStack()方法，那么当事务commit时这个fragment就会被销毁，所有用户不能再返回到这个fragment。如果当remove一个fragment时调用addToBackStack()，那么这个fragment会停止并且当用户回退时恢复该fragment。
提示：对于每个fragment事务，可以在commit之前调用setTransition()来应用一个事务动画。
调用commit()不会立即执行该事务。而是在activity的UI线程中调度执行，只要这个线程具备条件可以处理。如果必要，在执行commit()后，可以从UI线程中调用executePendingTransaction()方法立即执行该事务。这样做通常是没有必要的，除非这个事务依赖与其他线程工作。
注意：你只有在activity保存其状态之前调用commit()提交事务(当用户离开当前activity)。如果你试图在这个点后提交事务，就会报异常。这是因为如果需要恢复这个activity，提交之后的状态会被丢弃。这种情况下，可以利用commitAllowingStateLoss()方法丢弃提交。
8、Communicating with the Activity
一个Fragment可以作为独立于Activity的对象实现，并且可以在多个activity中使用，一个给定的fragment实例可以直接与包含它的activity建立联系。
具体来说，fragment可以通过getActivity()访问Activity实例，以及在activity布局中执行例如查找一个视图的任务。
View listView = getActivity().findViewById(R.id.list);ExampleFragment fragment = (ExampleFragment) getFragmentManager()
.findFragmentById(R.id.example_fragment);9、Creating event callbacks to the activity
在一些情况下，你可能需要一个fragment来与activity共享事件。一个好的方法就是在fragment内部定义一个回调接口并且要求主activity实现它。当这个activity通过而过接口接收一个回调时，就可以与布局中的其他fragments共享信息。
例如：如果新闻应用程序在一个activity中有两个fragments，一个是显示文章的列表(fragment A)另一个是显示这篇文章(fragment B)。这时fragment A必须告诉activity什么时间列表项被选中以至于可以告诉fragment B显示这篇文章。这种情况下，OnArticleSelectedListener接口声明在fragment A中。
publicstatic class FragmentA extendsListFragment {
...
// Container Activity must implement this interface
publicinterface OnArticleSelectedListener {
publicvoid onArticleSelected(Uri articleUri);
}
...
}publicstatic class FragmentA extendsListFragment {
OnArticleSelectedListener mListener;
...
@Override
publicvoid onAttach(Activity activity) {
super.onAttach(activity);
try{
mListener = (OnArticleSelectedListener) activity;
}catch(ClassCastException e) {
thrownew ClassCastException(activity.toString()
+" must implement OnArticleSelectedListener");
}
}
...
}publicstatic class FragmentA extendsListFragment {
OnArticleSelectedListener mListener;
...
@Override
publicvoid onListItemClick(ListView l, View v, intposition, longid) {
// Append the clicked item's row ID with the content provider Uri
Uri noteUri = ContentUris.withAppendedId(ArticleColumns.CONTENT_URI, id);
// Send the event and Uri to the host activity
mListener.onArticleSelected(noteUri);
}
...
}10、Adding items to the Action Bar
你的fragments可以为activity的Options Menu添加菜单项，通过实现onCreateOptionsMenu()方法。为了保证这个方法被调用，你必须在onCreate()中调用setHasOptionMenu()方法，以标识该fragment支持将菜单项添加到Options Menu中(否则 fragment不会接收onCreateOptionsMenu()的调用)。
从fragment中添加到Options Menu的任何项都是附加到一个已存在的菜单项中。当菜单项被选中时，这个fragment也能接收onOptionsItemSelected()回调方法。
你也可以在fragment布局中注册一个view来提供上下文菜单，通过调用registerForContextMenu()方法。当用户开启上下文菜单时，fragment接收onCreateContextMenu()方法的调用。当用户选择上下文菜单中的一项，fragment接收到onContextItemSelected()方法的调用。
注意：虽然你的fragment接收每个菜单项的on-item-selected调用，当用户选择一项时，activity首先接收这个调用。如果activity对on-item-selected的实现不能处理这个选择项，这时这个事件就被传递到fragments的回调中。这个在Options Menu和上下文meuns中都是对的。
11、Handling the Fragment Lifecycle
对fragment的生命周期管理有点像activity的生命周期管理，一个fragment可以三种状态存在。
- Resumed: fragment在运行的activity中可见。
- Paused:另一个activity在前台并获有焦点，但是fragment所在的activity仍然可见(前台的activity部分透明或不能完全覆盖整个屏幕)。
- Stopped: fragment不可见。主activity已经停止或是fragment已经从activity中移除放到回栈里。一个停止的fragment仍然活着的(所有的状态和成员信息由系统保留)，然而，不再对用户可见并且当activity销毁时被销毁。
如下图所示：
跟activity类似，当activity的进程并杀掉时，你可以利用一个Bundle来保留fragment的状态，并且当activity重建时来恢复fragment的状态。你可以在fragment的onSaveInstanceState()回调方法中保存状态，在onCreate()、onCreateView()或onActivityCreated()中恢复状态。
在activity与fragment之间生命周期最显著的区别是如何在各自的回栈中存储。一个activity当停止时默认被放置在有系统管理的activity的回栈中。然而，一个fragment在执行remove一个fragment事务时，显式调用addToBackStack()方法来保存该实例时别存储在由主activity管理的回栈中。
由于管理fragment的生命周期与管理activity生命周期非常相像，因此管理activity生命周期的实践同样适用于fragment，另外，你需要理解的是，activity的生命周期是如何影响fragment的生命周期的。
12、Coordinating with the activity lifecycle
fragment所在activity的生命周期直接影响该fragment的生命周期。使得activity的每个生命周期回调结果在每个fragment的类似回调中。例如，当activity接收onPause()，activity中的每个fragment也接收onPause().
fragments还有一些额外的生命周期回调函数。然而，这些将处理与activity唯一的交互，为了执行例如构建和销毁fragment的UI操作。这些额外的回调方法有：
onAttach():当fragment已经与activity建立关联时调用。
onCreateView():创建一个新的view层级来与fragment关联。
onActivityCreated():当activity的onCreate()方法已经返回时调用。
onDestroyView():当与fragment关联的view层级被移除时调用。
onDetach():当fragment与activity脱离关联时调用。
被主activity影响的fragment生命周期流在上图中展示了，在这个图中，你可以看到activity的每个连续状态决定了fragment接收那个回调方法。例如，当activity接收了onCreate()回调，activity中的一个fragment只能接收onActivityCreate()回调。
一旦activity到达了resumed状态，你可以自由的在activity中添加和移除fragment。这样，只有当activity在resumed状态时，fragment的生命周期才能独立的改变。
然而，当activity离开resumed状态时，fragment再一次通过生命周期被activity拽回。
13、Example
为了在本章能够谈论更多东西，下面的activity的例子展示利用两个fragment创建两个面板的布局。一个fragment用于展示Shakespeare播放标题的列表，另一个展示每个播放的概要当选中一项时。并且也描述了如何基于屏幕的配置提供不同的fragment的配置。
这个主activity在onCreate()中以通用的方式应用一个布局。
@Override
protectedvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.fragment_layout);
}然而，并不是所有的屏幕配置都足够宽来同时并排显示播放列表和概要。因此上面的布局只能用于宽屏配置，通过在res/layout-land/fragment_layout.xml中保存。
这样，当屏幕在纵向方向时，系统应用保存在res/layout/fragment_layout.xml的布局。
<FrameLayoutxmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"android:layout_height="match_parent">
<fragment
android:id="@+id/titles"
android:layout_width="match_parent"android:layout_height="match_parent"/>
</FrameLayout>接下来，分析如何在fragment类中完成这些工作。首先是TitlesFragment，用于显示播放标题列表。这个fragment扩展了ListFragment并通过它处理大部分列表视图工作。
当你检查这个代码，当用户点击列表项时有两种可能的行为，这取决于两个布局中哪个处于活动状态，他可以在同一个activity中创建并展示一个新的fragment用于显示详细信息(添加fragment到FrameLayout)或者启动一个新的activity(fragment可以在此显示)。
publicstatic class TitlesFragment extendsListFragment {
booleanmDualPane;
intmCurCheckPosition = 0;
@Override
publicvoid onActivityCreated(Bundle savedInstanceState) {
super.onActivityCreated(savedInstanceState);
// Populate list with our static array of titles.
setListAdapter(newArrayAdapter(getActivity(),
android.R.layout.simple_list_item_activated_1, Shakespeare.TITLES));
// Check to see if we have a frame in which to embed the details
// fragment directly in the containing UI.
View detailsFrame = getActivity().findViewById(R.id.details);
mDualPane = detailsFrame != null&& detailsFrame.getVisibility() == View.VISIBLE;
if(savedInstanceState != null) {
// Restore last state for checked position.
mCurCheckPosition = savedInstanceState.getInt("curChoice",0);
}
if(mDualPane) {
// In dual-pane mode, the list view highlights the selected item.
getListView().setChoiceMode(ListView.CHOICE_MODE_SINGLE);
// Make sure our UI is in the correct state.
showDetails(mCurCheckPosition);
}
}
@Override
publicvoid onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
outState.putInt("curChoice", mCurCheckPosition);
}
@Override
publicvoid onListItemClick(ListView l, View v, intposition, longid) {
showDetails(position);
}
/**
* Helper function to show the details of a selected item, either by
* displaying a fragment in-place in the current UI, or starting a
* whole new activity in which it is displayed.
*/
voidshowDetails(intindex) {
mCurCheckPosition = index;
if(mDualPane) {
// We can display everything in-place with fragments, so update
// the list to highlight the selected item and show the data.
getListView().setItemChecked(index,true);
// Check what fragment is currently shown, replace if needed.
DetailsFragment details = (DetailsFragment)
getFragmentManager().findFragmentById(R.id.details);
if(details == null|| details.getShownIndex() != index) {
// Make new fragment to show this selection.
details = DetailsFragment.newInstance(index);
// Execute a transaction, replacing any existing fragment
// with this one inside the frame.
FragmentTransaction ft = getFragmentManager().beginTransaction();
ft.replace(R.id.details, details);
ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE);
ft.commit();
}
}else{
// Otherwise we need to launch a new activity to display
// the dialog fragment with selected text.
Intent intent = newIntent();
intent.setClass(getActivity(), DetailsActivity.class);
intent.putExtra("index", index);
startActivity(intent);
}
}
}publicstatic class DetailsFragment extendsFragment {
/**
* Create a new instance of DetailsFragment, initialized to
* show the text at 'index'.
*/
publicstatic DetailsFragment newInstance(intindex) {
DetailsFragment f = newDetailsFragment();
// Supply index input as an argument.
Bundle args = newBundle();
args.putInt("index", index);
f.setArguments(args);
returnf;
}
publicint getShownIndex() {
returngetArguments().getInt("index",0);
}
@Override
publicView onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
if(container == null) {
// We have different layouts, and in one of them this
// fragment's containing frame doesn't exist. The fragment
// may still be created from its saved state, but there is
// no reason to try to create its view hierarchy because it
// won't be displayed. Note this is not needed -- we could
// just run the code below, where we would create and return
// the view hierarchy; it would just never be used.
returnnull;
}
ScrollView scroller = newScrollView(getActivity());
TextView text = newTextView(getActivity());
intpadding = (int)TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,
4, getActivity().getResources().getDisplayMetrics());
text.setPadding(padding, padding, padding, padding);
scroller.addView(text);
text.setText(Shakespeare.DIALOGUE[getShownIndex()]);
returnscroller;
}
}回想TitleFragment类，如果用户点击列表项并且当前布局不包含R.id.detail视图(包含DetailsFragment)，这时应用程序启动DetailsActivity来显示列表项的内容。
下面是DetatilsActivity,简单的嵌入到DetailsFragment中当屏幕为纵向方向时显示选择的播放概要。
publicstatic class DetailsActivity extendsActivity {
@Override
protectedvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
if(getResources().getConfiguration().orientation
== Configuration.ORIENTATION_LANDSCAPE) {
// If the screen is now in landscape mode, we can show the
// dialog in-line with the list so we don't need this activity.
finish();
return;
}
if(savedInstanceState == null) {
// During initial setup, plug in the details fragment.
DetailsFragment details = newDetailsFragment();
details.setArguments(getIntent().getExtras());
getFragmentManager().beginTransaction()
.add(android.R.id.content, details).commit();
}
}
}
2673
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
