前言

 欢迎使用 Flyabbit  ? 全家桶

FMVP: 快速开发的 MVP 框架,开箱即用

模块	FMVP	FMVP AS插件
最新版本

特点:

MVP更加简单实用,网络,缓存,数据库开箱即用
degger2 ,util….每个Modle中提供了XXDiHelper 快速使用AOP依赖注入,一键注入你想要的
rxjava,retrofit让网络请求线程切换赢在起跑线上
使用ARouter路由解耦跳转更加灵活
base中封装了懒加载的BaseFragment,BaseActivity,满足你日常开发的各种动作和姿势
room,MemoryCache,SPHelper和RxCache提供了强大的网络请求和缓存功能

快速使用

使用方法一:IDEA 插件(推荐)

IDE插件安装:
1. File->Setting->Plugins->搜索componentPlugin(或者下载)
  ,安装完后重启Andriod Studio
2. 在对应的目录下 -> new -> FMVP-File,填写模块名称
  
  注意:考虑到mvp模板路径的正确性，对模板生成的路径有限制（只有在Moudle下的java路径下才能生效），更好的引导大家使用

初始化Appliction并在AndroidManifest中注册为启动类

public class SampleApp extends BaseApplication {

    @Override
    public void onCreate() {
        super.onCreate();
             //todo
         }
    }

填写 M-V-P 代码逻辑代码

定义 Api:

public interface Api {

        String baseURL= "http://gank.io/api/";//配置 baseurl也可以在NetConfit 中配置
        @GET("random/data/福利/{num}")//还有不懂Retrofit的同学请看这里 https://blog.csdn.net/chengzichen_/article/details/77840996
        Flowable<SampleApiResponse<List<GankItemBean>>>     getRandomGirl(@Path("num") int num);

}

定义Contract接口:

public interface INetTestContract {

interface IView<T> extends IBaseView {

    void success(T data);

    void failure(String code, String msg);
}

interface IPresenter extends IBasePresenter<IView> {

    void getRandomGirl();//or  todo   自己填写的逻辑

}

interface IModel extends IBaseModel {

    Flowable<SampleApiResponse<List<GankItemBean>>> getRandomGirl();//or  todo  自己填写的逻辑

     }
}

分别实现model和 presenter

moudel示例:

public class NetTestRemoteDataService  implements INetTestContract.IModel {

private HttpHelper mHttpHelper;

@Inject
public NetTestRemoteDataService(HttpHelper httpHelper) {
    this.mHttpHelper = httpHelper;
}


@Override
public Flowable<SampleApiResponse<List<GankItemBean>>> getRandomGirl() {
    return mHttpHelper.createApi(Api.class).getRandomGirl(1).compose(RxUtil.<SampleApiResponse<List<GankItemBean>>>rxSchedulerHelper());
}

}

presenter示例

    public class NetTestPresenter extends XPresenter<INetTestContract.IView> implements INetTestContract.IPresenter {

private NetTestRemoteDataService mNetTestRemoteDataService;

@Inject
public NetTestPresenter(NetTestRemoteDataService NetTestRemoteDataService) {
    mNetTestRemoteDataService = NetTestRemoteDataService;
}


@Override
public void getRandomGirl() {
    mNetTestRemoteDataService.getRandomGirl()
            .compose(getV().<SampleApiResponse<List<GankItemBean>>>bindLifecycle())
            .subscribe(new SampleSubscriber<SampleApiResponse<List<GankItemBean>>>(new SampleSubscriberListener<List<GankItemBean>>() {
                @Override
                public void onSuccess(List<GankItemBean> response) {
                    getV().success(response);
                }

                @Override
                public void onFail(NetError errorMsg) {
                    super.onFail(errorMsg);
                    getV().failure("-1", errorMsg.getMessage());
                }
            }));
     }
}

使用 Dagger2注入对象

在ActivityComponent或者FragmentComponent中(/di/component/)定义需要注入的对象和方法:

void inject(XXXXActivity xxxxActivity);

在 Fragment 或者 Activity 中使用

public class NetSampleActivity extends XDaggerActivity<NetTestPresenter> implements INetTestContract.IView<List<GankItemBean>> {


    @Override
    public int getLayoutId() {
        return R.layout.activity_net_sample;
    }

    @Override
    public void initEventAndData(Bundle savedInstanceState) {
       mPresenter.getRandomGirl();//调用方法请求接口
    }


    @Override
    public void initInject(Bundle savedInstanceState) {
        DiHelper.getActivityComponent(getActivityModule()).inject(this);
    }

    @Override
    public void success(List<GankItemBean> data) {
        //todo
    }

    @Override
    public void failure(String code, String msg) {
        //todo
    }
}

注意: 上面所列出的代码基本都有生成,都只需填充逻辑代码就可以了.

使用方法二: 不使用插件,单独使用

Step 1. 在根目录的gradle文件中配置

allprojects {
        repositories {
            ...
             jcenter()
        }
    }

step2 添加依赖(By 3.0):

