提交 3aeb873b 编写于 作者: W wuyongning

update js-apis-data-rdb.md

Signed-off-by: Nwuyongning <wuyongning@huawei.com>
上级 0ee85e6f
...@@ -38,13 +38,11 @@ data_rdb.getRdbStore(STORE_CONFIG, 1, function (err, rdbStore) { ...@@ -38,13 +38,11 @@ data_rdb.getRdbStore(STORE_CONFIG, 1, function (err, rdbStore) {
}) })
}) })
``` ```
## data_rdb.getRdbStore
getRdbStore(config: StoreConfig, version: number): Promise&lt;RdbStore&gt;
## data_rdb.getRdbStore<sup>8+</sup> 获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作,结果以Promise形式返回。
getRdbStore(context: Context, config: StoreConfig, version: number, callback: AsyncCallback&lt;RdbStore&gt;): void
获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作,结果以callback形式返回。
**系统能力**:SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**:SystemCapability.DistributedDataManager.RelationalStore.Core。
...@@ -52,42 +50,39 @@ getRdbStore(context: Context, config: StoreConfig, version: number, callback: As ...@@ -52,42 +50,39 @@ getRdbStore(context: Context, config: StoreConfig, version: number, callback: As
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 <br>API version 8的Context定义见[Context](js-apis-Context.md)<br>API version 9的Context定义见[Context](js-apis-service-extension-context.md)。|
| config | [StoreConfig](#storeconfig) | 是 | 与此RDB存储相关的数据库配置。 | | config | [StoreConfig](#storeconfig) | 是 | 与此RDB存储相关的数据库配置。 |
| version | number | 是 | 数据库版本。 | | version | number | 是 | 数据库版本。 |
| callback | AsyncCallback&lt;[RdbStore](#rdbstore)&gt; | 是 | 指定callback回调函数,返回一个RdbStore。 |
**返回值**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;[RdbStore](#rdbstore)&gt; | 指定Promise回调函数。返回一个RdbStore。 |
**示例** **示例**
```js ```js
const STORE_CONFIG = { name: "RdbTest.db"} const STORE_CONFIG = { name: "RdbTest.db" }
const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)" const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
data_rdb.getRdbStore(this.context, STORE_CONFIG, 1, function (err, rdbStore) { let promisegetRdb = data_rdb.getRdbStore(STORE_CONFIG, 1);
rdbStore.executeSql(SQL_CREATE_TABLE, null, function() { promisegetRdb.then(async (rdbStore) => {
console.info('create table done.') let promiseExecSql = rdbStore.executeSql(SQL_CREATE_TABLE, null)
promiseExecSql.then(() => {
console.info('executeSql creat done.')
}).catch((err) => {
console.log("executeSql creat err.")
}) })
}).catch((err) => {
console.log("getRdbStore err.")
}) })
``` ```
API 9的示例请参考如下代码:
```ts
export default class MainAbility extends Ability {
const STORE_CONFIG = { name: "RdbTest.db"}
const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
data_rdb.getRdbStore(this.context, STORE_CONFIG, 1, function (err, rdbStore) {
rdbStore.executeSql(SQL_CREATE_TABLE, null, function() {
console.info('create table done.')
})
})
}
```
## data_rdb.getRdbStore ## data_rdb.getRdbStore<sup>8+</sup>
getRdbStore(config: StoreConfig, version: number): Promise&lt;RdbStore&gt; getRdbStore(context: Context, config: StoreConfig, version: number, callback: AsyncCallback&lt;RdbStore&gt;): void
获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作,结果以Promise形式返回。 获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作,结果以callback形式返回。
**系统能力**:SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**:SystemCapability.DistributedDataManager.RelationalStore.Core。
...@@ -95,30 +90,20 @@ getRdbStore(config: StoreConfig, version: number): Promise&lt;RdbStore&gt; ...@@ -95,30 +90,20 @@ getRdbStore(config: StoreConfig, version: number): Promise&lt;RdbStore&gt;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 <br>API version 8的Context定义见[Context](js-apis-Context.md)<br>API version 9的Context定义见[Context](js-apis-ability-context.md)。|
| config | [StoreConfig](#storeconfig) | 是 | 与此RDB存储相关的数据库配置。 | | config | [StoreConfig](#storeconfig) | 是 | 与此RDB存储相关的数据库配置。 |
| version | number | 是 | 数据库版本。 | | version | number | 是 | 数据库版本。 |
| callback | AsyncCallback&lt;[RdbStore](#rdbstore)&gt; | 是 | 指定callback回调函数,返回一个RdbStore。 |
**返回值**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;[RdbStore](#rdbstore)&gt; | 指定Promise回调函数。返回一个RdbStore。 |
**示例** **示例**
```js ```js
const STORE_CONFIG = { name: "RdbTest.db" } const STORE_CONFIG = { name: "RdbTest.db"}
const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)" const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
let promisegetRdb = data_rdb.getRdbStore(STORE_CONFIG, 1); data_rdb.getRdbStore(this.context, STORE_CONFIG, 1, function (err, rdbStore) {
promisegetRdb.then(async (rdbStore) => { rdbStore.executeSql(SQL_CREATE_TABLE, null, function() {
let promiseExecSql = rdbStore.executeSql(SQL_CREATE_TABLE, null) console.info('create table done.')
promiseExecSql.then(() => {
console.info('executeSql creat done.')
}).catch((err) => {
console.log("executeSql creat err.")
}) })
}).catch((err) => {
console.log("getRdbStore err.")
}) })
``` ```
...@@ -134,7 +119,7 @@ getRdbStore(context: Context, config: StoreConfig, version: number): Promise&lt; ...@@ -134,7 +119,7 @@ getRdbStore(context: Context, config: StoreConfig, version: number): Promise&lt;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 <br>API version 8的Context定义见[Context](js-apis-Context.md)<br>API version 9的Context定义见[Context](js-apis-service-extension-context.md)。 | | context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 <br>API version 8的Context定义见[Context](js-apis-Context.md)<br>API version 9的Context定义见[Context](js-apis-ability-context.md)。 |
| config | [StoreConfig](#storeconfig) | 是 | 与此RDB存储相关的数据库配置。 | | config | [StoreConfig](#storeconfig) | 是 | 与此RDB存储相关的数据库配置。 |
| version | number | 是 | 数据库版本。 | | version | number | 是 | 数据库版本。 |
...@@ -162,25 +147,6 @@ promisegetRdb.then(async (rdbStore) => { ...@@ -162,25 +147,6 @@ promisegetRdb.then(async (rdbStore) => {
}) })
``` ```
API 9的示例请参考如下代码:
```ts
export default class MainAbility extends Ability {
const STORE_CONFIG = { name: "RdbTest.db" }
const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
let promisegetRdb = data_rdb.getRdbStore(this.context, STORE_CONFIG, 1);
promisegetRdb.then(async (rdbStore) => {
let promiseExecSql = rdbStore.executeSql(SQL_CREATE_TABLE, null)
promiseExecSql.then(() => {
console.info('executeSql creat done.')
}).catch((err) => {
console.log("executeSql creat err.")
})
}).catch((err) => {
console.log("getRdbStore err.")
})
}
```
## data_rdb.deleteRdbStore ## data_rdb.deleteRdbStore
deleteRdbStore(name: string, callback: AsyncCallback&lt;void&gt;): void deleteRdbStore(name: string, callback: AsyncCallback&lt;void&gt;): void
...@@ -201,63 +167,53 @@ deleteRdbStore(name: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -201,63 +167,53 @@ deleteRdbStore(name: string, callback: AsyncCallback&lt;void&gt;): void
console.info('delete store done.') console.info('delete store done.')
}) })
``` ```
## data_rdb.deleteRdbStore
## data_rdb.deleteRdbStore<sup>8+</sup> deleteRdbStore(name: string): Promise&lt;void&gt;
deleteRdbStore(context: Context, name: string, callback: AsyncCallback&lt;void&gt;): void
删除数据库,结果以callback形式返回。 使用指定的数据库文件配置删除数据库,结果以Promise形式返回。
**系统能力**:SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**:SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 <br>API version 8的Context定义见[Context](js-apis-Context.md)<br>API version 9的Context定义见[Context](js-apis-service-extension-context.md)。|
| name | string | 是 | 数据库名称。 | | name | string | 是 | 数据库名称。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 |
**返回值**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;void&gt; | 指定Promise回调函数。 |
**示例** **示例**
```js ```js
data_rdb.deleteRdbStore(this.context, "RdbTest.db", function (err, rdbStore) { let promisedeleteRdb = data_rdb.deleteRdbStore("RdbTest.db")
promisedeleteRdb.then(()=>{
console.info('delete store done.') console.info('delete store done.')
}).catch((err) => {
console.log("deleteRdbStore err.")
}) })
``` ```
API 9的示例请参考如下代码: ## data_rdb.deleteRdbStore<sup>8+</sup>
```ts
export default class MainAbility extends Ability {
data_rdb.deleteRdbStore(this.context, "RdbTest.db", function (err, rdbStore) {
console.info('delete store done.')
})
}
```
## data_rdb.deleteRdbStore
deleteRdbStore(name: string): Promise&lt;void&gt; deleteRdbStore(context: Context, name: string, callback: AsyncCallback&lt;void&gt;): void
使用指定的数据库文件配置删除数据库,结果以Promise形式返回。 删除数据库,结果以callback形式返回。
**系统能力**:SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**:SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 <br>API version 8的Context定义见[Context](js-apis-Context.md)<br>API version 9的Context定义见[Context](js-apis-ability-context.md)。|
| name | string | 是 | 数据库名称。 | | name | string | 是 | 数据库名称。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 |
**返回值**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;void&gt; | 指定Promise回调函数。 |
**示例** **示例**
```js ```js
let promisedeleteRdb = data_rdb.deleteRdbStore("RdbTest.db") data_rdb.deleteRdbStore(this.context, "RdbTest.db", function (err, rdbStore) {
promisedeleteRdb.then(()=>{
console.info('delete store done.') console.info('delete store done.')
}).catch((err) => {
console.log("deleteRdbStore err.")
}) })
``` ```
...@@ -272,7 +228,7 @@ deleteRdbStore(context: Context, name: string): Promise&lt;void&gt; ...@@ -272,7 +228,7 @@ deleteRdbStore(context: Context, name: string): Promise&lt;void&gt;
**参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 <br>API version 8的Context定义见[Context](js-apis-Context.md)<br>API version 9的Context定义见[Context](js-apis-service-extension-context.md)。| | context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 <br>API version 8的Context定义见[Context](js-apis-Context.md)<br>API version 9的Context定义见[Context](js-apis-ability-context.md)。|
| name | string | 是 | 数据库名称。 | | name | string | 是 | 数据库名称。 |
**返回值** **返回值**
...@@ -290,18 +246,6 @@ deleteRdbStore(context: Context, name: string): Promise&lt;void&gt; ...@@ -290,18 +246,6 @@ deleteRdbStore(context: Context, name: string): Promise&lt;void&gt;
}) })
``` ```
API 9的示例请参考如下代码:
```ts
export default class MainAbility extends Ability {
let promisedeleteRdb = data_rdb.deleteRdbStore(this.context, "RdbTest.db")
promisedeleteRdb.then(()=>{
console.info('delete store done.')
}).catch((err) => {
console.log("deleteRdbStore err.")
})
}
```
## RdbPredicates ## RdbPredicates
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册