2016年10月25日火曜日

Fragment に Toolbar を持たせるのはやめなさい

NavigationDrawer や BottomNavigation パターンを実現するために、各画面を Fragment で実装することがあります。 Fragment によって ActionBar に持たせる機能が違うからか、Fragment のレイアウトに Toolbar を持たせて、Fragment で
  1. ((AppCompatActivity) getActivity()).setSupportActionBar(toolbar);  
のような処理をさせているコードを見かけることがあります。

やめなさい

(Toolbar をただの View として使って、ActionBar としては使わない(setSupportActionBar()しない)というのであればまだ許容できるが、それならそもそも Toolbar を使う必要がない)

ViewPager のように複数の Fragment を一度に attach する場合、これでは予期しない動作になることがありえます。ちゃんと Fragment に用意されている機能を使ってください。 Fragment で setHasOptionsMenu(true) を呼ぶと onCreateOptionsMenu() が呼ばれるので、Fragment 用の Menu を inflate します。

ViewPager はこの機能を適切に処理しており、現在のページの Fragment の Menu だけ inflate されるようになっています。 また、FragmentTransaction の show() / hide() で Fragment の表示・非表示を切り替える際も OptionsMenu であれば一緒に適切に処理されます。


Fragment にこのような機能があることを知っているにもかかわらず、上記のようなひどいコードを実装してしまう要因として、Menu ではなく View を置きたいという状況があります。
よくあるのが ActionBar に検索用の入力フィールド(EditText)を持たせたい場合です。
Menu ではなく View を置きたいのだから OptionsMenu の機能は使えないと思ってしまうのでしょうか。

OptionsMenu にはこのような用途のために ActionView という機能があります。MenuItem に独自のレイアウト/Viewを設定できる機能です。 Menu リソースの item で android:actionLayout(app:actionLayout)を使ってレイアウトを指定することもできます。
また、android:actionViewClass(app:actionViewClass) で View クラスを指定することもできます。

この ActionView 用に用意されているクラスとして SearchView があります。 SearchView は ActionBar に検索用の入力フィールド(EditText)を持たせてくれるそのものずばりの機能です。文字が入力されているときにクリアボタン(xボタン)が出る機能も実装されています。 これを利用せずにわざわざ自分で実装する意味はあまりないと思いますが、独自でやりたいのであればそれ用のViewクラスを自分で用意して android:actionViewClass で指定すればよいのです。

まとめると、
  • Fragment のレイアウトに toolbar を持たせない
  • Fragment 独自の機能を ActionBar に入れたいときは OptionsMenu の機能を使う
  • OptionsMenu の機能なら ViewPager で適切に処理される
  • OptionsMenu の機能なら FragmentTransaction の show() / hide() で適切に処理される
  • OptionsMenu には独自の View を配置できる ActionView 機能がある


追記1

Toolbar の中に複雑な View を入れること自体をダメだと言っているわけではありません。 Activityのレイアウトで <android.support.v7.widget.Toolbar> に子ビュー持たせるのは別にいいと思います。 このエントリはあくまで Fragment に toolbar を持たせることについての話です。

2016年10月21日金曜日

BehaviorSubject を使って Activity と Fragment のデータの読み込みを待ち合わせる

画面構成は
  • MainActivity
    • TabLayout + ViewPager
    • ViewPagerの各ページは MainFragment
  • MainFragment
    • RecyclerView

やりたいことは
  • MainActivity
    • 各ページで共通のデータ(以後 CommonData)をサーバーから取得する
  • MainFragment
    • ページ特有のデータ(以後 SpecificData)をサーバーから取得する
    • MainActivity から CommonData をもらう
    • CommonData と SpecificData 両方の読み込みが終わったら RecyclerView にデータを追加する

キモになるのが、CommonData と SpecificData 両方の読み込みが終わるのを待ち合わせたいというところです。
CommonData の読み込みが終わる前に生成された MainFragment なら両方の読み込みを待ち合わせるし、 CommonData の読み込みが終わった後に生成された MainFragment なら SpecificData の読み込みだけ待てばいいわけです。
でも、この2つの状態をわけて処理すると煩雑になってしまいます。