dependencies {
       api 'com.dhc.lib:mvp:1.0.6'
       annotationProcessor "com.google.dagger:dagger-compiler:2.13"//dagger2注解
        annotationProcessor "com.alibaba:arouter-compiler:1.1.2.1"// arouter 注解
}

step3 项目中使用

步骤与上述一样,只不过需要手动实现代码,而IDE插件见过了这一过程.

使用依赖:

fragmentation :强大的Framgment支持库,如同Activity一样使用
rxjava,rxandroid :这个不用说了,强大的链式编程线程调度库
rxlifecycle : Lifecycle handling APIs for Android apps using RxJava
gson,retrofit,okhttp3,okhttp3-logging-interceptor… 网络请求框架整合
rxpermissions Android runtime permissions powered by RxJava2
RxCache Reactive caching library for Android and Java
PersistentCookieJar A persistent CookieJar implementation for OkHttp 3 based on SharedPreferences.
dagger2 A fast dependency injector for Android and Java.
arouter Android平台中对页面、服务提供路由功能的中间件
room Room是谷歌官方的数据库ORM框架

代码结构:

src
└─com
   └─dhc
     └─library
        └─base
            │  BaseApplication.java         定义Application基类
            │  BaseActivity.java            无MVP的activity基类
            │  BaseBean.java                数据类的基类
            │  BaseChildApplication.java    该Application只能放在子moudle中使用,用于moudle隔离
            │  BaseFragment.java            无MVP的Fragment基类
            │  BaseSubscriber.java          调用者自己对请求数据进行处理
            │  IBaseModle.java              Modle请求数据的基类
            │  IBasePresenter.java          Presenter基类
            │  IBaseView.java               View的基类
            │  XDaggerActivity.java         MVP activity基类
            │  XDaggerFragment.java         MVP Fragment基类
            │  XDataBindingActivity.java    Databinding和Dagger2使用的Activity//1.0.6以后已经剔除
            │  XDataBindingFragment.java    Databinding和Dagger2使用的Fragment//1.0.6以后已经剔除
            │  XPresenter.java              用于绑定view和解绑view
            │   other....
         └─data
            ├─account
            │  AccountManager.java          登陆账号管理类
            ├─Cache
            │  MemoryCache.java             内存缓存
            ├─net
            │  ApiResponse.java             Api响应结果的封装类
            │  TokenInterceptor.java        Token管理
            │  SubscriberListener.java      业务异常干货统一处理
            │  CallInterceptor.java         做请求前和请求后的操作
            ├─DBHelper.java                 room数据库帮助类
            ├─HttpHelper.java               网络请求的辅助类
            ├─SPHelper.java                 SharedPreferences统一管理类
        └─di
          ├─component
          │ AppComponent.java               App的注入使用
          ├─module  ....                    注入对象提供者
          │  other...
        └─util
            ├─file                          文件处理工具
            ├─media                         图文视频处理工具
            ├─rx                            rxjava处理工具
            ├─storage                       储存文件夹处理工具
            ├─string                        String处理工具
            ├─sys                           系统类处理工具
            ├─AppContext                    保存全局的Application
            ├─ApplicationLike               作为接口，方便主工程调度子模块的声明周期
            ├─AppManager                    Activity进栈出栈统一管理
            .....

具体使用:

初始化拓展

初始化

*可以让自己的主Application直接继承BaseApplication,如果有特殊的要求也可以把相对的代码复制到自己主Applic
ation中,在 Appliction 初始化也提供了网络请求相关,以及Dagger2注入对象相关的配置*
```
  public class   SampleApp extends BaseApplication{
      public void onCreate() {
            //todo
        }
        ...
    }
```

网络相关配置

NetConfig配置

配置网络请求BaseUrl,也可以配置多个BaseUrl,以及网络相关的配置,具体配置可参考NetConfig

public class SampleApp extends BaseApplication {

@Override
public void onCreate() {
    super.onCreate();
}

/**
 * 必须重新设置BaseUrl
 *
 * @return
 */
@Override
public IDataHelper.NetConfig getNetConfig() {
     ClearableCookieJar cookieJar = new PersistentCookieJar(new SetCookieCache(), new
            SharedPrefsCookiePersistor(this));
    return new IDataHelper.NetConfig()
            .configBaseURL("www.desoce.com")//配置 baseUrl
            .configConnectTimeoutMills(3)//配置当前(默认读写都是15)超时时间
            .configConverterFactory( new Converter.Factory[]{ProtoConverterFactory.create()})//配置多个解析器
            .configInterceptors(new Interceptor[]{new TokenInterceptor()})//配置多个拦截器
            .configLogEnable(true)//是否打印日志
            .configCookieJar(cookieJar)// 配置 cookie 缓存,如果没有配置就默认使用 PersistentCookieJar.
            .configisUseMultiBaseURL(true)//是否开启对个 baserlU
            .configIsUseRx(true) //是否使用rxjava适配器(默认是开启)
            .configCall(new IDataHelper.RequestCall() {
                @Override
                public Request onBeforeRequest(Request request, Interceptor.Chain chain) {//请求之前
                    return null;
                }

                @Override
                public Response onAfterRequest(Response response, ResponseBody result, Interceptor.Chain chain) {//数据返回之前
                    return null;
                }
            })//请求拦截器.
            .configHttps(new IDataHelper.HttpsCall() {
                @Override
                public void configHttps(OkHttpClient.Builder builder) {

                }
            })//okhttp 相关的配置处理.比如配置 https
            ;
 }
}

