xref: /applications/standard/app_samples/code/BasicFeature/Connectivity/Http/

# HTTP

### Introduction

This sample shows how to use the **TextInput** component to enter parameters and use the **Text** component to display the return result.

In this example, we'll use [SystemCapability.Communication.NetStack](https://gitee.com/openharmony/docs/blob/master/en/application-dev/reference/apis/js-apis-http.md) to initiate HTTP network requests to the destination URL based on specified configuration.

Usage

1. When starting the sample application, configure the network request by specifying the destination URL, request mode, and request parameters.

2. Click **OK**. The request result page is displayed.

3. Click **Back** to return to the configuration page.

NOTE: You can compile the http module into a **.tgz** package depending on your need.

### Display Effect

![](screenshots/device/index.png) ![](screenshots/device/result.png)

### Required Permissions

Access to the Internet: [ohos.permission.INTERNET](https://gitee.com/openharmony/docs/blob/master/en/application-dev/security/permission-list.md)

### Dependency

N/A

### Constraints

1. This sample can only be run on standard-system devices that use the Rockchip RK3568 chip.

2. This sample demonstrates the stage model, which supports only the SDK of API version 10 (SDK version: 4.0 Release).

3. DevEco Studio 4.0 Release must be used.

4. This sample requires network connection throughout the entire process.

# Http

### 介绍

本示例通过[@ohos.net.http](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-network-kit/js-apis-http.md)
等接口，实现了根据URL地址和相关配置项发起http请求的功能。

### 效果预览

|首页|结果页|
|--------------------------------|--------------------------------|
|![](screenshots/device/index.png)|![](screenshots/device/result.png)

使用说明

1.启动应用可配置网络请求，设置网址、请求方式、请求参数；

2.点击确认按钮，跳转请求结果页面；

3.点击返回按钮，返回配置页面；

4.支持将本示例中的http模块编译成tgz包。

### 工程目录

```
entry/src/main/ets/
|---Application
|---MainAbility
|   |---MainAbility.ts            // 项目入口，请求相关权限
|---page
|   |---Index.ets                 // 首页
|---util                          // 日志文件
http/src/main/ets/
|---components
|   |---MainPage
|   |   |---MainPage.ets          // 首页主体内容
|   |---model
|   |   |---http.ts               // 封装了http参数和发起请求的接口
```

### 具体实现

* 本示例将发送http请求的接口封装在Http模块，源码参考：[http.ts](http/src/main/ets/components/model/http.ts)
  * 发起请求：在[MainPage.ets](http/src/main/ets/components/MainPage/MainPage.ets)
  通过TextInput组件获取参数，点击“确认”按钮后通过Http.request()方法调用http.createHttp().request()接口向指定的地址发送请求。

### 相关权限

[ohos.permission.INTERNET](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissioninternet)

### 依赖

不涉及。

### 约束与限制

1.本示例仅支持标准系统上运行，支持设备：RK3568。

2.本示例为Stage模型，支持API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0 Release)

3.本示例需要使用DevEco Studio 版本号(4.0 Release)及以上版本才可编译运行。

4.运行本示例需全程联网。

### 下载

如需单独下载本工程，执行如下命令：

```
git init
git config core.sparsecheckout true
echo code/BasicFeature/Connectivity/Http/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master
```

Indexes created Thu Nov 07 10:32:03 CST 2024