Novate 網(wǎng)絡(luò)庫：Retrofit2.0和RxJava的又一次完美改進(jìn)加強(qiáng)

Novate網(wǎng)絡(luò)庫：Retrofit2.0和RxJava的又一次完美改進(jìn)加強(qiáng)介紹Novate的改進(jìn)加入基礎(chǔ)API，減少Api冗余支持離線緩存支持多種方式訪問網(wǎng)絡(luò)（get,put,post,delete）支持文件下載和上傳支持請(qǐng)求頭參數(shù)統(tǒng)一添加支持對(duì)返回結(jié)果的統(tǒng)一處理支持自定義的擴(kuò)展API支持統(tǒng)一請(qǐng)求訪問網(wǎng)絡(luò)的流程控制用法基本構(gòu)建:Novatenovate=newNovate.Builder(this).baseUrl(baseUrl).build();除了基本的構(gòu)建還提供更了其他API構(gòu)建你的header頭和參數(shù)Map<String,String>headers=newHashMap<>();headers.put("apikey","4545sdsddfd7sds");Map<String,String>parameters=newHashMap<>();parameters.put("uid","878787878sdsd");實(shí)例化：Novatenovate=newNovate.Builder(this).addParameters(parameters).connectTimeout(8).baseUrl("youapiurl").addHeader(headers).addLog(true).build();如果你需要接入證書：novate.addSSL(hosts,certificates)怎么用？int[]certificates={R.raw.myssl1,R.raw.myssl2,......}int[]hosts={"https://youhosturl2","https://youhosturl2",......}還要說明？certificates是你的ssl證書文件的id，項(xiàng)目中請(qǐng)放到raw資源文件下,myssl.cer怎么生成，這個(gè)就不是我這邊講的內(nèi)容，請(qǐng)用pc瀏覽器自動(dòng)導(dǎo)出證書，保存,還不清楚的話，我會(huì)醉醉。同樣很多人想問我想對(duì)novate進(jìn)行擴(kuò)展，咋辦，別擔(dān)心，Novate也提供了以下方法novate.addInterceptor().addCallAdapterFactory().callFactory().client()不知道啥意思？請(qǐng)對(duì)Retrofit去入門，Retrofit中怎么用，Novate就怎么用。RxJava怎么處理？observable.subscribeOn(Schedulers.io()).unsubscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread());內(nèi)部統(tǒng)一已進(jìn)行線程控制，所有請(qǐng)求都采用以上線程形式，無語你手動(dòng)添加。Get提供了novate.get（）和novate.get（）API區(qū)別如下：executeGet來執(zhí)行g(shù)et請(qǐng)求，此方法會(huì)解析返回你需要的bean實(shí)體novate.get()不會(huì)幫你解析實(shí)體，需要你自己對(duì)返回?cái)?shù)據(jù)解析進(jìn)行序列化。novate.executeGet("youurl",parameters,newNovate.ResponseCallBack<NovateResponse<ResultModel>>(){@OverridepublicvoidonError(Throwablee){}@OverridepublicvoidonSuccee(NovateResponse<ResultModel>response){//這里novate已對(duì)ResponseBody進(jìn)行解析返回，}});如果你不需要Novate幫你解析返回的數(shù)據(jù)則調(diào)用novate.get（）novate.get("youUrl",parameters,newBaseSubscriber<ResponseBody>(ExempleActivity.this){@OverridepublicvoidonNext(ResponseBodyresponseBody){try{Stringjstr=newString(responseBody.bytes());Typetype=newTypeToken<MovieModel>(){}.getType();//這里需要對(duì)ResponseBody進(jìn)行解析，novate并不會(huì)幫你解析MovieModelresponse=newGson().fromJson(jstr,type);Toast.makeText(ExempleActivity.this,response.toString(),Toast.LENGTH_SHORT).show();}catch(IOExceptione){e.printStackTrace();}}});Post提供了`novate.post（）`和`novate.executePost（）`兩個(gè)API區(qū)別如下：executePost來執(zhí)行Post方式請(qǐng)求，此方法對(duì)結(jié)果解析返回你需要的bean實(shí)體novate.post()不會(huì)幫你解析實(shí)體，需要你自己對(duì)返回?cái)?shù)據(jù)解析進(jìn)行序列化。Get和Post代碼用法很相似，novate.post（）/*****調(diào)用post需要你自己解析數(shù)據(jù)**如果需要解析后返回則調(diào)用novate.executeGet()*參考performGet()中的方式*/novate.post("service/getIpInfo.php",parameters,newBaseSubscriber<ResponseBody>(ExempleActivity.this){@OverridepublicvoidonError(Throwablee){}@OverridepublicvoidonNext(ResponseBodyresponseBody){try{Stringjstr=newString(responseBody.bytes());Typetype=newTypeToken<NovateResponse<ResultModel>>(){}.getType();NovateResponse<ResultModel>response=newGson().fromJson(jstr,type);Toast.makeText(ExempleActivity.this,response.getData().toString(),Toast.LENGTH_SHORT).show();}catch(IOExceptione){e.printStackTrace();}}});novate.executePost（）novate.executePost("pathUrl",parameters,newNovate.ResponseCallBack<NovateResponse<MyModel>>(){@OverridepublicvoidonError(Throwablee){//todo}@OverridepublicvoidonSuccee(NovateResponse<ResultModel>response){//todo}});Putput方式則提供了novate.put（）和novate.executePut（）兩個(gè)API區(qū)別和用法參考上面Get和PutDelete同樣對(duì)Delete提供了novate.delete（）和novate.executeDelete（）兩個(gè)API區(qū)別和用法參考上面Get和PutBODY假設(shè)你需要提交body，Novate也提供了novate.body()，需要直接將你bean對(duì)象加入即可，因此可以：ovate.body(url,uesrBean,newBaseSubscriber<ResponseBody>(){@OverridepublicvoidonError(Throwablee){}@OverridepublicvoidonNext(ResponseBodyresponseBody){}});FORM假設(shè)你以提交表單，請(qǐng)使用novate.form()，你可以：novate.form(url,newHashMap<String,Object>(),newBaseSubscriber<ResponseBody>(){@OverridepublicvoidonError(Throwablee){}@OverridepublicvoidonNext(ResponseBodyresponseBody){}});JSON假設(shè)你需要直接pushjson字符串，你可以：novate.json(url,jsonString,newBaseSubscriber<ResponseBody>(){@OverridepublicvoidonError(Throwablee){}@OverridepublicvoidonNext(ResponseBodyresponseBody){}});UpLoad當(dāng)然novate特提供了可供上傳圖片的APInovate.upload（）RequestBodyrequestFile=Utils.createFile(file);novate.upload(url,requestFile,newBaseSubscriber<ResponseBody>{@OverridepublicvoidonNext(ResponseBodyresponseBody){}});如果是單文件novate.uploadFlie(url,requestFile,newBaseSubscriber<ResponseBody>{@OverridepublicvoidonNext(ResponseBodyresponseBody){}});upLoadFilesMap<String,RequestBody>map=newHashMap<>();maps.put("e1",requestFile);novate.uploadFlies(url,map,newBaseSubscriber<ResponseBody>(ExempleActivity.this){......});圖文一起同時(shí)提交圖文：適合用戶注冊等場景novate.uploaduploadbody模式//構(gòu)建body鏈?zhǔn)秸Z法高逼格哦RequestBodyrequestBody=newMultipartBody.Builder().setType(MultipartBody.FORM).addFormDataPart("name","tamic").addFormDataPart("ssword","12345").addFormDataPart("atavr",file.getName(),Utils.createImage(mfile)).build();novate.upload(url,requestBody,newBaseSubscriber<ResponseBody>(ExempleActivity.this){.....});利用part模式//MultipartBody.PartisusedtosendalsotheactualfilenameMultipartBody.Partbody=Utils.createPart("hello這是和后端約定好的key",file);//add描述StringdescriptionString="hello,這是文件描述";RequestBodydescription=Utils.createPartFromString(descriptionString);//執(zhí)行novate.uploadFlie(url,description,body,newBaseSubscriber<ResponseBody>(ExempleActivity.this){。。。。。});DownLoad如果說有上傳文件的接口，必定有下載文件的接口，同樣novate也提供了下載文件APInovate.download（）novate.download(downUrl,newDownLoadCallBack(){@OverridepublicvoidonStart(){super.onStart();}@OverridepublicvoidonError(Throwablee){}@OverridepublicvoidonCancel(){super.onCancel();}@OverridepublicvoidonProgress(longfileSizeDownloaded){super.onProgress(fileSizeDownloaded);}@OverridepublicvoidonSucess(Stringpath,Stringname,longfileSize){}});通常還有同學(xué)要定制下載路徑和文件名，當(dāng)然也有API提供：publicvoidwnload(Stringurl,StringsavePath,Stringname,DownLoadCallBackcallBack){.......}downLoad大文件novate.download(downUrl,newDownLoadCallBack(){''''''''''''});downLoad小文件novate.downloadMin(downUrl,newDownLoadCallBack(){''''''''''''});CustomApi以上方法默認(rèn)會(huì)處理Novate自帶的BaseApiService，如果默認(rèn)的BaseApiService無法滿足你的需求時(shí)，Novate同樣支持你自己的ApiService。定義一個(gè)你自己的APiMyAPIpublicinterfaceMyAPI{@GET("url")Observable<MyBean>getdata(@QueryMapMap<String,String>maps);}ExecuteCall通過novate提供create()實(shí)例化你的APIMyAPImyAPI=novate.create(MyAPI.class);通過novate.call()來執(zhí)行你的接口，你也不用關(guān)心，novate內(nèi)部同樣已進(jìn)行RxJava線程控制。novate.call(myAPI.getdata(parameters),newBaseSubscriber<MyBean>(ExempleActivity.this){@OverridepublicvoidonError(Throwablee){}@OverridepublicvoidonNext(MyBeanMyBean){}});}取消每執(zhí)行novate.xxx()給上層返回了一個(gè)Subscription，上層可以調(diào)用unsubscribe()來進(jìn)行取消！