HarmonyOS---权限和http/Axios网络请求

网络请求(http,axios)

一、应用权限管理

应用权限保护的对象分数据和功能的：

• 数据：个人(照片，通讯录，日历，位置)、设备(标识码，相机，麦克风)

• 功能：设备(摄像头/麦克风、电话、联网)、应用(悬浮窗、快捷方式、唤起第三方应用、后台运行)

1.1权限的等级

system_core： 该等级提供应用服务操作系统的 - 核心能力
system_basic：该等级提供应用服务的 - 基础服务
normal： 普通的基本应用：默认

1.2授权方式

system_grant：系统授权
指的是系统类型的权限，应用被允许访问的数据不会涉及到用户或设备的敏感信息
安装应用是，应用会询问系统，系统会自动进行授权。
user_grant：用户授权
指的是涉及用户隐私或敏感数据的，如果出现问题，是不可控的。
应用安装后，运行时，会指定弹窗，询问用户是否允许获取权限。

1.3声明权限的配置

在 entry/src/main/module.json5 配置文件中，声明权限：

例：当不需要用户确认和用户确认运行都需要在requestPermissions[]中进行配置:

1. 不需要用户确认:
	{
        "name": "ohos.permission.INTERNET"  //权限名称：网络
      },
2. 用户确认 (当需要用户确认时，填写配置信息会有提示，不填则报错)
例：在卡片Call机制中也用到了,保持后台应用：
格式：
	{
        "name": "ohos.permission.LOCATION", //定位
        "reason": "$string:reason_loc",      //描述申请的原因：user_grant时，必填项，因为需要国际化需要在语言文件中设置才可以
        "usedScene": {                       //描述权限使用的场景：user_grant时，必填项
          "abilities": [ "EntryAbility" ],   //标识需要使用该权限的 Ability
          "when": "always"                   //标识使用的时机：inuse：只允许前台， always：前后台都允许
        }

1.4如何向用户进行申请

例:定位
import abilityAccessCtrl from '@ohos.abilityAccessCtrl'; //权限控制管理

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    //唤醒用户授权窗口，只有在user_grant情况下有效
    try{
      //创建一个权限管理对象
      const manager = abilityAccessCtrl.createAtManager()
      //基于管理对象，申请用户授权
      manager.requestPermissionsFromUser( this.context, [
        "ohos.permission.LOCATION",
        "ohos.permission.APPROXIMATELY_LOCATION",
        ...
      ] )
    }
    catch(err){
      promptAction.showToast({message:'获取位置失败！'})
    }
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
  }

扩展：请求方式
GET：
短文本请求，是一种不安全的请求，所有的信息都暴露在地址栏中。
内容的上限是255个字节。
通常都是直接打开网址、超链接a它们使用。
POST：
长文本请求，是一种安全的请求，基于http超文本传输协议的。
数据信息是通过TCP/IP请求协议进行处理的，用户不可见。
数据上限：2MB
如今，我们有一个RestFul请求风格定义，它扩展了更多的请求方式：并不是所有后端服务器都支持

PUT：
    本质还是post请求。

DELETE：
    本质还是get请求。

二、内置http请求使用

可能会存在个版本不兼容问题：建议使用Axios

1.开启网络权限: 'ohos.permission.INTERNET'
2.导包: import http from '@ohos.net.http'
3.请求:
 		//创建网络请求对象
        const httpRequest:http.HttpRequest = http.createHttp()
		// 方式一:异步
        //异步方法:data就是响应回发的结果
        //httpRequest.request('url', {...}, (err,data)=>{})

		// 方式二: 同步
        //转同步操作
        try{
          const res:http.HttpResponse = await httpRequest.request(
            'https://jsonplaceholder.typicode.com/users',
            {method: http.RequestMethod.GET}   //get请求方式：默认
          )
          //处理请求结果：得到一个json对象
          console.info('http===', res.responseCode)           //状态码
          console.info('http===', JSON.stringify(res.header)) //头部信息
          console.info('http===', JSON.stringify(res.result)) //数据结果
        }
        catch(err){
          console.info('http===', err)
        }
        finally{
          //不管成功还是失败，最终，始终关闭请求对象
          httpRequest.destroy()
        }

