提交 645aafa8 编写于 作者: Y Yangys

request2 API name change

Signed-off-by: NYangys <yangyousheng@huawei.com>
上级 bae87b24
......@@ -18,7 +18,7 @@ HTTP数据请求功能主要由http模块提供。
| ----------------------------------------- | ----------------------------------- |
| createHttp() | 创建一个http请求。 |
| request() | 根据URL地址,发起HTTP网络请求。 |
| request2()<sup>10+</sup> | 根据URL地址,发起HTTP网络请求并返回流式响应|
| requestInStream()<sup>10+</sup> | 根据URL地址,发起HTTP网络请求并返回流式响应|
| destroy() | 中断请求任务。 |
| on(type: 'headersReceive') | 订阅HTTP Response Header 事件。 |
| off(type: 'headersReceive') | 取消订阅HTTP Response Header 事件。 |
......@@ -27,8 +27,8 @@ HTTP数据请求功能主要由http模块提供。
| off\('dataReceive'\)<sup>10+</sup> | 取消订阅HTTP流式响应数据接收事件。 |
| on\('dataEnd'\)<sup>10+</sup> | 订阅HTTP流式响应数据接收完毕事件。 |
| off\('dataEnd'\)<sup>10+</sup> | 取消订阅HTTP流式响应数据接收完毕事件。 |
| on\('dataProgress'\)<sup>10+</sup> | 订阅HTTP流式响应数据接收进度事件。 |
| off\('dataProgress'\)<sup>10+</sup> | 取消订阅HTTP流式响应数据接收进度事件。 |
| on\('dataReceiveProgress'\)<sup>10+</sup> | 订阅HTTP流式响应数据接收进度事件。 |
| off\('dataReceiveProgress'\)<sup>10+</sup> | 取消订阅HTTP流式响应数据接收进度事件。 |
## request接口开发步骤
......@@ -91,12 +91,12 @@ httpRequest.request(
);
```
## request2接口开发步骤
## requestInStream接口开发步骤
1. 从@ohos.net.http.d.ts中导入http命名空间。
2. 调用createHttp()方法,创建一个HttpRequest对象。
3. 调用该对象的on()方法,可以根据业务需要订阅HTTP响应头事件、HTTP流式响应数据接收事件、HTTP流式响应数据接收进度事件和HTTP流式响应数据接收完毕事件。
4. 调用该对象的request2()方法,传入http请求的url地址和可选参数,发起网络请求。
4. 调用该对象的requestInStream()方法,传入http请求的url地址和可选参数,发起网络请求。
5. 按照实际业务需要,可以解析返回的响应码。
6. 调用该对象的off()方法,取消订阅相应事件。
7. 当该请求使用完毕时,调用destroy()方法主动销毁。
......@@ -122,11 +122,11 @@ httpRequest.on('dataEnd', () => {
console.info('No more data in response, data receive end');
});
// 用于订阅HTTP流式响应数据接收进度事件
httpRequest.on('dataProgress', (data) => {
console.log("dataProgress receiveSize:" + data.receiveSize + ", totalSize:" + data.totalSize);
httpRequest.on('dataReceiveProgress', (data) => {
console.log("dataReceiveProgress receiveSize:" + data.receiveSize + ", totalSize:" + data.totalSize);
});
httpRequest.request2(
httpRequest.requestInStream(
// 填写HTTP请求的URL地址,可以带参数也可以不带参数。URL地址需要开发者自定义。请求的参数可以在extraData中指定
"EXAMPLE_URL",
{
......@@ -153,7 +153,7 @@ httpRequest.request2(
// 取消订阅HTTP流式响应数据接收事件
httpRequest.off('dataReceive');
// 取消订阅HTTP流式响应数据接收进度事件
httpRequest.off('dataProgress');
httpRequest.off('dataReceiveProgress');
// 取消订阅HTTP流式响应数据接收完毕事件
httpRequest.off('dataEnd');
// 当该请求使用完毕时,调用destroy方法主动销毁
......
......@@ -86,7 +86,7 @@ createHttp(): HttpRequest
| 类型 | 说明 |
| :---------- | :----------------------------------------------------------- |
| HttpRequest | 返回一个HttpRequest对象,里面包括request、request2、destroy、on和off方法。 |
| HttpRequest | 返回一个HttpRequest对象,里面包括request、requestInStream、destroy、on和off方法。 |
**示例:**
......@@ -364,9 +364,9 @@ destroy(): void
httpRequest.destroy();
```
### request2<sup>10+</sup>
### requestInStream<sup>10+</sup>
request2(url: string, callback: AsyncCallback\<number\>): void
requestInStream(url: string, callback: AsyncCallback\<number\>): void
根据URL地址,发起HTTP网络请求并返回流式响应,使用callback方式作为异步方法。
......@@ -424,18 +424,18 @@ request2(url: string, callback: AsyncCallback\<number\>): void
**示例:**
```js
httpRequest.request2("EXAMPLE_URL", (err, data) => {
httpRequest.requestInStream("EXAMPLE_URL", (err, data) => {
if (!err) {
console.info("request2 OK! ResponseCode is " + JSON.stringify(data));
console.info("requestInStream OK! ResponseCode is " + JSON.stringify(data));
} else {
console.info("request2 ERROR : err = " + JSON.stringify(err));
console.info("requestInStream ERROR : err = " + JSON.stringify(err));
}
})
```
### request2<sup>10+</sup>
### requestInStream<sup>10+</sup>
request2(url: string, options: HttpRequestOptions, callback: AsyncCallback\<number\>): void
requestInStream(url: string, options: HttpRequestOptions, callback: AsyncCallback\<number\>): void
根据URL地址和相关配置项,发起HTTP网络请求并返回流式响应,使用callback方式作为异步方法。
......@@ -494,7 +494,7 @@ request2(url: string, options: HttpRequestOptions, callback: AsyncCallback\<numb
**示例:**
```js
httpRequest.request2("EXAMPLE_URL",
httpRequest.requestInStream("EXAMPLE_URL",
{
method: http.RequestMethod.GET,
header: {
......@@ -504,16 +504,16 @@ httpRequest.request2("EXAMPLE_URL",
connectTimeout: 60000
}, (err, data) => {
if (!err) {
console.info("request2 OK! ResponseCode is " + JSON.stringify(data));
console.info("requestInStream OK! ResponseCode is " + JSON.stringify(data));
} else {
console.info("request2 ERROR : err = " + JSON.stringify(err));
console.info("requestInStream ERROR : err = " + JSON.stringify(err));
}
})
```
### request2<sup>10+</sup>
### requestInStream<sup>10+</sup>
request2(url: string, options? : HttpRequestOptions): Promise\<number\>
requestInStream(url: string, options? : HttpRequestOptions): Promise\<number\>
根据URL地址,发起HTTP网络请求并返回流式响应,使用Promise方式作为异步方法。
......@@ -577,7 +577,7 @@ request2(url: string, options? : HttpRequestOptions): Promise\<number\>
**示例:**
```js
let promise = httpRequest.request2("EXAMPLE_URL", {
let promise = httpRequest.requestInStream("EXAMPLE_URL", {
method: http.RequestMethod.GET,
connectTimeout: 60000,
readTimeout: 60000,
......@@ -586,9 +586,9 @@ let promise = httpRequest.request2("EXAMPLE_URL", {
}
});
promise.then((data) => {
console.info("request2 OK!" + JSON.stringify(data));
console.info("requestInStream OK!" + JSON.stringify(data));
}).catch((err) => {
console.info("request2 ERROR : err = " + JSON.stringify(err));
console.info("requestInStream ERROR : err = " + JSON.stringify(err));
});
```
......@@ -815,9 +815,9 @@ off(type: 'dataEnd', callback?: Callback\<void\>): void
httpRequest.off('dataEnd');
```
### on('dataProgress')<sup>10+</sup>
### on('dataReceiveProgress')<sup>10+</sup>
on(type: 'dataProgress', callback: Callback\<{ receiveSize: number, totalSize: number }\>): void
on(type: 'dataReceiveProgress', callback: Callback\<{ receiveSize: number, totalSize: number }\>): void
订阅HTTP流式响应数据接收进度事件。
......@@ -830,20 +830,20 @@ on(type: 'dataProgress', callback: Callback\<{ receiveSize: number, totalSize: n
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | --------------------------------- |
| type | string | 是 | 订阅的事件类型,'dataProgress'。 |
| type | string | 是 | 订阅的事件类型,'dataReceiveProgress'。 |
| callback | AsyncCallback\<{ receiveSize: number, totalSize: number }\> | 是 | 回调函数。<br>receiveSize:已接收的数据字节数,totalSize待接收的字节总数 |
**示例:**
```js
httpRequest.on('dataProgress', (data) => {
console.info('dataProgress:' + JSON.stringify(data));
httpRequest.on('dataReceiveProgress', (data) => {
console.info('dataReceiveProgress:' + JSON.stringify(data));
});
```
### off('dataProgress')<sup>10+</sup>
### off('dataReceiveProgress')<sup>10+</sup>
off(type: 'dataProgress', callback?: Callback\<{ receiveSize: number, totalSize: number }\>): void
off(type: 'dataReceiveProgress', callback?: Callback\<{ receiveSize: number, totalSize: number }\>): void
取消订阅HTTP流式响应数据接收进度事件。
......@@ -856,13 +856,13 @@ off(type: 'dataProgress', callback?: Callback\<{ receiveSize: number, totalSize:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------ | ---- | -------------------------------------- |
| type | string | 是 | 取消订阅的事件类型:'dataProgress'。 |
| type | string | 是 | 取消订阅的事件类型:'dataReceiveProgress'。 |
| callback | Callback\<{ receiveSize: number, totalSize: number }\> | 否 | 回调函数。 |
**示例:**
```js
httpRequest.off('dataProgress');
httpRequest.off('dataReceiveProgress');
```
## HttpRequestOptions<sup>6+</sup>
......
......@@ -32,15 +32,15 @@
|新增|NA|模块名: ohos.net.ethernet<br>类名: ethernet<br>方法 or 属性: function off(type: 'interfaceStateChange', callback?: Callback\<{ iface: string, active: boolean }>): void;|@ohos.net.ethernet.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequestOptions<br>方法 or 属性: usingProxy?: boolean \| HttpProxy;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequestOptions<br>方法 or 属性: caPath?: string;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: request2(url: string, callback: AsyncCallback\<number>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: request2(url: string, options: HttpRequestOptions, callback: AsyncCallback\<number>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: request2(url: string, options?: HttpRequestOptions): Promise\<number>;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: requestInStream(url: string, callback: AsyncCallback\<number>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: requestInStream(url: string, options: HttpRequestOptions, callback: AsyncCallback\<number>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: requestInStream(url: string, options?: HttpRequestOptions): Promise\<number>;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: on(type: "dataReceive", callback: Callback\<ArrayBuffer>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: off(type: "dataReceive", callback?: Callback\<ArrayBuffer>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: on(type: "dataEnd", callback: Callback\<void>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: off(type: "dataEnd", callback?: Callback\<void>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: on(type: "dataProgress", callback: Callback\<{ receiveSize: number, totalSize: number }>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: off(type: "dataProgress", callback?: Callback\<{ receiveSize: number, totalSize: number }>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: on(type: "dataReceiveProgress", callback: Callback\<{ receiveSize: number, totalSize: number }>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.http<br>类名: HttpRequest<br>方法 or 属性: off(type: "dataReceiveProgress", callback?: Callback\<{ receiveSize: number, totalSize: number }>): void;|@ohos.net.http.d.ts|
|新增|NA|模块名: ohos.net.mdns<br>类名: mdns|@ohos.net.mdns.d.ts|
|新增|NA|模块名: ohos.net.mdns<br>类名: mdns<br>方法 or 属性: function addLocalService(context: Context, serviceInfo: LocalServiceInfo,<br> callback: AsyncCallback\<LocalServiceInfo>): void;|@ohos.net.mdns.d.ts|
|新增|NA|模块名: ohos.net.mdns<br>类名: mdns<br>方法 or 属性: function addLocalService(context: Context, serviceInfo: LocalServiceInfo): Promise\<LocalServiceInfo>;|@ohos.net.mdns.d.ts|
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册