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

介绍

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

使用说明:

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

效果图预览

实现思路

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

    // 通过ImageKnifeGlobal.getInstance()获取唯一实例。如果此实例不存在,则将ImageKnife注入到当前context中。
    if (!ImageKnifeGlobal.getInstance().getImageKnife()) {
      const context: Context = getContext();
      if (context) {
        ImageKnife.with(context);
      }
    }
    
  2. 自定义请求头需要重新封装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;
        }
      })
    
  3. 在需要请求图片的地方,将步骤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);
    }
    

高性能知识点

不涉及

模块依赖

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

工程结构&模块类型

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

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
  • 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
  • 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新学习知识点,请移步前往小编:https://gitee.com/MNxiaona/733GH/blob/master/jianshu
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容