纯血鸿蒙APP第三方库——配置ImageKnife请求头实现防盗链

原创

小帅聊鸿蒙

发布于 2025-01-21 14:22:02

1170

介绍

目前许多网络图片资源有防盗链功能，需要在请求头中设置正确的Referer。本模块使用了第三方库imageknife，通过在请求头中添加Referer来获取防盗链图片功能。同时我们可以设置请求头中的其他参数，比如User-Agent来设置客户端，Origin设置来源，ETag来设置缓存等等。

使用说明：

输入需要获取的图片URL和Referer。
点击请求，等待下方出现图片。

效果图预览

实现思路

在工程入口导入三方库imageKnife，并且进行初始化，。

    // 通过ImageKnifeGlobal.getInstance()获取唯一实例。如果此实例不存在，则将ImageKnife注入到当前context中。
    if (!ImageKnifeGlobal.getInstance().getImageKnife()) {
      const context: Context = getContext();
      if (context) {
        ImageKnife.with(context);
      }
    }

自定义请求头需要重新封装RequestOption对象，使用addHeader方法配置请求头，load方法设置需要请求的地址，errorholder方法设置请求失败回调，addListener方法设置成功回调等配置，最后在成功/失败回调中的图片赋值给图片组件。

    // TODO: 知识点：自定义RequestOption来获取image图片。
    const request = new RequestOption();
    // TODO: 知识点：使用addHeader添加请求头。
    request.addHeader('Referer', ref);
    request.skipMemoryCache(true)
      .diskCacheStrategy(new NONE()) // 取消磁盘缓存
      .errorholder($r('app.media.image_theft_failed'), {
        asyncSuccess: (data: ImageKnifeData) => {
          if (data.isPixelMap()) {
            this.imageKnifeOption.loadSrc = data.drawPixelMap?.imagePixelMap;
          }
        }
      })
      .load(url) // TODO: 知识点：添加请求url。
      .addListener({ // TODO: 知识点：添加请求回调监听器。
        callback: (err: BusinessError | string, data: ImageKnifeData) => {
          if (data.isPixelMap()) {
            if (data.drawPixelMap) {
              // TODO: 知识点：在这里获取到请求返回的图片，将图片赋值给imageKnifeOption.loadSrc。
              this.imageKnifeOption.loadSrc = data.drawPixelMap.imagePixelMap;
            } else {
              this.imageKnifeOption.loadSrc = $r('app.media.image_theft_failed');
            }
          }
          return true;
        }
      })

DD一下：`欢迎大家关注公众号<程序猿百晓生>，可以了解到一下知识点。`

1.OpenHarmony开发基础
2.OpenHarmony北向开发环境搭建
3.鸿蒙南向开发环境的搭建
4.鸿蒙生态应用开发白皮书V2.0 & V3.0
5.鸿蒙开发面试真题（含参考答案） 
6.TypeScript入门学习手册
7.OpenHarmony 经典面试题(含参考答案)
8.OpenHarmony设备开发入门【最新版】
9.沉浸式剖析OpenHarmony源代码
10.系统定制指南
11.【OpenHarmony】Uboot 驱动加载流程
12.OpenHarmony构建系统--GN与子系统、部件、模块详解
13.ohos开机init启动流程
14.鸿蒙版性能优化指南
.......

在需要请求图片的地方，将步骤2中自定义的RequestOption对象传入imageknife实例的call函数。

    const compSize: Size = {
      width: IMAGE_THEFT_IMAGEKNIFE_COMPONENT_WIDTH,
      height: IMAGE_THEFT_IMAGEKNIFE_COMPONENT_HEIGHT
    };
    // (必传)这里setImageViewSize函数必传初始组件大小，因为涉及到图片变换效果都需要适配图像源和组件大小。
    // TODO: 知识点：如果是自适应组件等不确定初始图片宽高的情况，可以通过getInspectorByKey获取，参考https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs/faqs-arkui-kit-0000001769732210#section10880155113412。
    request.setImageViewSize(compSize);
    // 最后使用ImageKnife的call函数调用request即可
    const imageKnife: ImageKnife | undefined = ImageKnifeGlobal.getInstance().getImageKnife();
    if (imageKnife !== undefined) {
      // 由于本例需要通过改变请求头刷新图片，并不需要图片缓存，所以设置磁盘Lru缓存数量设置成0张，0字节，正常业务不需要此设置。
      imageKnife.setLruCacheSize(0, 0);
      imageKnife.call(request);
    }

高性能知识点

不涉及

模块依赖

本实例依赖common模块来实现公共组件FunctionDescription。
本实例依赖路由模块来注册路由。
本实例依赖@ohos/imageknife的2.1.2-rc.6及以上版本。

工程结构&模块类型

imagetheft                                      // har类型
|---constants                                   
|---|---Constants.ets                           // 存放常量
|---view                                        
|---|---ImageTheft.ets                          // 视图层-获取防盗链图片入口