「江鸟中原」有关HarmonyOS-ArkTS的Http通信请求

一、Http简介

        HTTP（Hypertext Transfer Protocol）是一种用于在Web应用程序之间进行通信的协议，通过运输层的TCP协议建立连接、传输数据。Http通信数据以报文的形式进行传输。Http的一次事务包括一个请求和一个响应。

        Http通信是基于客户端-服务器模型的，其中客户端发送Http请求到服务器，服务器则返回Http响应给客户端。Http通信通常使用TCP/IP作为传输协议，通过指定的端口（默认为80端口）进行通信。

        在Http通信中，客户端发送的请求由以下几部分组成：

        1. 请求行：包含HTTP方法（如GET、POST等）、请求的URL和HTTP协议版本。

        2. 请求头部：包含额外的请求信息，如请求的内容类型、授权信息等。

        3. 请求体（可选）：用于传输请求的数据，例如在POST请求中传递表单数据或JSON数据。

        服务器接收到请求后，会进行处理，并返回Http响应给客户端。Http响应由以下几部分组成：

        1. 状态行：包含Http协议版本、状态码和对应的状态消息。

        2. 响应头部：包含额外的响应信息，如响应的内容类型、长度、缓存设置等。

        3. 响应体（可选）：包含服务器返回的实际数据，例如HTML页面内容、JSON数据等。

        通过HTTP通信，客户端可以向服务器发起请求并获取响应，实现了Web应用程序之间的数据交换和信息传输。

二、基于ArkTS开发中的Http通信

        而在HarmonyOS基于ArkTS语言中使用Http通信，需要先获得 ohos. permission. INTERNET 权限，再导入@ohos.net.Http模块,并调用createHttp()方法创建一个Http通信类实例,该方法会返回一个HttpRequest对象实例。但是每个HttpRequest实例对应一个Http请求，如果要发起多个Http请求，则需要为每个Http请求生成一个HttpRequest实例。

 1、Http通信的相关接口

        createHttp()                             ：创建一个Http请求    
        request()                                  ：根据 URL 网址，发起Http网络请求    
        on(type:'headersReceive')    ：订阅 Http Response Header事件    
        off(type:'headersReceive')    ：取消订阅HttpResponse Header事件
        destroy()                                  ：中断请求任务    

2、开发基本流程

        (1)导人@ohos.net.Http模块。
        (2)调用createHttp()方法创建一个HTTP通信类实例。
        (3)根据需求,通过on()方法订阅响应头时间。
        (4)调用request()方法向用户输入URL,发起一个Http请求报文。        
        (5)根据需求,处理通信对方的Http响应报文。

三、Http访问示例

        不设置Http请求方式参数，则默认方式为GET。其他方法还有HEAD、PUT、DELETE、TRACE、CONNECT。

        先在module.josn5添加ohos. permission. INTERNET权限

1、GET请求示例

import http from '@ohos.net.http'
@Entry
@Component
struct Index {
  @State message: string = 'Hello World'
  //GET网络请求函数
  getUserName(){
    let httpRequest = http.createHttp()
    let url = 'XXX';
    httpRequest.request(url,{//设置请求报文的参数
      method: http.RequestMethod.GET, //以GET方式请求
      connectTimeout:10000,	//连接超时时间ms
      readTimeout:10000//读取超时时间ms
    },(err,data)=>{//回调函数返回数据
      //通过控制台查看返回的数据
      console.info("data:" + JSON.stringify(data.result))
      console.info("data:" + JSON.stringify(data.responseCode))
      console.info("data:" + JSON.stringify(err))
      if(err){
        this.message = JSON.stringify(err)//将错误信息显示
      } else {
        if(data.responseCode == 200){//请求有效将用户名称显示
          this.message = JSON.parse(data.result.toString()).data.name
        } else {//无效请求则将状态码显示
          this.message = data.responseCode + '40'
        }
      }
    })
  }
  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        //手动点击发送GET网络请求
        Button('发送请求').onClick(()=>{
          this.getUserName()
        })
      }
      .width('100%')
    }
    .height('100%')
  }
}

        在界面中显示一个Text文本，一个发送请求的Button按钮，点击Button后就会发送GET网络请求，声明一个用于发送GET网络请求的函数。在这个示例中我们会发送请求获取用户信息，显示用户的名称。

2、POST请求示例

import http from '@ohos.net.http';
let httpRequest = http.createHttp();
let url = 'XXX'; //准备你要请求的url地址
let requestOptions = {	//设置请求报文的参数
  method: http.RequestMethod.POST, //以POST方式请求
  header:{
    'Content - Type':'application/json'
  },
  extraData: {//发送额外的参数
    "data": "data to send",
  },
  connectTimeout:10000,	//连接超时时间ms
  readTimeout:10000//读取超时时间ms
}
//调用on()方法订阅响应头
httpRequest.on( 'headersReceive',(header) => {
  console.info( 'header:'+ JSON.stringify(header));});
//调用request()方法向对方发送请求报文
let res = httpRequest.request(url, requestOptions);
//通过Promise方式处理响应，返回到控制台
res.then((data) =>{
  console.info('header:'+ JSON.stringify(data.header));
  console.info('Content - Type:' + data.header['Content - Type']);
  console.info('Result:'+ data.result);
  console.info('code:'+ data.responseCode);
}).catch((err) =>{
  //处理请求异常信息并销毁请求
  console.info('error:'+ JSON.stringify(err));
  httpRequest.destroy( );
});

以上可能有一些错误和不足之处，如有更好的方法和建议，欢迎您在评论区友善讨论。