类 Adapter<Options, Model, Connection, Field, Value, Query, ExecuteSpec>

constructor

• new Adapter<
      Options extends object = Readonly<Record<string, DataValue>>,
      Model = object,
      Connection = object,
      Field = object,
      Value = DataValue,
      Query extends
          AdapterQuery<
              Model,
              Connection,
              object
              | null,
              Readonly<Record<string, DataValue>>,
              Readonly<Record<string, DataValue>>,
          > = AdapterQuery<
          Model,
          Connection,
          object
          | null,
          Readonly<Record<string, DataValue>>,
          Readonly<Record<string, DataValue>>,
      >,
      ExecuteSpec extends
          AdapterExecuteSpec<
              readonly DataValue[],
              readonly DataValue[],
              AdapterOperationResult,
          > = DefaultAdapterExecuteSpec,
  >(
      ...__namedParameters: {} extends Options
          ? readonly [Options | null | undefined]
          : readonly [Options],
  ): Adapter<Options, Model, Connection, Field, Value, Query, ExecuteSpec>

  类型参数

  • Options extends object = Readonly<Record<string, DataValue>>
  • Model = object
  • Connection = object
  • Field = object
  • Value = DataValue
  • Query extends AdapterQuery<
        Model,
        Connection,
        object
        | null,
        Readonly<Record<string, DataValue>>,
        Readonly<Record<string, DataValue>>,
    > = AdapterQuery<
        Model,
        Connection,
        object
        | null,
        Readonly<Record<string, DataValue>>,
        Readonly<Record<string, DataValue>>,
    >
  • ExecuteSpec extends AdapterExecuteSpec<
        readonly DataValue[],
        readonly DataValue[],
        AdapterOperationResult,
    > = DefaultAdapterExecuteSpec

  参数

  • ...__namedParameters: {} extends Options ? readonly [Options | null | undefined] : readonly [Options]

  返回 Adapter<Options, Model, Connection, Field, Value, Query, ExecuteSpec>

• new Adapter<
      Options extends object = Readonly<Record<string, DataValue>>,
      Model = object,
      Connection = object,
      Field = object,
      Value = DataValue,
      Query extends
          AdapterQuery<
              Model,
              Connection,
              object
              | null,
              Readonly<Record<string, DataValue>>,
              Readonly<Record<string, DataValue>>,
          > = AdapterQuery<
          Model,
          Connection,
          object
          | null,
          Readonly<Record<string, DataValue>>,
          Readonly<Record<string, DataValue>>,
      >,
      ExecuteSpec extends
          AdapterExecuteSpec<
              readonly DataValue[],
              readonly DataValue[],
              AdapterOperationResult,
          > = DefaultAdapterExecuteSpec,
  >(
      parent: object,
      options: Options | null | undefined,
  ): Adapter<Options, Model, Connection, Field, Value, Query, ExecuteSpec>

  类型参数

  • Options extends object = Readonly<Record<string, DataValue>>
  • Model = object
  • Connection = object
  • Field = object
  • Value = DataValue
  • Query extends AdapterQuery<
        Model,
        Connection,
        object
        | null,
        Readonly<Record<string, DataValue>>,
        Readonly<Record<string, DataValue>>,
    > = AdapterQuery<
        Model,
        Connection,
        object
        | null,
        Readonly<Record<string, DataValue>>,
        Readonly<Record<string, DataValue>>,
    >
  • ExecuteSpec extends AdapterExecuteSpec<
        readonly DataValue[],
        readonly DataValue[],
        AdapterOperationResult,
    > = DefaultAdapterExecuteSpec

  参数

  • parent: object
  • options: Options | null | undefined

  返回 Adapter<Options, Model, Connection, Field, Value, Query, ExecuteSpec>

options

只读parent

beginTransaction

• beginTransaction(): Promise<Connection>

  开始事务；子类可以覆盖这个可选操作。

  返回 Promise<Connection>

commit

• commit(connection: Connection): Promise<void>

  提交事务；子类可以覆盖这个可选操作。

  参数

  • connection: Connection

  返回 Promise<void>

count

• count(query: Query): Promise<number>

  统计规范化 Query 对应的数据行；子类必须覆盖此方法。

  参数

  • query: Query

  返回 Promise<number>

deleteByQuery

• deleteByQuery(query: Query): Promise<AdapterOperationResult>

  删除规范化 Query 对应的数据行；子类必须覆盖此方法。

  参数

  • query: Query

  返回 Promise<AdapterOperationResult>

execute

• execute(...arguments_: ExecuteSpec["arguments"]): Promise<ExecuteSpec["result"]>

  执行 Adapter 特有的原始操作；子类可以覆盖此方法。

  参数

  • ...arguments_: ExecuteSpec["arguments"]

  返回 Promise<ExecuteSpec["result"]>

find

• find(query: Query, options?: AdapterFindOptions): Promise<AdapterFindResult>

  查找规范化 Query 对应的数据行；子类必须覆盖此方法。

  参数

  • query: Query
  • 可选options: AdapterFindOptions

  返回 Promise<AdapterFindResult>

getDBName

• getDBName(): string

  返回当前数据库名；基类实现返回 ''。

  返回 string

insert

• insert(
      model: Model,
      connection: Connection | null,
      data: readonly AdapterData<Field, Value>[],
  ): Promise<Readonly<Record<string, DataValue>> | null>

  插入一行数据；子类必须覆盖此方法。

  参数

  • model: Model
  • connection: Connection | null
  • data: readonly AdapterData<Field, Value>[]

  返回 Promise<Readonly<Record<string, DataValue>> | null>

rollback

• rollback(connection: Connection): Promise<void>

  回滚事务；子类可以覆盖这个可选操作。

  参数

  • connection: Connection

  返回 Promise<void>

update

• update(
      model: Model,
      connection: Connection | null,
      primaryKey: DataRow,
      data: readonly AdapterData<Field, Value>[],
  ): Promise<AdapterOperationResult>

  更新已经定位的一行数据；子类必须覆盖此方法。

  参数

  • model: Model
  • connection: Connection | null
  • primaryKey: DataRow
  • data: readonly AdapterData<Field, Value>[]

  返回 Promise<AdapterOperationResult>

updateByQuery

• updateByQuery(query: Query): Promise<AdapterOperationResult>

  执行批量更新；子类可以覆盖这个可选操作。

  参数

  • query: Query

  返回 Promise<AdapterOperationResult>