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

request2 API name change

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