乐趣区

关于android:全新的Fragment通信方式

前言

就在前段时间,Google 推出了 Fragment Result API 和 Activity Results API,用来取代之前的 Activity 和 Fragment 之间通信形式的有余,大家能够返回看看都有那些更新:
https://medium.com/androiddev…

通过 Fragment Result API 进行 Fragment 间数据传递:

发送数据

@Override
@NonNull
public final @Override void setFragmentResult(@NonNull String requestKey, @NonNull Bundle result)

如果 FragmentB 发送数据给 FragmentA,须要在 FragmentA 中注册 listener,通过 parent FragmentManager 发送数据

数据接管:

@Override
@NonNull
public final @Override void setFragmentResultListener(
    @NonNull String requestKey,
    @NonNull LifecycleOwner lifecycleOwner,
    @NonNull FragmentResultListener listener
)

如果想在 Fragment 中承受数据,能够在 FragmentManager 中注册一个 FragmentResultListener,参数 requestKey 能够过滤掉 FragmentManager 发送的数据

setFragmentResultListener 为给定的 requestKey 设置了 ResultListener。一旦给定的 LifecycleOwner 至多处于 STARTED 状态,setFragmentResult 应用雷同的 requestKey 设置的任何后果都将传递给回调。回调将放弃活动状态,直到 LifecycleOwner 达到 DESTROYED 状态或应用雷同的 requestKey 调用 clearFragmentResultListener。

时序图剖析:

能够通过简化后的时序图来剖析 lifecycle 状态和 fragment 设置监听的程序:

  • 如果监听 Fragment 的生命周期,您能够在接管到新数据时平安地更新 UI,因为 view 的创立(onViewCreated() 办法在 onStart() 之前被调用)。

  • 当生命周期处于 LifecycleOwner STARTED 的状态之前,如果有多个数据传递,只会接管到最新的值:

  • 当生命周期处于 LifecycleOwner DESTROYED 时,它将主动移除 listener,如果想手动移除 listener,须要调用 FragmentManager.setFragmentResultListener() 办法,传递空的 FragmentResultListener

从时序图很显著能够总体剖析出流程来,大抵是在 FragmentManager 中注册 listener,依赖于 Fragment 发送返回的数据。

不同层级关系的 Fragment 数据传递

个别 fragment 数据传递波及到不同层级间的传递,次要分为上面两种:

父子层级的两个 Fragment 数据传递

如果在 FragmentA 中承受 FragmentB 发送的数据,FragmentA 是 FragmentB 的父容器,他们通过 child FragmentManager 进行通信

childFragmentManager.setFragmentResultListener(...)

留神 listener 必须设置的 Fragment 须要用到雷同的 FragmentManager。

雷同层级的两个 Fragment 数据传递

如果在 FragmentA 中承受 FragmentB 发送的数据,FragmentA 和 FragmentB 处于雷同的层级,通过 parent FragmentManager 进行通信,FragmentA 必须应用 parent FragmentManager 注册 listener

parentFragmentManager.setFragmentResultListener(...)

源码解析

不同于之前旧的 Target Fragment Api,能够看到这里将监听器和 fragment 的 lifecycle 进行绑定,这样将带来以下长处:

  • 在 Fragment 之间传递数据,不会持有对方的援用
  • 当生命周期处于 ON_START 时开始解决数据,防止当 Fragment 处于不可预知状态的时,可能产生未知的问题
  • 当生命周期处于 ON_DESTROY 时,移除监听