封装工具包格式:
 // 内置http
import http from '@ohos.net.http'
import promptAction from '@ohos.promptAction'

export default class HttpUtils {
  // 青云客:(第三方)
  private static readonly path: string = 'http://api.qingyunke.com'
  // 美团:(个人)
  // https://atstudy-1253850831.cos.ap-shanghai.mygcloud.com
  static async httpRequest(url: string, method: http.RequestMethod = http.RequestMethod.GET,
    extraData: string | Object | ArrayBuffer = ''): Promise<http.HttpResponse> {
    const link = http.createHttp()
    let res: http.HttpResponse = {} as http.HttpResponse
    try {
      res = await link.request(HttpUtils.path + url, {
        method: method, extraData: extraData
      })
    } catch (err) {
      promptAction.showToast({
        message: '网络请求异常' + JSON.stringify(err)
      })
    } finally {
      //不管成功还是失败，最终，始终关闭请求对象
      link.destroy()
    }
    return res

    //处理请求结果：得到一个json对象
    // console.info('http===', res.responseCode)           //状态码
    // console.info('http===', JSON.stringify(res.header)) //头部信息
    // console.info('http===', JSON.stringify(res.result)) //数据结果
  }
}

三、Axios请求使用（建议）

使用Axios需要安装ohpm中的 axios依赖或者在oh-package.json5 加入依赖
方式一：根据命令安装：ohpm install @ohos/axios
方式二：“@ohos/axios”：“^2.2.0”

3.1 使用方式一

直接调用get()，post(), 不建议使用，原因路径每次都是完整的，有重复性

例:
开启网络权限: 'ohos.permission.INTERNET'
导包: import axios  from '@ohos/axios'
axios.get('url',{params:{}})
axios.post('url')

3.2 使用方式二（建议）

定义出来公用部分，若不相同可以在调用时进行覆盖

例:
开启网络权限: 'ohos.permission.INTERNET'
导包: import axios  from '@ohos/axios'
// 1.公共部分
 const cont =  axios.create({
    baseURL:'https://atstudy-1253850831.cos.ap-shanghai.myqcloud.com', // 公用部分的url
    //transformRequest:()=>{}, // 发送请求前的操作函数 // 知道别用出错有点难找
    //transformResponse:()=>{}, // 接收结果  // 知道别用出错有点难找
    timeout:3*1000, // 请求超时时间
    headers:{} // 头部数据
  })
  // 格式： 2.调用 cont.get() /  cont.post()
  // 此处使用的异步，也可以转为async同步
  cont.get('/lab-d3/harmonyOS/meituan/shop.json',
		 {timeout:6*1000} // 重写超时时间
		 ).then((res: AxiosResponse) => {
	       if (res.status == 200) { // 状态码
	         res.data // 返回数据
	       }
	     })
	       .catch((err: BusinessError) => {
	         promptAction.showToast({ message: "get请求异常"})
	       })
	       .finally(() => {  })

Axios工具包:
当需要多个url时则就需要发生变更了，使用构造传参方式就可以
import axios, { AxiosInstance } from '@ohos/axios'
export default class AxiosUtils {
  // 青云客:(第三方)
  private static readonly path: string = 'http://api.qingyunke.com'
  private static  link(): AxiosInstance {
    return axios.create({
      baseURL: AxiosUtils.path,
      timeout:3*1000, // 请求超时时间
      headers:{}, // 头部数据
      timeoutErrorMessage: '连接超时'
    })
  }

  public static get(url: string,params:string='' ) {
    return AxiosUtils.link().get(url+'?'+params)
  }
  public static post(url: string,data:ResourceStr|object='' ) {
    return AxiosUtils.link().post(url,data)
  }
}