本期我們?yōu)榇蠹規(guī)?lái)的是開(kāi)發(fā)者裴云飛投稿的“HarmonyOS網(wǎng)絡(luò)請(qǐng)求框架實(shí)現(xiàn)”，這個(gè)網(wǎng)絡(luò)請(qǐng)求框架被命名為“蒹葭（JianJia）”。其原理是將Retrofit移植到HarmonyOS上，同時(shí)還實(shí)現(xiàn)一些Retrofit所不具備的功能。 比如：Retrofit不支持動(dòng)態(tài)替換域名。眾所周知，國(guó)內(nèi)的應(yīng)用一般都是有多個(gè)域名的，蒹葭的一大優(yōu)勢(shì)就是支持動(dòng)態(tài)替換域名。

如想了解更多內(nèi)容，可以直接復(fù)制鏈接看源碼哦：https://gitee.com/zhongte/JianJia 接下來(lái)我們將挑選幾個(gè)關(guān)鍵點(diǎn)做解釋，希望能給你的HarmonyOS開(kāi)發(fā)之旅帶來(lái)一些啟發(fā)~ 在敲代碼之前，需要大家下載安裝“Huawei DevEco Studio”，如有疑問(wèn)，可參考官網(wǎng)指南。

● Huawei DevEco Studio安裝指南： https://developer.harmonyos.com/cn/docs/documentation/doc-guides/software_install-0000001053582415 為了保證順利使用，我們先來(lái)看一下使用前的一些配置，這里我們主要介紹兩個(gè)方面配置，一個(gè)是針對(duì)代碼混淆的處理，一個(gè)是添加依賴。

01

使用前的配置

1.代碼混淆處理

如果項(xiàng)目開(kāi)啟了代碼混淆，請(qǐng)?jiān)趐roguard-rules.pro添加如下代碼：

-renamesourcefileattribute SourceFile-keepattributes SourceFile，LineNumberTable-dontwarn javax.annotation.**-keepattributes Signature， InnerClasses， EnclosingMethod， Exceptions# 蒹葭-dontwarn poetry.jianjia.**-keep class poetry.jianjia.** { *; }-keepattributes RuntimeVisibleAnnotations， RuntimeVisibleParameterAnnotations-keepclassmembers，allowshrinking，allowobfuscation interface * { @poetry.jianjia.http.* 《methods》;}

# OkHttp3-dontwarn okhttp3.logging.**-keep class okhttp3.internal.**{*;}-dontwarn okio.**

# gson-keep class sun.misc.Unsafe { *; }-keep class com.google.gson.stream.** { *; }-keepattributes *Annotation*-keepclassmembers class * implements java.io.Serializable { static final long serialVersionUID; private static final java.io.ObjectStreamField［］ serialPersistentFields; private void writeObject（java.io.ObjectOutputStream）; private void readObject（java.io.ObjectInputStream）; java.lang.Object writeReplace（）; java.lang.Object readResolve（）;}# 在示例代碼中，com.poetry.jianjia.bean這個(gè)包下面的類實(shí)現(xiàn)了Serialized接口，# 實(shí)現(xiàn)了Serialized接口的類不能被混淆，請(qǐng)把com.poetry.jianjia.bean這個(gè)包名替換成你自己的包名-keep class com.poetry.jianjia.bean.**{*;}

2.添加依賴

添加依賴就是引用類庫(kù)，詳情如下：

1） 在項(xiàng)目根目錄下的build.gradle文件中添加mavenCentral（）倉(cāng)庫(kù)

打開(kāi)項(xiàng)目根目錄下的build.gradle文件，在build.gradle文件的repositories閉包下面添加mavenCentral（）。