那让咱们更进一步看下,fragment 和它的 lifecycle 是如何进行数据监听的绑定和解绑的呢:

    @Override
    public final void setFragmentResultListener(@NonNull final String requestKey,
                                                @NonNull final LifecycleOwner lifecycleOwner,
                                                @NonNull final FragmentResultListener listener) {final Lifecycle lifecycle = lifecycleOwner.getLifecycle();
        //destroyed 则间接返回
        if (lifecycle.getCurrentState() == Lifecycle.State.DESTROYED) {return;}

        LifecycleEventObserver observer = new LifecycleEventObserver() {
            @Override
            public void onStateChanged(@NonNull LifecycleOwner source,
                                       @NonNull Lifecycle.Event event) {
                // 在 start 的时候进行办法调用
                if (event == Lifecycle.Event.ON_START) {
                    // 一旦出于 start 状态,查看任何存储后果
                    Bundle storedResult = mResults.get(requestKey);
                    if (storedResult != null) {
                        // 如果查问的后果不为空,则触发回调
                        listener.onFragmentResult(requestKey, storedResult);
                        // 革除后果
                        clearFragmentResult(requestKey);
                    }
                }

                //destroy 则移除监听
                if (event == Lifecycle.Event.ON_DESTROY) {lifecycle.removeObserver(this);
                    mResultListeners.remove(requestKey);
                }
            }
        };

能够看到下面代码做了:

  • 获取 Lifecycle 去监听 Fragment 的生命周期的变动
  • 当生命周期处于 ON_START 时开始解决数据,防止当 Fragment 处于不可预知状态的时,可能产生未知的问题
  • 当生命周期处于 ON_DESTROY 时,移除监听
  • 当生命周期处于 DESTROYED 则间接返回不作解决

看过承受数据如何做的,上面再看下如何发送数据的:

    @Override
    public final void setFragmentResult(@NonNull String requestKey, @NonNull Bundle result) {
        // 查看是否有监听器去监听 requestkey 后果
        FragmentManager.LifecycleAwareResultListener resultListener = mResultListeners.get(requestKey);
        // 如果生命周期 started,则触发回调
        if (resultListener != null && resultListener.isAtLeast(Lifecycle.State.STARTED)) {resultListener.onFragmentResult(requestKey, result);
        } else {
            // 否则 保留以后传输数据 result
            mResults.put(requestKey, result);
        }
    }
  • 获取 requestKey 注册的 listener
  • 当生命周期处于 STARTED 状态时,开始发送数据
  • 否则保留以后传输的数据

看完源码简略分享,那么再来看下 fragment 间通信还有哪些其余办法?

Fragment 中的通信形式还有哪些

通过应用 findFragmentById 或关联 Activity 获取 Fragment 的实例,而后调用 Fragment 的公共办法:

  • 第一步在被调用的 MainFragment 注册公共办法

      //MainFragment.java 文件中
      public void setData(List<String> dataList) {adapter.set(dataList);
      }
  • 第二步 在被动调用的 Fragment 中关联 activity 并获取到 MainFragment 后,调用公共办法

      //MenuFragment.java 文件中
      lv.setOnItemClickListener(new AdapterView.OnItemClickListener() {
          @Override
          public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
              MainFragment mainFragment =
                      (MainFragment) getActivity()
                              .getSupportFragmentManager()
                              .findFragmentByTag("mainFragment");
              mainFragment.setData(mDataList.get(position));
          }
      });
  • 毛病: Fragment 之间不应该间接通信 参考
    https://developer.android.com…

接口回调的形式进行 fragment 间数据传递:

  • step1: 在 Menuragment 中创立一个接口以及接口对应的 set 办法:

      //MainFragment.java 文件中
      public interface OnDataTransferListener {public void dataTransfer(List<String> dataList);
      }
      public void setOnDataTransferListener(OnDataTransferListener mListener) {this.mListener = mListener;}
  • step2: 在 MenuFragment 中的 ListView 条目点击事件中进行接口进行接口回调

      //MenuFragment.java 文件中
      lv.setOnItemClickListener(new AdapterView.OnItemClickListener() {
          @Override
          public void onItemClick(AdapterView<?> parent, View view, int position, long id) {if (mListener != null) {mListener.dataTransfer(mDataList.get(position));
              }
          }
      });
  • step3: 在 MainActivity 中依据 menuFragment 获取到接口的 set 办法,在这个办法中进行进行数据传递,具体如下:

      // 在 MainActivity 中
    menuFragment.setOnDataTransferListener(new MenuFragment.OnDataTransferListener() {
          @Override
          public void dataTransfer(List<String> data) {mainFragment.setData(data);
          }
      });
  • 毛病: 绝对 Result API 更简单,具体能够参考官网文档
    https://developer.android.com…

通过 Target Fragment APIs (Fragment.setTargetFragment() & Fragment.getTargetFragment())办法进行 Fragment 间数据传递:

征引 Google 官网的阐明:

Fragment.setTargetFragment()

Use case = 2 fragments hosted by the same activity.

Where startActivityForResult() establishes a relationship between 2 activities, setTargetFragment() defines the caller/called relationship between 2 fragments.

setTargetFragment(target) lets the “called” fragment know where to send the result. onActivityResult() is called manually in this case.

通过上面的伪代码能够示意出调用关系:

