《Android权威编程指南（The Big Nerd Ranch Guide）（第二版）》12.4挑战练习
本书第12章是讲解Dialog。12.4挑战练习是在CriminalIntent项目中，再增加一个TimePickerFragment的对话框fragment。通过在CrimeFragment用户界面上添加的时间按钮，
弹出TimePickerFragment界面，允许用户使用TimePicker组件选择crime发生的具体时间。
我的修改思路是：
- 按照DatePickerFragment实现的步骤、方法实现实现TimePickerFragment；
- crime日期与时间是一个整体：
- DatePickerFragment仅可以调整：年月日，时分不变动；
- TimePickerFragment仅可以调整：时分，时分不变动；
- 故Activity切换时，交换数据（附加到Intent上的extra数据单元共用一个Date。
具体实现如下。请各位高手拍砖。
1、使用AppCompat兼容库
依据DatePickerFragment实现方式，仍使用AppCompat兼容库。它在实现DatePickerFragment时，已经添加到CriminalIntent项目中。
2、增加、更新资源文件
2.1）增加标题：“Time of crime:”
在项目中，res\values\strings.xml增加 <string name="time_picker_title">Time of crime:</string>
即：
1 <resources> 2 ... ... 3 4 <string name="time_picker_title">Time of crime:</string> 5 </resources>
2.2）在CrimFragment界面上添加Time Button
在CrimFragment界面上显示Time Button，需要在项目中res\layout\fragment_crime.xml文件，增加下列代码：
1 <?xml version="1.0" encoding="utf-8"?> 2 <LinearLayout 3 ... ... 4 5 <Button 6 ... ... 7 /> 8 9 <Button 10 android:id="@+id/crime_time" 11 android:layout_width="match_parent" 12 android:layout_height="wrap_content" 13 android:layout_marginLeft="16dp" 14 android:layout_marginRight="16dp" 15 /> 16 17 <CheckBox 18 ... ... 19 /> 20 21 </LinearLayout>
2.3）为了保证设备旋转后仍然能正常显示
还需在项目的res\layout-land\fragment_crime.xml文件增加类似上面代码：
1 <?xml version="1.0" encoding="utf-8"?> 2 <LinearLayout 3 ... ... 4 5 <Button 6 ... ... 7 /> 8 9 <Button 10 android:id="@+id/crime_time" 11 android:layout_width="wrap_content" 12 android:layout_height="wrap_content" 13 android:layout_weight="1"/> 14 15 <CheckBox 16 ... ... 17 /> 18 19 ... ... 20 21 </LinearLayout>
3、创建新的TimePickerFragment
TimePickerFragment是DialogFragment的子类。然后，在TimePickerFragment中，创建并配置显示TimePicker组件的AlertDialog实例。TimePickerFragment同样由CrimePagerActivity托管。
3.1）使用android.support.v4.app.DialogFragment库
创建TimePickerFragment类，并设置其超类DialogFragment，由android.support.v4.app.DialogFragment库支持。
在TimePickerFragment.java中，重载DialogFragment类的onCreateDialog(Bundle savedInstanceState)方法。由托管activity的FragmentManager会调用它，在屏幕上显示DialogFragment。
onCreateDialog(Bundle savedInstanceState)方法的实现代码，创建一个带标题栏和OK按钮的AlertDialog，代码如下。注意：导入AlertDialog时，还是选择AppCompat库中的版本：android.support.v7.app.AlertDialog。
1 public class TimePickerFragment extends DialogFragment { 2 3 @Override 4 public Dialog onCreateDialog(Bundle savedInstanceState) { 5 6 return new AlertDialog.Builder(getActivity()) 7 .setTitle(R.string.time_picker_title) 8 .setPositiveButton(android.R.string.ok, null) 9 .create(); 10 } 11 }
这里类似DatePickerFragment，使用AlerDialog.Builder类，以Fluent Interface的方式创建AlertDialog实例。
3.2）显示TimeDialogFragment
同DatePickerFragment一样，TimeDialogFragment实例也是由托管activity的FragmentManager管理。使用fragment实例的public void show(FragmentManager manager, String tag)方法，将TimePickerFragment添加给FragmentManager管理并放置到屏幕上。
在CrimeFragment（CrimeFragment.java）中，也为TimePickerFragment增加一个tag常量：
1 private static final String DIALOG_TIME = "DialogTime";
然后，在onCreateView(...)方法中，添加点击时间按钮展现TimePickerFragment界面，实现mTimeButton按钮的OnClickListener监听器接口，代码：
1 public class CrimeFragment extends Fragment { 2 3 ... ... 4 private static final String DIALOG_TIME = "DialogTime"; 5 6 ... ... 7 8 mTimeButton = (Button) v.findViewById(R.id.crime_time); 9 mTimeButton.setText(DateFormat.format("h:mm a", mCrime.getDate())); 10 mTimeButton.setOnClickListener(new View.OnClickListener() { 11 @Override 12 public void onClick(View v) { 13 FragmentManager manager = getFragmentManager(); 14 TimePickerFragment timeDialog = new TimePickerFragment(); 15 timeDialog.show(manager, DIALOG_TIME); 16 } 17 }); 18 19 ... ... 20 }
这就可以显示：带标题（Time of crime:）和OK（确定）按钮的AlertDialog。
3.3）设置对话框的显示内容
同DatePickerFragment.
这时需要在TimePirckerFragment（TimePirckerFragment.java）中，使用AlertDialog.Builder的setView(...)方法， 添加TimePicker组件给AlertDialog对话框：
1 public AlertDialog.Builder setView(View view)
该方法配置对话框，实现在标题栏与按钮之间显示传入的View对象 —— TimePicker。要展示TimePicker，需要在项目工具窗口中，以TimePicker为根元素，创建名为dialog_time.xml的布局文件：
1 <?xml version="1.0" encoding="utf-8"?> 2 <TimePicker 3 xmlns:android="http://schemas.android.com/apk/res/android" 4 android:id="@+id/dialog_time_time_picker" 5 android:layout_width="match_parent" 6 android:layout_height="match_parent" 7 android:calendarViewShown="false"> 8 </TimePicker>
同时在TimePickerFragment.onCreateDialog(...)方法中，实例化DatePicker视图并添加给对话框：
1 @Override 2 public Dialog onCreateDialog(Bundle savedInstanceState) { 3 4 View v = LayoutInflater.from(getActivity()) 5 .inflate(R.layout.dialog_time, null); 6 7 return new AlertDialog.Builder(getActivity()) 8 .setView(v) 9 .setTitle(R.string.time_picker_title) 10 .setPositiveButton(android.R.string.ok, null) 11 .create(); 12 }
此时运行CriminalIntent，点击时间按钮，TimePicker就显示在对话框上。
4、数据传递
在书中例子中，DatePicker将修改的日期传递给CrimeFragment后，时间就被“清零”（时间回到0点），而时间按钮上的文字还是之前的时间。
我对DatePickerFragment进行修改，将原来
1 @Override 2 public Dialog onCreateDialog(Bundle savedInstanceState) { 3 ... ... 4 Calendar calendar = Calendar.getInstance(); 5 ... ... 6 7 return new AlertDialog.Builder(getActivity()) 8 ... ... 9 .setPositiveButton(android.R.string.ok, 10 new DialogInterface.OnClickListener() { 11 @Override 12 public void onClick(DialogInterface dialog, int which) { 13 ... ... 14 15 Date date = new GregorianCalendar(year, month, day).getTime(); 16 17 ... ... 18 } 19 } 20 ) 21 .create(); 22 }
改为：
1 @Override 2 public Dialog onCreateDialog(Bundle savedInstanceState) { 3 ... ... 4 final Calendar calendar = Calendar.getInstance(); 5 ... ... 6 7 return new AlertDialog.Builder(getActivity()) 8 ... ... 9 .setPositiveButton(android.R.string.ok, 10 new DialogInterface.OnClickListener() { 11 @Override 12 public void onClick(DialogInterface dialog, int which) { 13 ... ... 14 15 Date date = new GregorianCalendar(year, month, day, 16 calendar.get(Calendar.HOUR_OF_DAY), 17 calendar.get(Calendar.MINUTE), 18 calendar.get(Calendar.SECOND)).getTime(); 19 20 ... ... 21 } 22 } 23 ) 24 .create(); 25 }
由于在inline函数DialogInterface.OnClickListener()的onClick(...)使用到calendar，这样就要将calender定义改为final，即：
1 final Calendar calendar = Calendar.getInstance();
这样在DatePicker传递修改后的日期回CrimeFragment后，时间持不变。我认为时间的改变正是由TimePicker来完成。就是说 crime的日期（date）和时间（time）是相互关联的。基于这一思路，参考DatePickerFragment，进一步添加时间值的传递。
4.1）把crime记录的时间传递给TimePickerFragment
这就需要新建newInstance(Date)方法，然后将Date作为argument附加给fragment。
要新时间返回给CrimeFragment，且更新相应视图和模型层，这需将时间值打包为extra并附加到Intent上，然后调用CrimeFragment.onActivityResult(...)方法，并传入准备好的Intent参数。如前所属“crime的日期（date）和时间（time）是相互关联的”，Date类包含时间，这样时间extra就应该与DatePicker共用一个单元。
4.2）传递数据给TimePickerFragment
如前所述，应该用含有时间的crime Date值保存到TimePickerFragment的argument bundle中，TimePickerFragment使可直接获取到它。这样就使用DatePrickerFragment的ARG_DATE标记（tag）。为此要import ARG_DATE，即：
1 import static com.example.bigzhg.criminalintent.DatePickerFragment.ARG_DATE;
在TimePickerFragment.java中，添加newInstance(Date)方法，完成创建和设置fragment argument。
1 public class TimePickerFragment extends DialogFragment { 2 3 ... ... 4 5 public static TimePickerFragment newInstance(Date date) { 6 Bundle args = new Bundle(); 7 args.putSerializable(ARG_DATE, date); 8 9 TimePickerFragment fragment = new TimePickerFragment(); 10 fragment.setArguments(args); 11 return fragment; 12 } 13 14 ... ... 15 }
再在CrimeFragment中，用TimePickerFragment.newInstance(Date)方法替换掉TimePickerFragment的构造方法：
1 @Override 2 public View onCreateView( 3 LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 4 5 ... ... 6 7 mTimeButton.setOnClickListener(new View.OnClickListener() { 8 @Override 9 public void onClick(View v) { 10 FragmentManager manager = getFragmentManager(); 11 12 // TimePickerFragment timeDialog = new TimePickerFragment(); 13 TimePickerFragment timeDialog = TimePickerFragment 14 .newInstance(mCrime.getDate()); 15 ... ... 16 } 17 }); 18 19 ... ... 20 21 }
同DatePickerFragment一样，使用Date中的信息来初始化TimePicker对象。
在onCreateDialog(...)方法内，从argument中获取crime日期（如前所述）的对象Date对象，再创建一个Calendar对象，然后用Date对象配置它，再从Calendar对象中取回所需信息（时、分），来为TimePicker进行初始化:
1 public class TimePickerFragment extends DialogFragment { 2 3 private TimePicker mTimePicker; 4 5 ... ... 6 7 @Override 8 public Dialog onCreateDialog(Bundle savedInstanceState) { 9 Date date = (Date) getArguments().getSerializable(ARG_DATE); 10 11 Calendar calendar = Calendar.getInstance(); 12 calendar.setTime(date); 13 14 int hour = calendar.get(Calendar.HOUR_OF_DAY); 15 int minute = calendar.get(Calendar.MINUTE); 16 17 View v = LayoutInflater.from(getActivity()) 18 .inflate(R.layout.dialog_time, null); 19 20 mTimePicker = (TimePicker) v.findViewById(R.id.dialog_time_time_picker); 21 mTimePicker.setIs24HourView(false); 22 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { 23 mTimePicker.setHour(hour); 24 mTimePicker.setMinute(minute); 25 } else { 26 mTimePicker.setCurrentHour(hour); 27 mTimePicker.setCurrentMinute(minute); 28 } 29 30 return new AlertDialog.Builder(getActivity()) 31 .setView(v) 32 .setTitle(R.string.time_picker_title) 33 .setPositiveButton(android.R.string.ok, null) 34 .create(); 35 } 36 37 ... ... 38 39 }
在onCreateDialog(...)方法内，设置TimePicker是上下午（非24小时）格式：
1 mTimePicker.setIs24HourView(false);
由于我用于调试的手机时Galaxy Note II，系统为Android 4.4.2。因setCurrentHour()和setCurrentMinute()已在新系统中不再使用，故增加SDK的版本判断：
1 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { 2 mTimePicker.setHour(hour); 3 mTimePicker.setMinute(minute); 4 } else { 5 mTimePicker.setCurrentHour(hour); 6 mTimePicker.setCurrentMinute(minute); 7 }
4.3）返回时间数据给CrimeFragment
CrimeFragment接收TimePickerFragment返回的时间数据，ActivityManager 负责跟踪管理父 activity与子activity间的关系。回传数据后，子activity被销毁，而ActivityManager 知道接收数据的是哪个activity。
4.3.1）设置目标fragment
这就要将CrimeFragment设置成TimePickerFragment的目标fragment。即使是在CrimeFragment和TimePickerFragment被销毁和重建后，操作系统也会重新关联它们。调用以下Fragment方法可建立这种关联：
public void setTargetFragment(Fragment fragment, int requestCode)
在CrimeFragment.java中，增加时间请求代码常量：
1 private static final int REQUEST_TIME = 1;
然后将CrimeFragment设为TimePickerFragment实例的目标fragment：
1 timeDialog.setTargetFragment(CrimeFragment.this, REQUEST_TIME);
即：
1 public class CrimeFragment extends Fragment { 2 3 ... ... 4 private static final int REQUEST_TIME = 1; 5 6 ... ... 7 8 @Override 9 public View onCreateView( 10 LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 11 12 ... ... 13 14 mTimeButton.setOnClickListener(new View.OnClickListener() { 15 @Override 16 public void onClick(View v) { 17 ... ... 18 19 timeDialog.setTargetFragment(CrimeFragment.this, REQUEST_TIME); 20 ... ... 21 22 } 23 }); 24 25 ... ... 26 27 return v; 28 }
4.3.2）传递时间数据给目标fragment
建立CrimeFragment与TimePickerFragment间的联系后，需将数据回传给CrimeFragment。回传时间将作为extra附加给Intent。
使用TimePickerFragment类调用CrimeFragment.onActivityResult(int 请求代码, int 结果代码, Intent)方法，实现时间数据的回传。
- 请求代码：与传入setTargetFragment(...)方法相匹配，告诉目标fragment返回结果来自哪里。
- 结果代码：决定下一步该采取什么行动。
- Intent：包含extra数据。
类似DatePickerFragment类，在TimePickerFragment类中，新建sendResult(...)私有方法，创建intent并将时间数据与crime Date构成新的Date数据，作为extra附加到intent上。最后调用CrimeFragment.onActivityResult(...)方法。
再就是使用sendResult(...)私有方法。用户点按对话框中的positive（确定）按钮时，需要从TimePicker中获取时间值并回传给CrimeFragment。在onCreateDialog(...)方法中，修改setPositiveButton(...)，将null参数改DialogInterface.OnClickListener，并实现DialogInterface.OnClickListener监听器接口。在监听器接口的onClick(...)方法中，获取时间并调用sendResult(...)方法。
这里crime日期和时间一个“整体”，故公用DatePickerFragment的EXTRA_DATE:
1 import static com.example.bigzhg.criminalintent.DatePickerFragment.EXTRA_DATE;
其相关代码：
1 ... ... 2 import static com.example.bigzhg.criminalintent.DatePickerFragment.EXTRA_DATE; 3 4 5 public class TimePickerFragment extends DialogFragment { 6 7 ... ... 8 9 10 @Override 11 public Dialog onCreateDialog(Bundle savedInstanceState) { 12 ... ... 13 14 final int year = calendar.get(Calendar.YEAR); 15 final int month = calendar.get(Calendar.MONTH); 16 final int day = calendar.get(Calendar.DAY_OF_MONTH); 17 int hour = calendar.get(Calendar.HOUR_OF_DAY); 18 int minute = calendar.get(Calendar.MINUTE); 19 20 ... ... 21 22 return new AlertDialog.Builder(getActivity()) 23 .setView(v) 24 .setTitle(R.string.time_picker_title) 25 // .setPositiveButton(android.R.string.ok, null) 26 .setPositiveButton(android.R.string.ok, 27 new DialogInterface.OnClickListener() { 28 @Override 29 public void onClick(DialogInterface dialog, int which) { 30 int hour, minute; 31 32 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { 33 hour = mTimePicker.getHour(); 34 minute = mTimePicker.getMinute(); 35 } else { 36 hour = mTimePicker.getCurrentHour(); 37 minute = mTimePicker.getCurrentMinute(); 38 } 39 Date date = new GregorianCalendar( 40 year, month, day, hour, minute).getTime(); 41 sendResult(Activity.RESULT_OK, date); 42 } 43 }) 44 .create(); 45 } 46 47 private void sendResult(int relustCode, Date date) { 48 if (getTargetFragment() == null) { 49 return; 50 } 51 52 Intent intent = new Intent(); 53 intent.putExtra(EXTRA_DATE, date); 54 55 getTargetFragment().onActivityResult(getTargetRequestCode(), relustCode, intent); 56 } 57 }
这里，calendar在面谈过crime日期和时间是一个“整体”，由crime日期创建的，在TimePickerFragment保持日期值不变，仅仅运许用户调整时间。
再切换到CrimeFragment中，覆盖onActivityResult(...)方法，从extra中获取日期数据，增加“请求代码”的判断，依据“请求代码”：
- 对DatePicker值，设置对应Crime的记录日期，然后刷新日期按钮的显示；
- 对TimePIcker值，设置对应Crime的记录时间，然后刷新时间按钮的显示。
另外，同日期显示一样，为避免代码冗余，可以将时间按钮文字显示代码，封装到updateTiime()公共方法中，然后分别调用。
相关代码：
1 public class CrimeFragment extends Fragment { 2 3 ... ... 4 5 @Override 6 public View onCreateView( 7 LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 8 9 ... ... 10 11 mTimeButton = (Button) v.findViewById(R.id.crime_time); 12 updateTime(); 13 ... ... 14 15 } 16 17 @Override 18 public void onActivityResult(int requestCode, int resultCode, Intent data) { 19 if (resultCode != Activity.RESULT_OK) { 20 return; 21 } 22 23 Date date = (Date) data 24 .getSerializableExtra(DatePickerFragment.EXTRA_DATE); 25 mCrime.setDate(date); 26 27 switch (requestCode) { 28 case REQUEST_DATE: 29 updateDate(); 30 break; 31 case REQUEST_TIME: 32 updateTime(); 33 break; 34 } 35 } 36 37 private void updateDate() { 38 mDateButton.setText(DateFormat.format("EEEE, MMMM d, yyyyy", mCrime.getDate())); 39 } 40 41 private void updateTime() { 42 mTimeButton.setText(DateFormat.format("h:mm a", mCrime.getDate())); 43 } 44 }
到此，12.4的跳转练习就完成了。完整的代码在GitHub上可以找到。
请高手指点这样添加是否存在什么隐患？谢谢！