配置单个请求重连次数和时长

//在IModel中使用compose()方法,默认重连三次每次等待时间3秒,有特殊情况可以重新设置
RxUtil. <T extends ApiResponse>rxSchedulerHelper(int count, final long delay)

Dagger2注入对象相关的配置

public class SampleApp extends BaseApplication {

@Override
public void onCreate() {
    super.onCreate();
}

@Override
public AppComponent getAppComponent() {
    return 
            getAppComponentBuilder()
            .appModule(new AppModule(this))//默认添加
            .otherModule(new therModule())//添加注入,具体使用请参考 Dagger2
            ;
     }
}

缓存技术

LruCache

```
//获取 当前 Appliction 对象就可以使用 LruCache(内存缓存),提供了 CRUD 方法

ICache iCache=((BaseApplication)AppContext.get()).getAppComponent().memoryCache();

iCache.put("key",object);//添加

iCache.remove("key");//移除

iCache.get("key")//获取

iCache.contains("key");//是否包含

iCache.clear();//清空
```

SharedPreferences

SPHelper.put(this,"key","object")// 添加

SPHelper.get(context,"key",defaultType)//获取 defaltType must be

SPHelper.contains(context,"key");//是否包含

SPHelper.remove(context);//移除

数据库 Room缓存

添加注解

 dependencies {
    android.arch.persistence.room:compiler:1.1.0-alpha1
}

字段与实体类的映射关系

@Entity(tableName = "gankitem")
public class GankItemBean {
    @PrimaryKey
    @ColumnInfo(name="id")
    @NonNull
    private String _id;
    private String url;

    public String get_id() {
        return _id;
    }   
    public void set_id(String _id) {
        this._id = _id;
    }

   public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }
}

添加实体与表映射关系

@Database(entities = {GankItemBean.class}, version = 1)//对应映射实体类,修改了字段必需升级版本号
public abstract class AppDatabase extends RoomDatabase {

    public abstract GankDao gankDao();

}

操作数据库

//获取 当前 Appliction 对象就可以使用Room

DBHelper db=((BaseApplication)AppContext.get()).getAppComponent().dtabaseHelper();
AppDatabase appDatabase=   ((BaseApplication)AppContext.get()).getAppComponent().dtabaseHelper().getApi(AppDatabase.class,"gankitem");
GankItemBean gankItemBean=    new GankItemBean();
gankItemBean.set_id("1");
gankItemBean.setUrl("的设计费估计是");
appDatabase.gankDao().insertAll(gankItemBean);//插入数据

List<GankItemBean> gankItemBeans= appDatabase.gankDao().getAll();//查询所有数据

RxCache

定义 CacheApi

public  interface CacheApi {
    @LifeCache(duration = 2,timeUnit = TimeUnit.MINUTES)//两分钟失效
    Flowable<SampleApiResponse<List<GankItemBean>>> getRandomGirl(Flowable<SampleApiResponse<List<GankItemBean>>> sampleApiResponseFlowable);
}

修改Presenter

public class RxCacheTestPresenter extends XPresenter<INetTestContract.IView> implements INetTestContract.IPresenter {

    private NetTestRemoteDataService mNetTestRemoteDataService;
    private CacheApi cacheApi;

    @Inject
    public RxCacheTestPresenter(NetTestRemoteDataService NetTestRemoteDataService, RxCache rxCache) {
        mNetTestRemoteDataService = NetTestRemoteDataService;
        cacheApi= rxCache.using(CacheApi.class);//获取 Cache
    }


    @Override
    public void getRandomGirl() {
        cacheApi.getRandomGirl(mNetTestRemoteDataService.getRandomGirl())// 使用缓存
                .compose(getV().<SampleApiResponse<List<GankItemBean>>>bindLifecycle())
                .subscribe(new SampleSubscriber<SampleApiResponse<List<GankItemBean>>>(new SampleSubscriberListener<List<GankItemBean>>() {
                    @Override
                    public void onSuccess(List<GankItemBean> response) {
                        getV().success(response);
                    }

                    @Override
                    public void onFail(NetError errorMsg) {
                        super.onFail(errorMsg);
                        getV().failure("-1", errorMsg.getMessage());
                    }
                }));
    }
}

数据处理

ApiResponse

参考自己具体业务进行处理
示例 :
ApiResponse

public class SampleApiResponse <T> implements ApiResponse<T> {
private boolean error;
public T results;
@Override
public T getData() {...}
public void setData(T data) {...}
@Override
public boolean isSuccess() {...}
@Override
public boolean checkReLogin() {
return false;
    }
}