NetWrapper

基于retrofit封装,面向接口,链式调用,使用时不设计retrofit中的类.可继承BaseNet类来无缝切换到其他网络,如volley.

update

已完成

缓存完全由客户端自行控制(ACache),利用http请求头来完全屏蔽okhttp的缓存体系

上传和下载的进度回调(填了很大的坑)

指定请求回调的最短时间

自动登录和登录状态接口

post提交一个json数据

todo

1.下载策略

/**
* 下载的一些通用策略: downloadStratege
* 1. 是否用url中的文件名作为最终的文件名,或者指定文件名
* 2.如果是图片,音频,视频等多媒体文件,是否在下载完成后让mediacenter扫描一下?
* 3. 如果是apk文件,是否在下载完成后打开?或者弹窗提示用户?
* 4. md5校验 : 是否预先提供md5 ,下载完后与文件md5比较,以确定所下载的文件的完整性?
* 5.断点续传的实现
6.下载队列和指定同时下载文件的个数
* */

2.缓存

无网络时读缓存

缓存文件夹大小的设置

缓存功能改回由okhttp框架去实现,第一层控制请求头和响应头就好.

usage

gradle

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}

Step 2. Add the dependency

dependencies {
compile'com.github.hss01248:NetWrapper:0.1.4'
}

api

getString(String url, Map map, MyNetListener listener).setXxx()....start();
//中间的setXxx可以没有,如:
MyNetApi.getString("http://www.qxinli.com/Application/about/androidAbout.html", new HashMap(), new MyNetListener<String>() {
@Override
public void onSuccess(String response, String resonseStr) {
Logger.e(response);
}
}).start();
其他api:
postString( String url, Map map, MyNetListener listener).start()
//标准json
postStandardJson( String url, Map map, Class clazz, MyNetListener listener).start()
getStandardJson( String url, Map map, Class clazz, MyNetListener listener).start()
//普通jsonObject和JsonArray
postCommonJson( String url, Map map, Class clazz, MyNetListener listener).start()
getCommonJson( String url, Map map, Class clazz, MyNetListener listener).start()
//上传和下载
download(String url, String savedpath, MyNetListener listener).start()
upLoad(String url, Map<String,String> params,Map<String,String> files, MyNetListener callback).start()
//自动登录相关:
autoLogin();
autoLogin(MyNetListener myNetListener);
boolean isLogin();

概览

json的解析:

如果是jsonObject,

clazz传入实体类的Class,同时MyNetListener泛型设置为该实体类

如果JsonArray,:

clazz传入数组元素类的Class,同时MyNetListener泛型设置为该实体类,其回调采用

onSuccessArr(List<T> response,String resonseStr)

标准格式json的解析

api:

getStandardJsonResonse

postStandardJsonResonse

请求的配置

默认字段和code码

ConfigInfo:
publicstaticStringKEY_DATA = "data";
publicstaticStringKEY_CODE = "code";
publicstaticStringKEY_MSG = "msg";
BaseNetBean:
publicstaticfinalintCODE_NONE = -1;
publicstaticintCODE_SUCCESS = 0;
publicstaticintCODE_UNLOGIN = 2;
publicstaticintCODE_UN_FOUND = 3;

全局配置

MyNetApi:

publicstaticvoidinit(Contextcontext,StringbaseUrl,ILoginManagerloginManager)
/** * 指定标准格式json的三个字段.比如聚合api的三个字段分别是error_code(但有的又是resultcode),reason,result,error_code * @param tokenName  * @param data * @param code * @param msg * @param codeSuccess * @param codeUnlogin * @param codeUnfound */publicstaticvoidinitAppDefault(StringtokenName,Stringdata,Stringcode,Stringmsg,intcodeSuccess,intcodeUnlogin,intcodeUnfound)

单个请求的配置

ConfigInfo:

publicConfigInfo<T> setStandardJsonKey(StringkeyData,StringkeyCode,StringkeyMsg)
publicConfigInfo<T> setStandardJsonKeyCode(StringkeyCode)
publicConfigInfo<T> setCustomCodeValue(intcode_success,intcode_unlogin,intcode_unFound)

用本框架发起一个本app常规请求之外的标准json请求:

 /*	聚合api:笑话大全
http://japi.juhe.cn/joke/content/list.from get请求
sort	string	是	类型，desc:指定时间之前发布的，asc:指定时间之后发布的
page	int	否	当前页数,默认1
pagesize	int	否	每次返回条数,默认1,最大20
time	string	是	时间戳（10位），如：1418816972
key string 您申请的key
返回:
{
"error_code": 0,
"reason": "Success",
"result": {....}
}
*/
Map<String,String> map4 = new HashMap<>();
map4.put("sort","desc");
map4.put("page","1");
map4.put("pagesize","4");
map4.put("time",System.currentTimeMillis()/1000+"");
map4.put("key","fuck you");
MyNetApi.getStandardJson("http://japi.juhe.cn/joke/content/list.from",
map4, GetStandardJsonBean.class, new MyNetListener<GetStandardJsonBean>() {
@Override
public void onSuccess(GetStandardJsonBean response, String resonseStr) {
Logger.json(MyJson.toJsonStr(response));
}
@Override
public void onError(String error) {
super.onError(error);
Logger.e(error);
}
})
.setStandardJsonKey("result","error_code","reason")
.setCustomCodeValue(0,2,-1)
.setShowLoadingDialog(MainActivity.this,"加载中...")
.start();

完全的客户端缓存控制

已屏蔽下层网络执行层(okhttp)框架本身的缓存功能.

配置单个请求的缓存策略(默认是无缓存)

只针对String和json的请求结果的缓存,缓存的形式是String,带有有效期.

ConfigInfo:
/** * 只支持String和json类型的请求,不支持文件下载的缓存. * @param shouldReadCache 是否先去读缓存 * @param shouldCacheResponse 是否缓存response 内部已做判断,只会缓存状态是成功的那些请求 * @param cacheTimeInSeconds 缓存的时间,单位是秒 * @return */publicConfigInfo<T> setCacheControl(booleanshouldReadCache,booleanshouldCacheResponse,longcacheTimeInSeconds)

blog

基于retrofit的网络框架的终极封装(一):第一层参数组装层的API设计