【HarmonyOS】元服务服务卡片网络开发

【关键字】服务卡片、元服务、API6、网络请求、图片加载

一、API6服务卡片Java代码中如何进行网络请求？

API6服务卡片基于FormAbility，一般元服务默认工程中的FormAbility就是MainAbility。由于FormAbility是Java语言编写的，可以使okhttp进行网络请求相关的开发。

1、添加依赖：

首先在entry的build.gradle中添加如下依赖：

dependencies {
 
    implementation 'com.squareup.okhttp3:okhttp:3.14.9'
 
}

Okhttp相关的使用可以参考Okhttp官网文档，链接如下：Overview - OkHttp (square.github.io)

2、使用方法，这边以Get请求为例，说明一下Okhttp的简单用法：

初始化OkhttpClient和request：

OkHttpClient okHttpClient = new OkHttpClient();
 
Request request = new Request.Builder()
 
        .url(url)//请求地址
 
        .get()//Get方式请求
 
        .build();

a、同步请求：

try {
 
    Response response=okHttpClient.newCall(request).execute();
 
    if(response.isSuccessful()){
 
        HiLog.info(TAG,"response success "+response.body().string());
 
        response.close();
 
    }
 
} catch (IOException e) {
 
    throw new RuntimeException(e);
 
}

b、异步请求：

okHttpClient.newCall(request).enqueue(new Callback() {
 
    @Override
 
    public void onFailure(Call call, IOException e) {
 
        e.printStackTrace();
 
    }
 
 
 
    @Override
 
    public void onResponse(Call call, Response response) throws IOException {
 
        try{
 
            if (response.isSuccessful()) {
 
                HiLog.info(TAG,"response success "+response.body().string());
 
                response.close();
 
            }
 
        } catch (IOException e) {
 
             throw new IOException(e);
 
        }
 
    }
 
});

我们通过使用okhttputils工具类库可以进一步简化请求代码：

Okhttputils使用说明：okhttputils: 对okhttp的封装类 (gitee.com)

依赖引用：

dependencies {
 
   implementation 'io.openharmony.tpc.thirdlib:okhttputils:1.0.1'
 
}

同步请求：

 Response response = OkHttpUtils
    .get()//
    .url(url)//
    .tag(this)//
    .build()//
    .execute();

异步请求：

String url = "http://www.csdn.net/";
OkHttpUtils
    .get()
    .url(url)
    .addParams("username", "hyman")
    .addParams("password", "123")
    .build()
    .execute(new StringCallback()
	        {
	            @Override
	            public void onError(Request request, Exception e)
	            {
	                
	            }
	
	            @Override
	            public void onResponse(String response)
	            {
	
	            }
	        });

二、如何通过网络请求数据进行服务卡片初始化？

由于我们是FormAbility的onCreateForm中完成卡片的创建，下面以创建卡片为例，说明该如何完成网络数据创建卡片。

如官网的示例中我们需要在onCreateForm中创建ProviderFormInfo，所以我们可以将通过网络请求获取的数据传入FormBindingData中，完成卡片的的初始化。

​

需要注意的是，在初始化卡片的时候，需要使用的Okhttp进行同步请求，请求完成后将数据传入FormBindingData，以下代码使用OkHttpUtils编写,，封装一个getData方法返回FormBindingData对象：

public FormBindingData getData(){
 
    try {
 
        Response response=OkHttpUtils.get().url("url").build().execute();
 
        String str=response.body().string();
 
        HiLog.info(TAG, "onCreateForm: body "+str);
 
        response.close();
 
        return  new FormBindingData(str);
 
    } catch (Exception e) {
 
        HiLog.info(TAG, "onCreateForm: Exception "+e.toString()+" "+e.getMessage());
 
    }
 
    return new FormBindingData();
 
}

也可以通过ZSONObject获取java bean后，创建FormBindingData对象，如下：

public FormBindingData getData(){
 
    try {
 
        Response response=OkHttpUtils.get().url("url").build().execute();
 
        String str=response.body().string();
 
        HiLog.info(TAG, "onCreateForm: body "+str);
 
        response.close();
 
        HotData hotData=ZSONObject.stringToClass(str, HotData.class);//str转化为java对象
 
        ZSONObject zsonObject = new ZSONObject();
 
        zsonObject.put("data",hotData.getData());//获取对象中的字段，赋值给ZSONObject
 
        return new FormBindingData(zsonObject);//通过ZSONObject创建FormBindingData
 
    } catch (Exception e) {
 
        HiLog.info(TAG, "onCreateForm: Exception "+e.toString()+" "+e.getMessage());
 
    }
 
    return new FormBindingData();
 
}

创建FormBindingData后传入formInfo完成卡片初始化：

ProviderFormInfo formInfo = new ProviderFormInfo();
 
formInfo.setJsBindingData(getData());
 
return formInfo;

三、如何在卡片触发事件和定时定点刷新时通过网络请求刷新卡片内容？

卡片的点击事件会在onTriggerFormEvent中触发，定时定点刷新需要在onUpdateform中完成，所有的更新卡片的操作都是通过updateForm(formId, formBindingData)方法完成的。所以，同样可以使用getData方法获取formBindingData后就可以进行卡片内容的刷新。

四、如何加载网络图片?

加载网络图片，官网是通过内存图片的方式进行加载的，参考链接如下：文档中心

同样我们可以使用okhttp获取网络图片的bytes内容，然后通过formBindingData.addImageData("xxx.png", bytes)的方式进行图片内容的绑定。

bytes数据可以用以下方法获取

public byte[] getImageData(String url){
 
    byte[] bytes=null;
 
    try {
 
        Response response=OkHttpUtils.get().url(url).build().execute();
 
        if(response.isSuccessful()){
 
            if(response.body()!=null){
 
                bytes= response.body().bytes();
 
            }
 
            response.close();
 
            HiLog.info(TAG, "getImageData: success");
 
        }else{
 
            HiLog.info(TAG, "getImageData: failed");
 
        }
 
    } catch (IOException e) {
 
        throw new RuntimeException(e);
 
    }
 
    return bytes;
 
}

然后在onCreateForm中参考官网方法进行初始化：

@Override
 
protected ProviderFormInfo onCreateForm(Intent intent) {
 
    HiLog.info(TAG, "onCreateForm");
 
    ZSONObject zsonObject = new ZSONObject();
 
    String image="logo"+System.currentTimeMillis()+".png";
 
    HiLog.info(TAG, "onCreateForm: image=" + image);
 
    zsonObject.put("imageSrc", "memory://"+image);
 
    FormBindingData formBindingData = new FormBindingData(zsonObject);
 
    ProviderFormInfo formInfo = new ProviderFormInfo();
 
    formBindingData.addImageData(image,getImageData("url"));
 
    formInfo.setJsBindingData(formBindingData);
 
    return formInfo;
 
}

定时刷新和点击触发刷新同理，就不再赘述了。