## 创建项目
## 熟悉接口
地址：[汇率查询-ALAPI](https://www.alapi.cn/api/view/88)
接口地址： https://v2.alapi.cn/api/exchange
---
请求方法: [ "GET", "POST" ]
---
请求参数：
| 名称 | 必填 | 类型 | 描述 | 示例 |
| ----- | ----- | ------ | ------------------------- | ----------------- |
| token | true | string | 请求token，用户中心获取。 | 用户中心获取token |
| money | false | int | 要换算的金额，默认1 | 1 |
| from | | string | 来源货币 | USD |
| to | | string | 要转换的货币 | CNY |
---
返回参数:
| 名称 | 描述 |
| ------------------ | ----------------------------- |
| exchange | 汇率 |
| exchange_round | 四舍五入很汇率，保留 4 位小数 |
| currency_money | 货币金额 |
| currency_form | 原货币代码 |
| currency_form_name | 货币名称 |
| currency_to | 目标货币代码 |
| currency_to_name | 目标货币名称 |
| update_time | 更新时间 |
## 了解HTTP数据请求步骤
request接口开发步骤
1. [从@ohos.net.http中导入http命名空间。](mailto:%E4%BB%8E@ohos.net.http%E4%B8%AD%E5%AF%BC%E5%85%A5http%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4%E3%80%82)
2. 调用createHttp()方法，创建一个HttpRequest对象。
3. 调用该对象的on()方法，订阅http响应头事件，此接口会比request请求先返回。可以根据业务需要订阅此消息。
4. 调用该对象的request()方法，传入http请求的url地址和可选参数，发起网络请求。
5. 按照实际业务需要，解析返回结果。
6. 调用该对象的off()方法，取消订阅http响应头事件。
7. 当该请求使用完毕时，调用destroy()方法主动销毁。
第一步
```
// 引入包名
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
```
第二步
```
// 每一个httpRequest对应一个HTTP请求任务，不可复用
let httpRequest = http.createHttp();
```
第三步
```
// 从API 8开始，使用on('headersReceive', Callback)替代on('headerReceive', AsyncCallback)。
httpRequest.on('headersReceive', (header) => {
console.info('header: ' + JSON.stringify(header));
});
```
第四步
```
httpRequest.request(
// 填写HTTP请求的URL地址，可以带参数也可以不带参数。URL地址需要开发者自定义。请求的参数可以在extraData中指定
"https://v2.alapi.cn/api/exchange",
{
method: http.RequestMethod.POST, // 可选，默认为http.RequestMethod.GET
// 开发者根据自身业务需要添加header字段
header: {
'Content-Type': 'application/json'
},
// 当使用POST请求时此字段用于传递请求体内容，具体格式与服务端协商确定
extraData: {
"token": "f1ms5Hk0NiQWBKre",
"money": 1,
"from": "USD",
"to": "CNY"
},
expectDataType: http.HttpDataType.STRING, // 可选，指定返回数据的类型
usingCache: true, // 可选，默认为true
priority: 1, // 可选，默认为1
connectTimeout: 60000, // 可选，默认为60000ms
readTimeout: 60000, // 可选，默认为60000ms
usingProtocol: http.HttpProtocol.HTTP1_1, // 可选，协议类型默认值由系统自动指定
usingProxy: false, // 可选，默认不使用网络代理，自API 10开始支持该属性
}
```
第五步
```
"requestPermissions": [
{
"name": "ohos.permission.INTERNET"
}
],
```
第六步
```
{
"code": 200,
"msg": "success",
"data": {
"exchange":36.48143824422134,
"exchange_round": 36.4814,
"currency_money": 5,
"currency_form": "USD",
"currency_form_name":“美元”,
"currency_to": "CNY",
"currency_to_name":“人民币",
"update time": "2024-12-21 06:00:02"
},
"time": 1734785958,
"usage": 0,
"log_id": "729078914992795648"
}
```
## ## model
```
export class exchange {
code?: number = 0;
msg?: string = "";
data?: ExchangeData = new ExchangeData();
time?: number = 0;
usage?: number = 0;
log_id?: string = "";
}
export class ExchangeData {
exchange?: number = 0;
exchange_round?: number = 0;
currency_money?: number = 0;
currency_form?: string = "";
currency_form_name?: string = "";
currency_to?: string = "";
currency_to_name?: string = "";
update_time?: string = "";
}
```
## 完整代码
```
// 引入包名
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
import { exchange, ExchangeData } from "../model/exchange"
@Entry
@Component
struct Index {
@State value: number = 0
@State exchangeData: ExchangeData = new ExchangeData()
aboutToAppear(): void {
this.getData(1)
}
getData(mony: number) {
// 每一个httpRequest对应一个HTTP请求任务，不可复用
let httpRequest = http.createHttp();
// 从API 8开始，使用on('headersReceive', Callback)替代on('headerReceive', AsyncCallback)。
httpRequest.on('headersReceive', (header) => {
console.info('header: ' + JSON.stringify(header));
});
httpRequest.request(
// 填写HTTP请求的URL地址，可以带参数也可以不带参数。URL地址需要开发者自定义。请求的参数可以在extraData中指定
"https://v2.alapi.cn/api/exchange",
{
method: http.RequestMethod.POST, // 可选，默认为http.RequestMethod.GET
// 开发者根据自身业务需要添加header字段
header: {
'Content-Type': 'application/json'
},
// 当使用POST请求时此字段用于传递请求体内容，具体格式与服务端协商确定
extraData: {
"token": "f1ms5Hk0NiQWBKre",
"money": mony,
"from": "USD",
"to": "CNY"
},
expectDataType: http.HttpDataType.STRING, // 可选，指定返回数据的类型
usingCache: true, // 可选，默认为true
priority: 1, // 可选，默认为1
connectTimeout: 60000, // 可选，默认为60000ms
readTimeout: 60000, // 可选，默认为60000ms
usingProtocol: http.HttpProtocol.HTTP1_1, // 可选，协议类型默认值由系统自动指定
usingProxy: false, // 可选，默认不使用网络代理，自API 10开始支持该属性
}, (err: BusinessError, data: http.HttpResponse) => {
if (!err) {
// data.result为HTTP响应内容，可根据业务需要进行解析
let exchange: exchange = JSON.parse(data.result.toString())
this.exchangeData = exchange.data!
console.info('Result:' + JSON.stringify(data.result));
console.info('code:' + JSON.stringify(data.responseCode));
// data.header为HTTP响应头，可根据业务需要进行解析
console.info('header:' + JSON.stringify(data.header));
console.info('cookies:' + JSON.stringify(data.cookies)); // 8+
// 当该请求使用完毕时，调用destroy方法主动销毁
httpRequest.destroy();
} else {
console.error('error:' + JSON.stringify(err));
// 取消订阅HTTP响应头事件
httpRequest.off('headersReceive');
// 当该请求使用完毕时，调用destroy方法主动销毁
httpRequest.destroy();
}
}
);
}
build() {
Column() {
TextInput({
placeholder: " 请输入兑换的金额",
text: this.value.toString()
}).type(InputType.Number)
.onChange((e: string) => {
this.value = parseInt(e)
this.getData(parseInt(e))
})
Text(this.exchangeData.exchange
?.toString())
}
.height('100%')
.width('100%')
}
}
```
## 效果
## 参考
- [HTTP请求](https://developer.huawei.com/consumer/cn/doc/atomic-guides-V5/atomic-http-request-V5)
- **[ArkTS语法适配背景](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-migration-background-V5)**
- **[从TypeScript到ArkTS的适配规则](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/typescript-to-arkts-migration-guide-V5)**
- **[适配指导案例](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-more-cases-V5)**
|
发布问题
发布文章
