NetWrapper
Introduction: 基于 retrofit 封装,callback 模式,面向接口,链式调用,使用时不涉及到 retrofit 中的类.可继承 BaseNet 类来无缝切换到其他网络,如 volley.
Tags:
基于 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:
public static String KEY_DATA = "data";
public static String KEY_CODE = "code";
public static String KEY_MSG = "msg";
BaseNetBean:
public static final int CODE_NONE = -1;
public static int CODE_SUCCESS = 0;
public static int CODE_UNLOGIN = 2;
public static int CODE_UN_FOUND = 3;
全局配置
MyNetApi:
public static void init(Context context,String baseUrl,ILoginManager loginManager)
/**
* 指定标准格式 json 的三个字段.比如聚合 api 的三个字段分别是 error_code(但有的又是 resultcode),reason,result,error_code
* @param tokenName
* @param data
* @param code
* @param msg
* @param codeSuccess
* @param codeUnlogin
* @param codeUnfound
*/
public static void initAppDefault(String tokenName,String data,String code,String msg,int codeSuccess,int codeUnlogin,int codeUnfound)
单个请求的配置
ConfigInfo:
public ConfigInfo<T> setStandardJsonKey(String keyData,String keyCode,String keyMsg)
public ConfigInfo<T> setStandardJsonKeyCode(String keyCode)
public ConfigInfo<T> setCustomCodeValue(int code_success,int code_unlogin,int code_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
*/
public ConfigInfo<T> setCacheControl(boolean shouldReadCache,boolean shouldCacheResponse,long cacheTimeInSeconds)