buildscript { repositories { // 添加maven中央倉(cāng)庫(kù) mavenCentral（） maven { url ‘https://mirrors.huaweicloud.com/repository/maven/’ } maven { url ‘https://developer.huawei.com/repo/’ } maven { url ‘http://maven.aliyun.com/nexus/content/repositories/central/’ } jcenter（） } dependencies { classpath ‘com.huawei.ohos2.4.2.5’ classpath ‘com.huawei.ohos1.0.0.6’ }}

allprojects { repositories { // 添加maven中央倉(cāng)庫(kù) mavenCentral（） maven { url ‘https://mirrors.huaweicloud.com/repository/maven/’ } maven { url ‘https://developer.huawei.com/repo/’ } maven { url ‘http://maven.aliyun.com/nexus/content/repositories/central/’ } jcenter（） }}

2）在build.gradle文件的dependencies閉包下添加依賴

打開(kāi)entry目錄下的build.gradle文件，在build.gradle文件中的dependencies閉包下添加下面的依賴。

// 蒹葭的核心代碼implementation ‘io.gitee.zhongte1.0.1’// 數(shù)據(jù)轉(zhuǎn)換器，數(shù)據(jù)轉(zhuǎn)換器使用gson來(lái)幫我們解析json，不需要我們手動(dòng)解析jsonimplementation ‘io.gitee.zhongte1.0.1’implementation “com.google.code.gson2.8.2”// 日志攔截器，通過(guò)日志攔截器可以看到請(qǐng)求頭、請(qǐng)求體、響應(yīng)頭、響應(yīng)體implementation ‘com.squareup.okhttp33.7.0’// 如果服務(wù)端返回的json有特殊字符，比如中文的雙引號(hào)，gson在解析的時(shí)候會(huì)對(duì)特殊字符進(jìn)行轉(zhuǎn)義// 這時(shí)就需要將轉(zhuǎn)義后的字符串進(jìn)行反轉(zhuǎn)義，commons-lang可以對(duì)特殊字符進(jìn)行轉(zhuǎn)義和反轉(zhuǎn)義implementation ‘commons-lang2.6’

3）在配置文件中添加以下權(quán)限

ohos.permission.INTERNET

02

用法

蒹葭與Retrofit用法相同，并且蒹葭提供一系列的注解?！白⒔狻笨梢钥醋魇菍?duì)一個(gè)類/方法的一個(gè)擴(kuò)展的模版，每個(gè)類/方法按照注解類中的規(guī)則，來(lái)為類/方法注解不同的參數(shù)，在用到的地方可以得到不同的類/方法中注解的各種參數(shù)與值。在進(jìn)行網(wǎng)絡(luò)請(qǐng)求的時(shí)候，就需要用到這些注解，下文將介紹蒹葭中常用和需要注意的注解。

1.GET注解

創(chuàng)建接口，在方法里面使用GET注解，GET注解用于標(biāo)識(shí)這是一個(gè)GET請(qǐng)求，方法的返回值是Call對(duì)象，泛型是ResponseBody，其實(shí)泛型也可以是具體的實(shí)體對(duì)象，我們將在下文“16.添加數(shù)據(jù)轉(zhuǎn)換器“中詳說(shuō)。

蒹葭如何完成網(wǎng)絡(luò)請(qǐng)求？使用構(gòu)造者模式創(chuàng)建jianjia對(duì)象，baseUrl就是域名，在創(chuàng)建jianjia對(duì)象的時(shí)候就必須指定域名。

調(diào)用create方法來(lái)生成接口的實(shí)例，調(diào)用wan.getBanner（）.enqueue來(lái)執(zhí)行網(wǎng)絡(luò)請(qǐng)求，請(qǐng)求成功就會(huì)回調(diào)onResponse方法，請(qǐng)求失敗就會(huì)回調(diào)onFailure方法。

public interface Wan { @GET（“banner/json”） Call《ResponseBody》 getBanner（）;}JianJia jianJia = new JianJia.Builder（） .baseUrl（“https://www.wanandroid.com”） .build（）;Wan wan = jianJia.create（Wan.class）;wan.getBanner（）.enqueue（new Callback《ResponseBody》（） { @Override public void onResponse（Call《ResponseBody》 call， Response《ResponseBody》 response） { try { String json = response.body（）.string（）; } catch （IOException e） { e.printStackTrace（）; } } @Override public void onFailure（Call《ResponseBody》 call， Throwable t） { LogUtils.info（“yunfei”， t.getMessage（））; }}）;

2. BaseUrl注解

國(guó)內(nèi)的應(yīng)用一般都是有多個(gè)域名的，BaseUrl注解可以對(duì)某個(gè)接口設(shè)置單獨(dú)的域名。

public interface Wan { @BaseUrl（“https://api.apiopen.top”） @GET（“getJoke”） Call《ResponseBody》 getJoke（@QueryMap Map《String， String》 param）;}

3. Path注解

Path注解在路徑中替換指定的參數(shù)值，定義下面的方法?？梢钥吹轿覀兌x了一個(gè)getArticle方法，方法接收一個(gè)page參數(shù)，并且我們的@GET注解中使用{page}聲明了訪問(wèn)路徑，這里你可以把{page}當(dāng)做占位符，而實(shí)際運(yùn)行中會(huì)通過(guò)@Path（“page”）所標(biāo)注的參數(shù)進(jìn)行替換。

public interface Wan {

@GET（“article/list/{page}/json”） Call《ResponseBody》 getArticle（@Path（“page”） int page）;

}

4.Query注解

Query注解用于給“get請(qǐng)求”添加請(qǐng)求參數(shù)，被Query注解修飾的參數(shù)類型可以是數(shù)組、集合、字符串等。

public interface Wan { @GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@Query（“k”） String k）; @GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@Query（“k”） String.。。 k）; @GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@Query（“k”） List《String》 k）;}

5.QueryMap注解

QueryMap注解以map的形式添加查詢參數(shù)，被QueryMap注解修飾的參數(shù)類型必須是Map對(duì)象。

public interface Wan {

@GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@QueryMap Map《String， String》 param）;}

6.SkipCallbackExecutor注解

在HarmonyOS中，默認(rèn)將服務(wù)端的響應(yīng)回調(diào)到主線程，如果在方法上使用SkipCallbackExecutor注解，就不會(huì)將服務(wù)端的結(jié)果回調(diào)到主線程。

public interface Wan { @SkipCallbackExecutor @GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@QueryMap Map《String， String》 param）;}

7.FormUrlEncoded注解和Field注解

“FormUrlEncoded注解”用于發(fā)送一個(gè)表單請(qǐng)求，使用該注解必須在方法的參數(shù)中添加Field注解，被Field注解修飾的參數(shù)類型可以是數(shù)組、集合、字符串等。

public interface Wan { @POST（“user/login”） @FormUrlEncoded Call《ResponseBody》 login（@Field（“username”） String username， @Field（“password”） String password）;}

8.FormUrlEncoded注解和FieldMap注解

有時(shí)候表單的參數(shù)會(huì)比較多，如果使用Field注解，方法的參數(shù)就會(huì)比較多，此時(shí)就可以使用FieldMap注解，F(xiàn)ieldMap注解以map的形式發(fā)送一個(gè)表單請(qǐng)求。如果被FieldMap注解修飾的參數(shù)不是Map類型，就會(huì)報(bào)異常。如果Map的鍵值對(duì)為空，也會(huì)報(bào)異常。

public interface Wan { @POST（“user/login”） @FormUrlEncoded Call《ResponseBody》 login（@FieldMap Map《String， String》 map）;}

9. Body注解

服務(wù)端會(huì)要求客戶端把json字符串作為請(qǐng)求體發(fā)給服務(wù)端。此時(shí)就可以使用Body注解定義的參數(shù)直接傳入一個(gè)實(shí)體類，內(nèi)部會(huì)把該實(shí)體序列化并將序列化后的結(jié)果直接作為請(qǐng)求體發(fā)送出去。 如果被Body注解修飾的參數(shù)的類型是RequestBody對(duì)象，那調(diào)用者可以不用添加數(shù)據(jù)轉(zhuǎn)換器，內(nèi)部會(huì)使用默認(rèn)的數(shù)據(jù)轉(zhuǎn)換器。

如果被Body注解修飾的參數(shù)的類型不是RequestBody對(duì)象，是一個(gè)具體的實(shí)體類，那調(diào)用者需要自定義一個(gè)類，并且繼承Converter.Factory。

public interface Wan { /** * 被Body注解修飾的參數(shù)的類型是RequestBody對(duì)象，那調(diào)用者可以不添加數(shù)據(jù)轉(zhuǎn)換器，內(nèi)部會(huì)使用默認(rèn)的數(shù)據(jù)轉(zhuǎn)換器 * * @param body * @return */ @POST（“user/register”） Call《ResponseBody》 register（@Body RequestBody body）;

/** * 被Body注解修飾的參數(shù)的類型不是RequestBody對(duì)象，是一個(gè)具體的實(shí)體類，那調(diào)用者需要自定義一個(gè)類，并且繼承Converter.Factory * * @param user * @return */ @POST（“user/register”） Call《ResponseBody》 register（@Body User user）;}

10.Url注解

Url注解用于添加接口的完整地址。在Retrofit里面，如果接口的域名與創(chuàng)建retrofit對(duì)象指定的域名不相同，就會(huì)使用Url注解來(lái)解決問(wèn)題。在蒹葭里面不但可以使用Url注解來(lái)解決問(wèn)題，還提供了BaseUrl來(lái)解決該問(wèn)題。

public interface Wan {

@GET（） Call《ResponseBody》 getArticle（@Url String url）;

}

11.Header注解

Header注解是作用于參數(shù)上的注解，用于添加請(qǐng)求頭。

public interface Wan {

@GET（） Call《ResponseBody》 foo（@Header（“Accept-Language”） String lang）;

}

12.Headers注解

Headers注解是作用于方法上的注解，用于添加一個(gè)或多個(gè)請(qǐng)求頭。

public interface Wan { @Headers（“Cache-Control： max-age=640000”） @GET（“/”） Call《ResponseBody》 getArticle（@Url String url）; @Headers（{ “X-Foo： Bar”， “X-Ping： Pong” }） @GET（“/”） Call《ResponseBody》 getArticle（@Url String url）;}

13.HeaderMap注解

HeaderMap注解是作用于參數(shù)上的注解，以Map的形式添加請(qǐng)求頭，Map中每一項(xiàng)的鍵和值都不能為空，否則會(huì)報(bào)異常。

public interface Wan {

@GET（“/search”） Call《ResponseBody》 list（@HeaderMap Map《String， String》 headers）;

}

14. Multipart注解和Part注解

Multipart注解和Part注解用于上傳單個(gè)文件。 在配置文件添加下面兩個(gè)權(quán)限，這兩個(gè)權(quán)限需要?jiǎng)討B(tài)申請(qǐng)。

ohos.permission.READ_MEDIAohos.permission.WRITE_MEDIA

定義一個(gè)upload方法，方法參數(shù)使用Part注解修飾，參數(shù)類型必須是MultipartBody.Part。

public interface Wan {

/** * 上傳文件，需要使用Multipart注解和Part注解 * * @param photo 本地文件的路徑 * @return */ @Multipart @POST（） Call《ResponseBody》 upload（@Part MultipartBody.Part photo）;}// 文件路徑File file = new File（getExternalCacheDir（）， “icon.png”）;// 創(chuàng)建請(qǐng)求體對(duì)象RequestBody photoBody = RequestBody.create（MediaType.parse（“image/png”）， file）;// MultipartBody.Part photo = MultipartBody.Part.createFormData（“photos”， “icon.png”， photoBody）;

JianJia jianJia = new JianJia.Builder（） .baseUrl（“https://www.wanandroid.com”） .build（）;

Wan wan = jianJia.create（Wan.class）;// 上傳文件wan.upload（photo）.enqueue（new Callback《ResponseBody》（） { @Override public void onResponse（Call《ResponseBody》 call， Response《ResponseBody》 response） { // 上傳成功 }

@Override public void onFailure（Call《ResponseBody》 call， Throwable t） { LogUtils.info（“yunfei”， t.getMessage（））; }}）;

15.PartMap注解和Multipart注解

PartMap注解和Multipart注解用于上傳多個(gè)文件在配置文件添加下面兩個(gè)權(quán)限，這兩個(gè)權(quán)限需要?jiǎng)討B(tài)申請(qǐng)：

ohos.permission.READ_MEDIAohos.permission.WRITE_MEDIA

被PartMap注解修飾的Map，Map的第一個(gè)泛型必須是String：

public interface Wan {

/** * 使用PartMap注解上傳多個(gè)文件 * * @param params 第一個(gè)泛型必須是String * @return */ @Multipart @POST（） Call《ResponseBody》 upload（@PartMap Map《String， RequestBody》 params）;}File photoFile = new File（getExternalCacheDir（）， “photo.png”）;RequestBody photoBody = RequestBody.create（MediaType.parse（“image/png”）， photoFile）;

File avatarFile = new File（getExternalCacheDir（）， “avatar.png”）;RequestBody avatarBody = RequestBody.create（MediaType.parse（“image/png”）， avatarFile）;Map《String， RequestBody》 photos = new HashMap《》（）;photos.put（“photo”， photoBody）;photos.put（“avatar”， avatarBody）;

JianJia jianJia = new JianJia.Builder（） .baseUrl（“https://www.wanandroid.com”） .build（）;

Wan wan = jianJia.create（Wan.class）;// 上傳文件wan.upload（photos）.enqueue（new Callback《ResponseBody》（） { @Override public void onResponse（Call《ResponseBody》 call， Response《ResponseBody》 response） { // 上傳成功 }

@Override public void onFailure（Call《ResponseBody》 call， Throwable t） { LogUtils.info（“yunfei”， t.getMessage（））; }}）;