public class Caller extends Fragment

     Fragment called = Called.newInstance()

     called.setTargetFragment(this)
public class Called extends DialogFragment

   intent = amazingData

   getTargetFragment().onActivityResult(  getTargetRequestCode(),,intent  )

简而言之,假如 Fragment A 跳转 B 在 B 中做一些操作之后,想把这些操作回传给 A
Fragment 中存在 startActivityForResult()以及 onActivityResult()办法,但没有 setResult()办法,用于设置返回的 intent,这样咱们就须要通过调用 getActivity().setResult(ListTitleFragment.REQUEST_DETAIL, intent);

这种办法有形当中减少了两个 Fragment 与 Activity 的耦合度
所以,就有了 setTargetFragment()办法
在启动 B 的时候,能够调用 B.setTargetFragment(A,int t) 将 AB 关联起来,
而后在 B 的代码中调用
getTargetFragment().onActivityResult() 将数据回传给 A

  • 毛病: 该办法目前曾经被谷歌官网所废除,Target fragment 须要间接拜访另一个 fragment 的实例,这是非常危险的,因为不晓得指标 fragment 处于什么状态;

通过 ViewModel 容器进行 Fragment 间数据传递:

Activity 中的两个或更多 Fragment 须要互相通信是一种很常见的景象。设想一下拆分视图 (list-detail) Fragment 的常见状况,假如您有一个 Fragment,在该 Fragment 中,用户从列表中抉择一项,还有另一个 Fragment,用于显示选定项的内容。这种状况不太容易解决,因为这两个 Fragment 都须要定义某种接口形容,并且所有者 Activity 必须将两者绑定在一起。此外,这两个 Fragment 都必须解决另一个 Fragment 尚未创立或不可见的状况。

能够应用 ViewModel 对象解决这一常见的难点。这两个 fragment 能够应用其 activity 范畴共享 ViewModel 来解决此类通信,如以下示例代码所示:

public class SharedViewModel extends ViewModel {private final MutableLiveData<Item> selected = new MutableLiveData<Item>();

    public void select(Item item) {selected.setValue(item);
    }

    public LiveData<Item> getSelected() {return selected;}
}

public class ListFragment extends Fragment {
    private SharedViewModel model;

    public void onViewCreated(@NonNull View view, Bundle savedInstanceState) {super.onViewCreated(view, savedInstanceState);
        model = new ViewModelProvider(requireActivity()).get(SharedViewModel.class);
        itemSelector.setOnClickListener(item -> {model.select(item);
        });
    }
}

public class DetailFragment extends Fragment {public void onViewCreated(@NonNull View view, Bundle savedInstanceState) {super.onViewCreated(view, savedInstanceState);
        SharedViewModel model = new ViewModelProvider(requireActivity()).get(SharedViewModel.class);
        model.getSelected().observe(getViewLifecycleOwner(), item -> {// Update the UI.});
    }
}

请留神,这两个 Fragment 都会检索蕴含它们的 Activity。这样,当这两个 Fragment 各自获取 ViewModelProvider 时,它们会收到雷同的 SharedViewModel 实例(其范畴限定为该 Activity)。

此办法具备以下劣势:
Activity 不须要执行任何操作,也不须要对此通信有任何理解。
除了 SharedViewModel 约定之外,Fragment 不须要相互了解。如果其中一个 Fragment 隐没,另一个 Fragment 将持续照常工作。
每个 Fragment 都有本人的生命周期,而不受另一个 Fragment 的生命周期的影响。如果一个 Fragment 替换另一个 Fragment,界面将持续工作而没有任何问题。

总结

尽管应用了 Fragment result APIs,替换了过期的 Fragment target APIs,然而新的 APIs 在 Bundle 作为数据传传递方面有一些限度,只能传递简略数据类型、Serializable 和 Parcelable 数据,Fragment result APIs 容许程序从解体中复原数据,而且不会持有对方的援用,防止当 Fragment 处于不可预知状态的时,可能产生未知的问题。

综合以上通信形式,那么你认为 Fragment 之间通信最好的形式是什么?

❤️/ 感激反对 /

以上便是本次分享的全部内容,心愿对你有所帮忙 ^_^

喜爱的话别忘了 分享、点赞、珍藏 三连哦~

欢送关注公众号 程序员巴士,来自字节、虾皮、招银的三端兄弟,分享编程教训、技术干货与职业规划,助你少走弯路进大厂。

退出移动版