/*
 * Copyright 2017 JessYan
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.jess.arms.base.delegate;

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

import com.jess.arms.base.BaseFragment;
import com.jess.arms.di.component.AppComponent;
import com.jess.arms.integration.cache.Cache;
import com.jess.arms.integration.cache.LruCache;

import org.simple.eventbus.EventBus;

/**
 * ================================================
 * 框架要求框架中的每个 {@link Fragment} 都需要实现此类,以满足规范
 *
 * @see BaseFragment
 * Created by JessYan on 29/04/2017 14:31
 * <a href="mailto:jess.yan.effort@gmail.com">Contact me</a>
 * <a href="https://github.com/JessYanCoding">Follow me</a>
 * ================================================
 */
public interface IFragment {

    /**
     * 提供在 {@link Fragment} 生命周期内的缓存容器, 可向此 {@link Fragment} 存取一些必要的数据
     * 此缓存容器和 {@link Fragment} 的生命周期绑定, 如果 {@link Fragment} 在屏幕旋转或者配置更改的情况下
     * 重新创建, 那此缓存容器中的数据也会被清空, 如果你想避免此种情况请使用 <a href="https://github.com/JessYanCoding/LifecycleModel">LifecycleModel</a>
     *
     * @return like {@link LruCache}
     */
    @NonNull
    Cache<String, Object> provideCache();

    /**
     * 提供 AppComponent (提供所有的单例对象) 给实现类, 进行 Component 依赖
     *
     * @param appComponent
     */
    void setupFragmentComponent(@NonNull AppComponent appComponent);

    /**
     * 是否使用 {@link EventBus}
     *
     * @return
     */
    boolean useEventBus();

    /**
     * 初始化 View
     *
     * @param inflater
     * @param container
     * @param savedInstanceState
     * @return
     */
    View initView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState);

    /**
     * 初始化数据
     *
     * @param savedInstanceState
     */
    void initData(@Nullable Bundle savedInstanceState);

    /**
     * 通过此方法可以使 Fragment 能够与外界做一些交互和通信, 比如说外部的 Activity 想让自己持有的某个 Fragment 对象执行一些方法,
     * 建议在有多个需要与外界交互的方法时, 统一传 Message, 通过 what 字段来区分不同的方法, 在 {@link #setData(Object)}
     * 方法中就可以 {@code switch} 做不同的操作, 这样就可以用统一的入口方法做多个不同的操作, 可以起到分发的作用
     * <p>
     * 调用此方法时请注意调用时 Fragment 的生命周期, 如果调用 {@link #setData(Object)} 方法时 {@link Fragment#onCreate(Bundle)} 还没执行
     * 但在 {@link #setData(Object)} 里却调用了 Presenter 的方法, 是会报空的, 因为 Dagger 注入是在 {@link Fragment#onCreate(Bundle)} 方法中执行的
     * 然后才创建的 Presenter, 如果要做一些初始化操作,可以不必让外部调用 {@link #setData(Object)}, 在 {@link #initData(Bundle)} 中初始化就可以了
     * <p>
     * Example usage:
     * <pre>
     * public void setData(Object data) {
     *     if (data != null && data instanceof Message) {
     *         switch (((Message) data).what) {
     *             case 0:
     *                 loadData(((Message) data).arg1);
     *                 break;
     *             case 1:
     *                 refreshUI();
     *                 break;
     *             default:
     *                 //do something
     *                 break;
     *         }
     *     }
     * }
     *
     * call setData(Object):
     *
     * Message data = new Message();
     * data.what = 0;
     * data.arg1 = 1;
     * fragment.setData(data);
     * </pre>
     *
     * @param data 当不需要参数时 {@code data} 可以为 {@code null}
     */
    void setData(@Nullable Object data);
}

@@ -645,24 +645,51 @@
 .os.Bundle;%0A
+import android.os.Message;%0A
 import andro
@@ -2654,23 +2654,31 @@
 %E6%B3%95%E6%97%B6, %E7%BB%9F%E4%B8%80%E4%BC%A0 
+%7B@link 
 Message
+%7D
 , %E9%80%9A%E8%BF%87 wha
@@ -3182,23 +3182,30 @@
  * %3Cpre%3E
+ %7B@code%0A
 %0A     
-*
  public 
@@ -3233,25 +3233,24 @@
 ata) %7B%0A     
-*
      if (dat
@@ -3286,33 +3286,32 @@
 Message) %7B%0A     
-*
          switch 
@@ -3337,25 +3337,24 @@
 hat) %7B%0A     
-*
             
@@ -3363,25 +3363,24 @@
 ase 0:%0A     
-*
             
@@ -3414,33 +3414,32 @@
 ta).arg1);%0A     
-*
                 
@@ -3443,33 +3443,32 @@
     break;%0A     
-*
              cas
@@ -3473,25 +3473,24 @@
 ase 1:%0A     
-*
             
@@ -3508,25 +3508,24 @@
 hUI();%0A     
-*
             
@@ -3533,33 +3533,32 @@
     break;%0A     
-*
              def
@@ -3564,25 +3564,24 @@
 fault:%0A     
-*
             
@@ -3601,25 +3601,24 @@
 ething%0A     
-*
             
@@ -3630,25 +3630,24 @@
 break;%0A     
-*
          %7D%0A 
@@ -3650,17 +3650,16 @@
  %7D%0A     
-*
      %7D%0A 
@@ -3666,25 +3666,20 @@
     
-*
  %7D%0A
+%0A
      
-*%0A     *
+ //
  cal
@@ -3702,24 +3702,16 @@
 ):%0A     
-*%0A     *
  Message
@@ -3734,25 +3734,24 @@
 age();%0A     
-*
  data.what =
@@ -3759,17 +3759,16 @@
 0;%0A     
-*
  data.ar
@@ -3780,17 +3780,16 @@
 1;%0A     
-*
  fragmen
@@ -3810,17 +3810,18 @@
 );%0A     
-*
+ %7D
  %3C/pre%3E%0A

Improve IFragment