16.添加數(shù)據(jù)轉(zhuǎn)換器

之前我們?cè)诮涌诶锩娑x方法（GET注解中）的時(shí)候，方法的返回值Call對(duì)象，泛型是ResponseBody。在這種情況下，服務(wù)端返回給客戶端的數(shù)據(jù)就會(huì)在ResponseBody里面，客戶端需要手動(dòng)解析json，將json解析成一個(gè)實(shí)體類。 其實(shí)，我們沒(méi)必要手動(dòng)解析json，可以讓gson幫我們解析json。蒹葭支持添加數(shù)據(jù)轉(zhuǎn)換器，在創(chuàng)建對(duì)象的時(shí)候添加數(shù)據(jù)轉(zhuǎn)換器，也就是把gson添加進(jìn)來(lái)。在onResponse方法里面就可以直接得到實(shí)體類對(duì)象了，gson幫我們把json解析成了一個(gè)實(shí)體類。

public interface Wan { @GET（“banner/json”） Call《Banner》 getBanner（）;}JianJia jianJia = new JianJia.Builder（） .baseUrl（“https://www.wanandroid.com”） .addConverterFactory（GsonConverterFactory.create（）） .build（）;Wan wan = jianJia.create（Wan.class）;wan.getBanner（）.enqueue（new Callback《Banner》（） { @Override public void onResponse（Call《Banner》 call， Response《Banner》 response） { try { if （response.isSuccessful（）） { Banner banner = response.body（）; } } catch （IOException e） { e.printStackTrace（）; } } @Override public void onFailure（Call《Banner》 call， Throwable t） { LogUtils.info（“yunfei”， t.getMessage（））; }}）;