そこで、BehaviorSubject を使って、CommonData の値を MainFragment 側に渡せるようにします。 BehaviorSubject は onNext() が呼ばれたときにその値を通知し、さらにその値をキャッシュします。新しく subscribe されると、最新のキャッシュした値があればその時点で通知します。

  1. public class MainActivity extends AppCompatActivity implements MainFragment.MainFragmentListener {  
  2.   
  3.     private final BehaviorSubject<CommonData> commonDataBehaviorSubject = BehaviorSubject.create();  
  4.   
  5.     @Override  
  6.     protected void onCreate(Bundle savedInstanceState) {  
  7.         super.onCreate(savedInstanceState);  
  8.         ...  
  9.   
  10.         loadCommonData();  
  11.     }  
  12.   
  13.     private void loadCommonData() {  
  14.         subscription = DataRetriever.getInstance().getCommonData()  
  15.                 .onErrorReturn(new Func1<Throwable, CommonData>() {  
  16.                     @Override  
  17.                     public CommonData call(Throwable throwable) {  
  18.                         // エラーのときはデータがないものとして扱う  
  19.                         return CommonData.empty();  
  20.                     }  
  21.                 })  
  22.                 .subscribe(new Action1<CommonData>() {  
  23.                     @Override  
  24.                     public void call(CommonData commonData) {  
  25.                         commonDataBehaviorSubject.onNext(commonData);  
  26.                     }  
  27.                 });  
  28.     }  
  29.   
  30.     @NonNull  
  31.     @Override  
  32.     public Observable<CommonData> getCommonDataObservable() {  
  33.         return commonDataBehaviorSubject;  
  34.     }  
  35. }  
  1. public class MainFragment extends Fragment {  
  2.   
  3.     public interface MainFragmentListener {  
  4.   
  5.         @NonNull  
  6.         Observable<CommonData> getCommonDataObservable();  
  7.     }  
  8.   
  9.     @Nullable  
  10.     private MainFragmentListener listener;  
  11.   
  12.     ...  
  13.   
  14.     @Override  
  15.     public void onAttach(Context context) {  
  16.         super.onAttach(context);  
  17.         if (context instanceof MainFragmentListener) {  
  18.             listener = (MainFragmentListener) context;  
  19.         }  
  20.     }  
  21.   
  22.     @Override  
  23.     public void onActivityCreated(@Nullable Bundle savedInstanceState) {  
  24.         super.onActivityCreated(savedInstanceState);  
  25.         if (adapter == null) {  
  26.             adapter = new DataAdapter();  
  27.             load();  
  28.         }  
  29.         recyclerView.setAdapter(adapter);  
  30.     }  
  31.   
  32.     void load() {  
  33.         recyclerView.setVisibility(View.GONE);  
  34.         progressView.setVisibility(View.VISIBLE);  
  35.   
  36.         // 共通データとタブ独自のデータ両方揃うまで待ち合わせ  
  37.         subscription = Observable  
  38.                 .combineLatest(  
  39.                         getCommonDataObservable(),  
  40.                         getSpecificDataObservable(),  
  41.                         new Func2<CommonData, SpecificData, Pair<CommonData, SpecificData>>() {  
  42.                             @Override  
  43.                             public Pair<CommonData, SpecificData> call(CommonData commonData, SpecificData specificData) {  
  44.                                 return new Pair<>(commonData, specificData);  
  45.                             }  
  46.                         })  
  47.                 .subscribeOn(Schedulers.newThread())  
  48.                 .observeOn(AndroidSchedulers.mainThread())  
  49.                 .subscribe(new Subscriber<Pair<CommonData, SpecificData>>() {  
  50.                     @Override  
  51.                     public void onCompleted() {  
  52.                     }  
  53.   
  54.                     @Override  
  55.                     public void onError(Throwable e) {  
  56.                         recyclerView.setVisibility(View.VISIBLE);  
  57.                         progressView.setVisibility(View.GONE);  
  58.                     }  
  59.   
  60.                     @Override  
  61.                     public void onNext(Pair<CommonData, SpecificData> combinedData) {  
  62.                         recyclerView.setVisibility(View.VISIBLE);  
  63.                         progressView.setVisibility(View.GONE);  
  64.   
  65.                         final List<String> list = new ArrayList<>();  
  66.   
  67.                         final CommonData commonData = combinedData.first;  
  68.                         list.add("CommonData : " + (commonData.isEmpty() ? "empty" : commonData.getData()));  
  69.   
  70.                         final SpecificData specificData = combinedData.second;  
  71.                         list.addAll(specificData.getData());  
  72.   
  73.                         adapter.addAll(list);  
  74.                     }  
  75.                 });  
  76.     }  
  77.   
  78.     /** 
  79.      * 共通のデータを取得 
  80.      */  
  81.     private Observable<CommonData> getCommonDataObservable() {  
  82.         return listener != null  
  83.                 // first() を介して onComplete()が呼ばれるようにしている  
  84.                 ? listener.getCommonDataObservable().first()   
  85.                 : Observable.just(CommonData.empty());  
  86.     }  
  87.   
  88.     /** 
  89.      * このタブ独自のデータを取得 
  90.      */  
  91.     private Observable<SpecificData> getSpecificDataObservable() {  
  92.         final int position = getArguments() == null ? -1 : getArguments().getInt(ARGS_POSITION);  
  93.         return DataRetriever.getInstance().getSpecificData(position);  
  94.     }  
  95.   
  96.     ...  
  97. }  


さらに、MainActivity に SwipeRefreshLayout を追加して、PullToRefresh で共通データを取り直し、各 MainFragment にもデータを取り直させる処理を追加したサンプルが
https://github.com/yanzm/BehaviorSubjectSample
です。