mirror of
https://gitee.com/openharmony/interface_sdk-js
synced 2024-10-08 07:36:38 +00:00
743 lines
32 KiB
TypeScript
743 lines
32 KiB
TypeScript
/*
|
|
* Copyright (c) 2021 Huawei Device Co., Ltd.
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
import {AsyncCallback, Callback} from './basic';
|
|
import { ResultSet } from './data/rdb/resultSet';
|
|
import Context from "./application/Context";
|
|
import DataSharePredicates from './@ohos.data.DataSharePredicates';
|
|
|
|
/**
|
|
* Provides methods for rdbStore create and delete.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @import import data_rdb from '@ohos.data.rdb';
|
|
*/
|
|
declare namespace rdb {
|
|
/**
|
|
* Obtains an RDB store.
|
|
*
|
|
* You can set parameters of the RDB store as required. In general, this method is recommended
|
|
* to obtain a rdb store.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param context Indicates the context of application or capability.
|
|
* @param config Indicates the configuration of the database related to this RDB store. The configurations include
|
|
* the database path, storage mode, and whether the database is read-only.
|
|
* @param version Indicates the database version for upgrade or downgrade.
|
|
* @return Returns an RDB store {@link ohos.data.rdb.RdbStore}.
|
|
*/
|
|
function getRdbStore(context: Context, config: StoreConfig, version: number, callback: AsyncCallback<RdbStore>): void;
|
|
function getRdbStore(context: Context, config: StoreConfig, version: number): Promise<RdbStore>;
|
|
|
|
/**
|
|
* Deletes the database with a specified name.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param context Indicates the context of application or capability.
|
|
* @param name Indicates the database name.
|
|
* @return Returns true if the database is deleted; returns false otherwise.
|
|
*/
|
|
function deleteRdbStore(context: Context, name: string, callback: AsyncCallback<void>): void;
|
|
function deleteRdbStore(context: Context, name: string): Promise<void>;
|
|
|
|
/**
|
|
* Indicates the database synchronization mode.
|
|
*
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
enum SyncMode {
|
|
/**
|
|
* Indicates the data is pushed to remote device from local device.
|
|
*
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
SYNC_MODE_PUSH = 0,
|
|
|
|
/**
|
|
* Indicates the data is pulled from remote device to local device.
|
|
*
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
SYNC_MODE_PULL = 1,
|
|
}
|
|
|
|
/**
|
|
* Describes the subscription type.
|
|
*
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
enum SubscribeType {
|
|
/**
|
|
* Subscription to remote data changes
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
SUBSCRIBE_TYPE_REMOTE = 0,
|
|
}
|
|
|
|
/**
|
|
* Provides methods for managing the relational database (RDB).
|
|
*
|
|
* This class provides methods for creating, querying, updating, and deleting RDBs.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @import import data_rdb from '@ohos.data.rdb';
|
|
*/
|
|
interface RdbStore {
|
|
/**
|
|
* Inserts a row of data into the target table.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param table Indicates the target table.
|
|
* @param values Indicates the row of data to be inserted into the table.
|
|
* @return Returns the row ID if the operation is successful; returns -1 otherwise.
|
|
*/
|
|
insert(table: string, values: ValuesBucket, callback: AsyncCallback<number>): void;
|
|
insert(table: string, values: ValuesBucket): Promise<number>;
|
|
|
|
/**
|
|
* Updates data in the database based on a a specified instance object of rdbPredicates.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param values Indicates the row of data to be updated in the database.The key-value pairs are associated with column names of the database table.
|
|
* @param predicates Indicates the specified update condition by the instance object of RdbPredicates.
|
|
* @return Returns the number of affected rows.
|
|
*/
|
|
update(values: ValuesBucket, predicates: RdbPredicates, callback: AsyncCallback<number>): void;
|
|
update(values: ValuesBucket, predicates: RdbPredicates): Promise<number>;
|
|
|
|
/**
|
|
* Updates data in the database based on a a specified instance object of DataSharePredicates.
|
|
*
|
|
* @since 9
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param table Indicates the target table.
|
|
* @param values Indicates the row of data to be updated in the database.The key-value pairs are associated with column names of the database table.
|
|
* @param predicates Indicates the specified update condition by the instance object of DataSharePredicates.
|
|
* @return Returns the number of affected rows.
|
|
*/
|
|
update(table: string, values: ValuesBucket, predicates: DataSharePredicates, callback: AsyncCallback<number>): void;
|
|
update(table: string, values: ValuesBucket, predicates: DataSharePredicates): Promise<number>;
|
|
|
|
/**
|
|
* Deletes data from the database based on a specified instance object of rdbPredicates.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param predicates Indicates the specified delete condition by the instance object of RdbPredicates.
|
|
* @return Returns the number of affected rows.
|
|
*/
|
|
delete(predicates: RdbPredicates, callback: AsyncCallback<number>): void;
|
|
delete(predicates: RdbPredicates): Promise<number>;
|
|
|
|
/**
|
|
* Deletes data from the database based on a specified instance object of DataSharePredicates.
|
|
*
|
|
* @since 9
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param table Indicates the target table.
|
|
* @param predicates Indicates the specified delete condition by the instance object of DataSharePredicates.
|
|
* @return Returns the number of affected rows.
|
|
*/
|
|
delete(table: string, predicates: DataSharePredicates, callback: AsyncCallback<number>): void;
|
|
delete(table: string, predicates: DataSharePredicates): Promise<number>;
|
|
|
|
/**
|
|
* Queries data in the database based on specified conditions.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param predicates Indicates the specified query condition by the instance object of RdbPredicates.
|
|
* @param columns Indicates the columns to query. If the value is null, the query applies to all columns.
|
|
* @return Returns a ResultSet object if the operation is successful;
|
|
*/
|
|
query(predicates: RdbPredicates, columns: Array<string>, callback: AsyncCallback<ResultSet>): void;
|
|
query(predicates: RdbPredicates, columns?: Array<string>): Promise<ResultSet>;
|
|
|
|
/**
|
|
* Queries data in the database based on specified conditions.
|
|
*
|
|
* @since 9
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param table Indicates the target table.
|
|
* @param predicates Indicates the specified query condition by the instance object of DataSharePredicates.
|
|
* @param columns Indicates the columns to query. If the value is null, the query applies to all columns.
|
|
* @return Returns a ResultSet object if the operation is successful;
|
|
*/
|
|
query(table: string, predicates: DataSharePredicates, columns: Array<string>, callback: AsyncCallback<ResultSet>): void;
|
|
query(table: string, predicates: DataSharePredicates, columns?: Array<string>): Promise<ResultSet>;
|
|
|
|
/**
|
|
* Queries data in the database based on SQL statement.
|
|
*
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param sql Indicates the SQL statement to execute.
|
|
* @param bindArgs Indicates the values of the parameters in the SQL statement. The values are strings.
|
|
* @return Returns a ResultSet object if the operation is successful;
|
|
*/
|
|
querySql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallback<ResultSet>): void;
|
|
querySql(sql: string, bindArgs?: Array<ValueType>): Promise<ResultSet>;
|
|
|
|
/**
|
|
* Executes an SQL statement that contains specified parameters but returns no value.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param sql Indicates the SQL statement to execute.
|
|
* @param bindArgs Indicates the values of the parameters in the SQL statement. The values are strings.
|
|
*/
|
|
executeSql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallback<void>): void;
|
|
executeSql(sql: string, bindArgs?: Array<ValueType>): Promise<void>;
|
|
|
|
/**
|
|
* beginTransaction before excute your sql
|
|
*
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
beginTransaction():void;
|
|
|
|
/**
|
|
* commit the the sql you have excuted.
|
|
*
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
commit():void;
|
|
|
|
/**
|
|
* roll back the sql you have already excuted
|
|
*
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
rollBack():void;
|
|
|
|
/**
|
|
* Set table to be distributed table.
|
|
*
|
|
* @deprecated since 9
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param tables the tables name you want to set
|
|
*/
|
|
/**
|
|
* Set table to be distributed table.
|
|
*
|
|
* @since 9
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param tables the tables name you want to set
|
|
* @permission ohos.permission.DISTRIBUTED_DATASYNC
|
|
*/
|
|
setDistributedTables(tables: Array<string>, callback: AsyncCallback<void>): void;
|
|
setDistributedTables(tables: Array<string>): Promise<void>;
|
|
|
|
/**
|
|
* Obtain distributed table name of specified remote device according to local table name.
|
|
* When query remote device database, distributed table name is needed.
|
|
*
|
|
* @deprecated since 9
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param device Indicates the remote device.
|
|
* @param table Indicates the local table name.
|
|
* @return the distributed table name.
|
|
*/
|
|
/**
|
|
* Obtain distributed table name of specified remote device according to local table name.
|
|
* When query remote device database, distributed table name is needed.
|
|
*
|
|
* @since 9
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param device Indicates the remote device.
|
|
* @param table Indicates the local table name.
|
|
* @permission ohos.permission.DISTRIBUTED_DATASYNC
|
|
* @return the distributed table name.
|
|
*/
|
|
obtainDistributedTableName(device: string, table: string, callback: AsyncCallback<string>): void;
|
|
obtainDistributedTableName(device: string, table: string): Promise<string>;
|
|
|
|
/**
|
|
* Sync data between devices
|
|
*
|
|
* @deprecated since 9
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param mode Indicates the synchronization mode. The value can be PUSH, PULL.
|
|
* @param predicates Constraint synchronized data and devices.
|
|
* @param callback Indicates the callback used to send the synchronization result to the caller.
|
|
*/
|
|
/**
|
|
* Sync data between devices
|
|
*
|
|
* @since 9
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param mode Indicates the synchronization mode. The value can be PUSH, PULL.
|
|
* @param predicates Constraint synchronized data and devices.
|
|
* @param callback Indicates the callback used to send the synchronization result to the caller.
|
|
* @permission ohos.permission.DISTRIBUTED_DATASYNC
|
|
*/
|
|
sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback<Array<[string, number]>>): void;
|
|
sync(mode: SyncMode, predicates: RdbPredicates): Promise<Array<[string, number]>>;
|
|
|
|
/**
|
|
* Registers an observer for the database. When data in the distributed database changes,
|
|
* the callback will be invoked.
|
|
*
|
|
* @deprecated since 9
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param type Indicates the subscription type, which is defined in {@code SubscribeType}.
|
|
* @param observer Indicates the observer of data change events in the distributed database.
|
|
*/
|
|
/**
|
|
* Registers an observer for the database. When data in the distributed database changes,
|
|
* the callback will be invoked.
|
|
*
|
|
* @since 9
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param type Indicates the subscription type, which is defined in {@code SubscribeType}.
|
|
* @param observer Indicates the observer of data change events in the distributed database.
|
|
* @permission ohos.permission.DISTRIBUTED_DATASYNC
|
|
*/
|
|
on(event: 'dataChange', type: SubscribeType, observer: Callback<Array<string>>): void;
|
|
|
|
/**
|
|
* Remove specified observer of specified type from the database.
|
|
*
|
|
* @deprecated since 9
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param type Indicates the subscription type, which is defined in {@code SubscribeType}.
|
|
* @param observer Indicates the data change observer already registered .
|
|
* @param observer Indicates the data change observer already registered.
|
|
*/
|
|
/**
|
|
* Remove specified observer of specified type from the database.
|
|
*
|
|
* @since 9
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param type Indicates the subscription type, which is defined in {@code SubscribeType}.
|
|
* @param observer Indicates the data change observer already registered.
|
|
* @permission ohos.permission.DISTRIBUTED_DATASYNC
|
|
*/
|
|
off(event:'dataChange', type: SubscribeType, observer: Callback<Array<string>>): void;
|
|
}
|
|
|
|
/**
|
|
* Indicates possible value types
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @import import data_rdb from '@ohos.data.rdb';
|
|
*/
|
|
type ValueType = number | string | boolean;
|
|
|
|
/**
|
|
* Values in buckets are stored in key-value pairs
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @import import data_rdb from '@ohos.data.rdb';
|
|
*/
|
|
type ValuesBucket = {
|
|
[key: string]: ValueType | Uint8Array | null;
|
|
}
|
|
|
|
/**
|
|
* Manages relational database configurations.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @import import data_rdb from '@ohos.data.rdb';
|
|
*/
|
|
interface StoreConfig {
|
|
name: string;
|
|
}
|
|
|
|
/**
|
|
* Manages relational database configurations.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @import import data_rdb from '@ohos.data.rdb';
|
|
*/
|
|
class RdbPredicates {
|
|
/**
|
|
* A parameterized constructor used to create an RdbPredicates instance.
|
|
* name Indicates the table name of the database.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
*/
|
|
constructor(name: string)
|
|
|
|
/**
|
|
* Specify remote devices when syncing distributed database.
|
|
*
|
|
* @note When query database, this function should not be called.
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param devices Indicates specified remote devices.
|
|
* @return Returns the RdbPredicates self.
|
|
*/
|
|
inDevices(devices: Array<string>): RdbPredicates;
|
|
|
|
/**
|
|
* Specify all remote devices which connect to local device when syncing distributed database.
|
|
*
|
|
* @note When query database, this function should not be called.
|
|
* @since 8
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @return Returns the RdbPredicates self.
|
|
*/
|
|
inAllDevices(): RdbPredicates;
|
|
|
|
/**
|
|
* Configures the RdbPredicates to match the field whose data type is ValueType and value is equal
|
|
* to a specified value.
|
|
*
|
|
* @note This method is similar to = of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param value Indicates the value to match with the RdbPredicates.
|
|
* @return Returns the RdbPredicates that match the specified field.
|
|
*/
|
|
equalTo(field: string, value: ValueType): RdbPredicates;
|
|
|
|
/**
|
|
* Configures the RdbPredicates to match the field whose data type is ValueType and value is unequal to
|
|
* a specified value.
|
|
*
|
|
* @note This method is similar to != of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param value Indicates the value to match with the RdbPredicates.
|
|
* @return Returns the RdbPredicates that match the specified field.
|
|
*/
|
|
notEqualTo(field: string, value: ValueType): RdbPredicates;
|
|
|
|
/**
|
|
* Adds a left parenthesis to the RdbPredicates.
|
|
*
|
|
* @note This method is similar to ( of the SQL statement and needs to be used together with endWrap().
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @return Returns the RdbPredicates with the left parenthesis.
|
|
*/
|
|
beginWrap(): RdbPredicates;
|
|
|
|
/**
|
|
* Adds a right parenthesis to the RdbPredicates.
|
|
*
|
|
* @note This method is similar to ) of the SQL statement and needs to be used together
|
|
* with beginWrap().
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @return Returns the RdbPredicates with the right parenthesis.
|
|
*/
|
|
endWrap(): RdbPredicates;
|
|
|
|
/**
|
|
* Adds an or condition to the RdbPredicates.
|
|
*
|
|
* @note This method is similar to or of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @return Returns the RdbPredicates with the or condition.
|
|
*/
|
|
or(): RdbPredicates;
|
|
|
|
/**
|
|
* Adds an and condition to the RdbPredicates.
|
|
*
|
|
* @note This method is similar to and of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @return Returns the RdbPredicates with the and condition.
|
|
*/
|
|
and(): RdbPredicates;
|
|
|
|
/**
|
|
* Configures the RdbPredicates to match the field whose data type is string and value
|
|
* contains a specified value.
|
|
*
|
|
* @note This method is similar to contains of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param value Indicates the value to match with the RdbPredicates.
|
|
* @return Returns the RdbPredicates that match the specified field.
|
|
*/
|
|
contains(field: string, value: string): RdbPredicates;
|
|
|
|
/**
|
|
* Configures the RdbPredicates to match the field whose data type is string and value starts
|
|
* with a specified string.
|
|
*
|
|
* @note This method is similar to value% of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param value Indicates the value to match with the RdbPredicates.
|
|
* @return Returns the RdbPredicates that match the specified field.
|
|
*/
|
|
beginsWith(field: string, value: string): RdbPredicates;
|
|
|
|
/**
|
|
* Configures the RdbPredicates to match the field whose data type is string and value
|
|
* ends with a specified string.
|
|
*
|
|
* @note This method is similar to %value of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param value Indicates the value to match with the RdbPredicates.
|
|
* @return Returns the RdbPredicates that match the specified field.
|
|
*/
|
|
endsWith(field: string, value: string): RdbPredicates;
|
|
|
|
/**
|
|
* Configures the RdbPredicates to match the fields whose value is null.
|
|
*
|
|
* @note This method is similar to is null of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @return Returns the RdbPredicates that match the specified field.
|
|
*/
|
|
isNull(field: string): RdbPredicates;
|
|
|
|
/**
|
|
* Configures the RdbPredicates to match the specified fields whose value is not null.
|
|
*
|
|
* @note This method is similar to is not null of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @return Returns the RdbPredicates that match the specified field.
|
|
*/
|
|
isNotNull(field: string): RdbPredicates;
|
|
|
|
/**
|
|
* Configures the RdbPredicates to match the fields whose data type is string and value is
|
|
* similar to a specified string.
|
|
*
|
|
* @note This method is similar to like of the SQL statement.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param value Indicates the value to match with the RdbPredicates. The percent sign (%) in the value
|
|
* is a wildcard (like * in a regular expression).
|
|
* @return Returns the RdbPredicates that match the specified field.
|
|
*/
|
|
like(field: string, value: string): RdbPredicates;
|
|
|
|
/**
|
|
* Configures RdbPredicates to match the specified field whose data type is string and the value contains
|
|
* a wildcard.
|
|
*
|
|
* @note Different from like, the input parameters of this method are case-sensitive.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param value Indicates the value to match with RdbPredicates.
|
|
* @return Returns the SQL statement with the specified RdbPredicates.
|
|
*/
|
|
glob(field: string, value: string): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts the value of the field to the range between low value and high value.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name.
|
|
* @param low Indicates the minimum value.
|
|
* @param high Indicates the maximum value.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
between(field: string, low: ValueType, high: ValueType): RdbPredicates;
|
|
|
|
/**
|
|
* Configures RdbPredicates to match the specified field whose data type is int and value is
|
|
* out of a given range.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param low Indicates the minimum value to match with DataAbilityPredicates.
|
|
* @param high Indicates the maximum value to match with DataAbilityPredicates.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
notBetween(field: string, low: ValueType, high: ValueType): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts the value of the field to be greater than the specified value.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name.
|
|
* @param value Indicates the String field.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
greaterThan(field: string, value: ValueType): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts the value of the field to be smaller than the specified value.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name.
|
|
* @param value Indicates the String field.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
lessThan(field: string, value: ValueType): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts the value of the field to be greater than or equal to the specified value.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name.
|
|
* @param value Indicates the String field.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
greaterThanOrEqualTo(field: string, value: ValueType): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts the value of the field to be smaller than or equal to the specified value.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name.
|
|
* @param value Indicates the String field.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
lessThanOrEqualTo(field: string, value: ValueType): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts the ascending order of the return list. When there are several orders,
|
|
* the one close to the head has the highest priority.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name for sorting the return list.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
orderByAsc(field: string): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts the descending order of the return list. When there are several orders,
|
|
* the one close to the head has the highest priority.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name for sorting the return list.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
orderByDesc(field: string): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts each row of the query result to be unique.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
distinct(): RdbPredicates;
|
|
|
|
/**
|
|
* Restricts the max number of return records.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param value Indicates the max length of the return list.
|
|
* @return Returns the SQL query statement with the specified RdbPredicates.
|
|
*/
|
|
limitAs(value: number): RdbPredicates;
|
|
|
|
/**
|
|
* Configures RdbPredicates to specify the start position of the returned result.
|
|
*
|
|
* @note Use this method together with limit(int).
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param rowOffset Indicates the start position of the returned result. The value is a positive integer.
|
|
* @return Returns the SQL query statement with the specified AbsPredicates.
|
|
*/
|
|
offsetAs(rowOffset: number): RdbPredicates;
|
|
|
|
/**
|
|
* Configures RdbPredicates to group query results by specified columns.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param fields Indicates the specified columns by which query results are grouped.
|
|
* @return Returns the RdbPredicates with the specified columns by which query results are grouped.
|
|
*/
|
|
groupBy(fields: Array<string>): RdbPredicates;
|
|
|
|
/**
|
|
* Configures RdbPredicates to specify the index column.
|
|
*
|
|
* @note Before using this method, you need to create an index column.
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param indexName Indicates the name of the index column.
|
|
* @return Returns RdbPredicates with the specified index column.
|
|
*/
|
|
indexedBy(field: string): RdbPredicates;
|
|
|
|
/**
|
|
* Configures RdbPredicates to match the specified field whose data type is ValueType array and values
|
|
* are within a given range.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param values Indicates the values to match with RdbPredicates.
|
|
* @return Returns RdbPredicates that matches the specified field.
|
|
*/
|
|
in(field: string, value: Array<ValueType>): RdbPredicates;
|
|
|
|
/**
|
|
* Configures RdbPredicates to match the specified field whose data type is ValueType array and values
|
|
* are out of a given range.
|
|
*
|
|
* @since 7
|
|
* @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
|
|
* @param field Indicates the column name in the database table.
|
|
* @param values Indicates the values to match with RdbPredicates.
|
|
* @return Returns RdbPredicates that matches the specified field.
|
|
*/
|
|
notIn(field: string, value: Array<ValueType>): RdbPredicates;
|
|
}
|
|
}
|
|
|
|
export default rdb;
|