03

Demo演示

● 示例中的網(wǎng)頁(yè)地址：

https://www.wanandroid.com/blog/show/2 視頻內(nèi)顯示的是一個(gè)網(wǎng)頁(yè)上的文章列表。客戶端通過(guò)使用蒹葭網(wǎng)絡(luò)庫(kù)訪問(wèn)該網(wǎng)站提供的接口，以此來(lái)獲取網(wǎng)頁(yè)的文章列表，當(dāng)請(qǐng)求成功后，文章列表將顯示在模擬器頁(yè)面上。

以下為Demo代碼關(guān)鍵步驟的詳解：

1.在com.poetry.jianjia.net包下面創(chuàng)建了如下的接口，把所有的請(qǐng)求放在一個(gè)接口里面即可， 無(wú)需創(chuàng)建多個(gè)接口類。

/** * @author 裴云飛 * @date 2021/1/23 */public interface Wan {

@GET（“article/list/{page}/json”） Call《ResponseBody》 getArticle（@Path（“page”） int page）;

@GET（“article/list/{page}/json”） Call《Article》 getHomeArticle（@Path（“page”） int page）;

@GET（） Call《ResponseBody》 getArticle（@Url String url）;

@GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@Query（“k”） String k）;

@GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@Query（“k”） String.。。 k）;

@GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@Query（“k”） List《String》 k）;

@GET（“wxarticle/list/405/1/json”） Call《ResponseBody》 search（@QueryMap Map《String， String》 param）;

@GET（“article/list/0/json”） Call《ResponseBody》 getArticle（@QueryMap Map《String， String》 param）;

@BaseUrl（“https://api.apiopen.top”） @GET（“getJoke”） Call《ResponseBody》 getJoke（@QueryMap Map《String， String》 param）;

@POST（“user/login”） @FormUrlEncoded Call《ResponseBody》 login（@Field（“username”） String username， @Field（“password”） String password）;

@POST（“user/login”） @FormUrlEncoded Call《ResponseBody》 login（@FieldMap Map《String， String》 map）;

@GET（“banner/json”） Call《Banner》 getBanner（）;}

（左右滑動(dòng)查看更多）

2.創(chuàng)建“jianjia”對(duì)象，整個(gè)項(xiàng)目只需一個(gè)jianjia對(duì)象即可。 如何確保只有一個(gè) jianjia對(duì)象？當(dāng)代碼運(yùn)行起來(lái)后，首先會(huì)創(chuàng)建AbilityPackage對(duì)象，調(diào)用AbilityPackage的onInitialize方法，AbilityPackage執(zhí)行完成后才會(huì)啟動(dòng)Ability。AbilityPackage就是一個(gè)全局的單例，所以在 AbilityPackage里面創(chuàng)建的對(duì)象就是一個(gè)單例對(duì)象。只需在AbilityPackage 里面創(chuàng)建jianjia對(duì)象，就能確保整個(gè)項(xiàng)目只有一個(gè)jianjia對(duì)象。AbilityPackage這個(gè)類不需要手動(dòng)創(chuàng)建，在創(chuàng)建的項(xiàng)目的時(shí)候， 編譯器會(huì)自動(dòng)創(chuàng)建一個(gè)繼承于AbilityPackage的類。

public class BaseApplication extends AbilityPackage {

private static BaseApplication instance;

private JianJia mJianJia; private Wan mWan;

public static BaseApplication getInstance（） { return instance; }

/** * 獲取全局的蒹葭對(duì)象 * * @return 全局的蒹葭對(duì)象 */ public JianJia getJianJia（） { return mJianJia; }

/** * 獲取全局的接口實(shí)例對(duì)象 * * @return 全局的接口實(shí)例對(duì)象 */ public Wan getWan（） { return mWan; }

@Override public void onInitialize（） { super.onInitialize（）; instance = this; // 創(chuàng)建全局的蒹葭對(duì)象 mJianJia = new JianJia.Builder（） .baseUrl（“https://www.wanandroid.com”） .addConverterFactory（GsonConverterFactory.create（）） .build（）; mWan = mJianJia.create（Wan.class）; }}

如上面的代碼，BaseApplication繼承AbilityPackage，在onInitialize 方法創(chuàng)建全局的蒹葭對(duì)象。同時(shí)，整個(gè)項(xiàng)目只創(chuàng)建了一個(gè)接口類，所以可以在創(chuàng)建完蒹葭對(duì)象后直接調(diào)用蒹葭的create方法來(lái)創(chuàng)建接口的實(shí)例對(duì)象。其它地方只需要通過(guò)下面的方式即可獲取蒹葭對(duì)象和接口實(shí)例對(duì)象。

// 獲取全局的蒹葭對(duì)象BaseApplication.getInstance（）.getJianJia（）;// 獲取全局的接口實(shí)例對(duì)象BaseApplication.getInstance（）.getWan（）;

3.在MainAbilitySlice里面添加ListContainer，關(guān)于ListContainer的用法，請(qǐng)查看 官方文檔 ，此處不再贅述。

● 官方文檔

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-listcontainer-0000001060007847

接著調(diào)用“getHomeArticle方法”請(qǐng)求服務(wù)器，“getHomeArticle方法”會(huì)獲取在AbilityPackage里面創(chuàng)建好的對(duì)象，然后執(zhí)行網(wǎng)絡(luò)請(qǐng)求，請(qǐng)求成功后調(diào)用“setHomeArticle方法”來(lái)刷新頁(yè)面。

public class MainAbilitySlice extends AbilitySlice {

private ListContainer mListContainer; private HomeArticleProvider mHomeArticleProvider; List《Article.Data.Datas》 mDatas;

@Override public void onStart（Intent intent） { super.onStart（intent）; super.setUIContent（ResourceTable.Layout_ability_main）; mListContainer = （ListContainer） findComponentById（ResourceTable.Id_list）; mDatas = new ArrayList《》（）; mHomeArticleProvider = new HomeArticleProvider（this， mDatas）; mListContainer.setItemProvider（mHomeArticleProvider）; // 從服務(wù)端獲取數(shù)據(jù) getHomeArticle（）; }

/** * 從服務(wù)端獲取數(shù)據(jù) */ public void getHomeArticle（） { BaseApplication.getInstance（）.getWan（）.getHomeArticle（0）.enqueue（new Callback《Article》（） { @Override public void onResponse（Call《Article》 call， Response《Article》 response） { if （response.isSuccessful（）） { // 請(qǐng)求成功 setHomeArticle（response.body（））; } }

@Override public void onFailure（Call《Article》 call， Throwable t） { // 請(qǐng)求失敗 LogUtils.info（“yunfei”， t.getMessage（））; } }）; }

@Override public void onActive（） { super.onActive（）; }

@Override public void onForeground（Intent intent） { super.onForeground（intent）; }

public void setHomeArticle（Article article） { if （article == null || article.data == null || article.data.datas == null） { return; } mDatas.addAll（article.data.datas）; // 刷新列表 mHomeArticleProvider.notifyDataChanged（）; }

}

（左右滑動(dòng)查看更多）

04

關(guān)于轉(zhuǎn)義字符問(wèn)題的解決

如果服務(wù)端返回的json有特殊字符，比如中文的雙引號(hào)。gson在解析的時(shí)候會(huì)對(duì)特殊字符進(jìn)行轉(zhuǎn)義，這時(shí)就需要將轉(zhuǎn)義后的字符串進(jìn)行反轉(zhuǎn)義。如下圖所示：

如何將轉(zhuǎn)義后的字符串進(jìn)行反轉(zhuǎn)義？commons-lang這個(gè)庫(kù)可以將轉(zhuǎn)義后的字符串進(jìn)行反轉(zhuǎn)義，在build.gradle文件添加下的依賴。

// commons-lang可以對(duì)特殊字符進(jìn)行轉(zhuǎn)義和反轉(zhuǎn)義implementation ‘commons-lang2.6’

調(diào)用StringEscapeUtils的unescapeHtml方法，如果字符串中沒(méi)有轉(zhuǎn)義字符，unescapeHtml方法會(huì)直接返回原字符串，否則會(huì)對(duì)字符串進(jìn)行反轉(zhuǎn)義。具體的代碼可查看示例代碼中的HomeArticleProvider類。

// json里面有一些特殊符號(hào)，特殊符號(hào)會(huì)被gson轉(zhuǎn)義，// StringEscapeUtils可以對(duì)轉(zhuǎn)義的字符串進(jìn)行反轉(zhuǎn)義String title = StringEscapeUtils.unescapeHtml（data.title）;componentHolder.title.setText（title）;

反轉(zhuǎn)義之后，特殊字符即可正常顯示：

溫馨提示：如果開(kāi)發(fā)者具備以下知識(shí)的基礎(chǔ)，看源碼的時(shí)會(huì)更加輕松哦。

熟悉okhttp的常見(jiàn)用法

熟悉面向接口編程、反射、泛型、注解

熟悉構(gòu)造者模式、適配器模式、工廠模式、策略模式、靜態(tài)代理、動(dòng)態(tài)代理、責(zé)任鏈模式等設(shè)計(jì)模式

Demo剛運(yùn)行的時(shí)候頁(yè)面可能會(huì)出現(xiàn)白屏的情況，是因?yàn)榇藭r(shí)正在請(qǐng)求網(wǎng)絡(luò)?？梢栽黾右粋€(gè)進(jìn)度條來(lái)提升用戶體驗(yàn)，大家可以自行添加~

目前只獲取了第一頁(yè)的文章列表，有興趣的開(kāi)發(fā)者可以自行實(shí)現(xiàn)分頁(yè)加載，讓內(nèi)容更加豐富，由于篇幅有限，此處只展示簡(jiǎn)單的示例。

本文作者：裴云飛，愛(ài)奇藝應(yīng)用開(kāi)發(fā)工程師

編輯：jq