苍穹接口介绍数据库操作服务帮助类

苍穹通用接口介绍

1.数据库操作服务帮助类

kd.viceHelper数据库操作服务帮助类为数据库操作上层封装，简化数据库操作。

举例，生成实体主键：

Stringid=ringld();

1.1API概览

方法说明

staticlonggenGlobalLongld()生成全局唯一的长整形主键

staticlong[]genLonglds(StringtableName,intcount)批量生成长整型主键

staticStringgenStringld()生成字符型主键

staticStringQgenStringlds(intcount)批量生成字符型主键

staticStringQgenStringlds(StringtableName,intcount)批量生成字符型主键

1.2API详情

1.2.1生成全局唯一的长整形主键

staticlonggenGlobalLongId()

传入参数：无

返回数据：全局唯一长整型

1.2.2批量生成长整型主键

staticlong[]genLonglds(StringtableName.intcount)

传入参数：

参数名称参数参数类型是否必传

物理表格名称tableNameString是

生成主键个数countint是

返回数据：

批量生成的主键数组，long口

1.2.3生成字符型主健

staticStringgenStringldO

传入参数：无

返回数据：字符型主键

1.2.4批量生成字符型主健

staticString[|genStringIds(intcount)

传入参数：

参数名称参数参数类型是否必传

生成主键个数countint是

返回数据：

批量生成的主键数组，String[]

1.2.5批量生成字符型主键

StaticStringl|genStringIds(StringtableName,intcount)

传入参数：

参数名称参数参数类型是否必传

物理表格名称tableNameString是

生成主键个数countint是

返回数据：

批量生成的主键数组，String。

2.查询服务帮助类

kd.ServiceHelper查询服务帮助类封装了一些查询方法。

举例，查询某条记录是否存在：

booleanexist=s(entityName.pkld);

2.1API概览

方法说明

staticbooleanexists(StringentityName,Objectpkld)

查询记录是否存在

staticbooleanexists(StringentityName,QFilterQqFilters)

staticListgetAIIBillNo(StringsearchKey,inttop)获取前top条单据编号字段标识

staticDynamicObjectCollectionquery(StringentityName,String

selectFields,QFilter[]filters)

staticDynamicObjectCollectionquery(StringentityName,String

selectFields,QFilterQfilters,StringorderBys)

staticDynamicObjectCollectionquery(StringentityName,String

查询数据

selectFields,QFilterQfilters,StringorderBys,inttop)

staticDynamicObjectCollectionquery(StringalgoKey,String

entityName,StringselectFields,QFilter[]filters,StringorderBys)

staticDynamicObjectCollectionquery(StringalgoKey,String

entityName,StringselectFields,QFilter[]filters,StringorderBys,inttop)

staticDataSetqueryDataSet(StringalgoKey,StringentityName,String

selectFields,QFilter[]filters,StringorderBys)

algo查询

staticDataSetqueryDataSet(StringalgoKey,StringentityName,String

selectFields,QFilterQfilters,StringorderBys,inttop)

staticDynamicobjectqueryOne(StringentityName,StringselectFields,

查询单条记录

QFilter[]filters)

staticListqueryPrimaryKeys(StringalgoKey,IDataEntityType

entityType,QFilterQfilters,StringorderBys,inttop)

staticListqueryPrimaryKeys(StringentityName,QFilterQfilters,String

查询主键

orderBys,inttop)

staticListqueryPrimaryKeys(StringalgoKey,StringentityName,

QFilter[]filters,StringorderBys,inttop)

2.2API详情

•杳询记录是否存在

staticbooleanexists(StringentityName,Objectpkld)

传入参数：

参数名称参数参数类型是否必传

实体名称entityNameString是

主键idpkldObject是

返回数据:

数据是否存在

•查询记录是否存在

staticbooleanexists(StringentityName,QFilter[]qFilters)

传入参数：

参数名称参数参数类型是否必传

物理表格名称entityNameString是

过滤条件qFiltersQFilterO是

返回数据：

数据是否存在

•获取所有的单据编号字段标识

staticList</BillNoDto>gctAHBillNo(StringsearchKey,inttop)

传入参数：

参数名称参数参数类型是否必传

搜索关键字searchKeyString是

前多少条数据topint是

返回数据：

单据编号实体，List

publicclassBillNoDto(

String单据字段标识

SiringeniilyName;"

StringentityNumber

Stringpkld;〃^键

)

•查询

staticDynamicObjectCollectionquery(StringentityName,StringselectFields,QFilter[]filters)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

杳询字段selectFieldsString是

过滤条件filtersQFilterQ是

返回数据：

查询数据，DynamicObjectCollection

•查询(排序)

staticDynamicObjectCollectionquery(StringentityName,StringselectFields,QFilter[]filters,String

orderBys)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectFieldsString是

过滤条件filtersQFilterQ是

排序条件orderBysString是

返回数据:

查询数据，DynamicObjectCollection

•查询(排序，前top条)

staticDynamicObjectCollectionquery(StringentityName,StringselectFields,QFilter[]filters,String

orderBys,inttop)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectFieldsString是

过滤条件filtersQFilterQ是

排序条件orderBysString是

前多少条topint是

返回数据：

查询数据，DynamicObjectCollection

•查询(algo)

staticDynamicObjectCollectionquery(StringalgoKey,StringentityName,StringselectFields,QFilte

r[]filters,StringorderBys)

传入参数：

参数名称参数参数类型是否必传

algoKeyalgoKeyString是

实体名称（即表单编码）entityNameString是

查询字段selectFieldsString是

过滤条件filtersQFilterQ是

排序条件orderBysString是

返回数据

查询数据，DynamicObjectCollection

•查询(algo,前top条)

staticDynamicObjectCollectionquery(StringalgoKey,StringentityName,StringselectFields,QFilte

r[]filters,StringorderBys,inttop)

传入参数：

参数名称参数参数类型是否必传

algoKeyalgoKeyString是

实体名称（即表单编码）entityNameString是

查询字段selectFieldsString是

过滤条件filtersQFilter[]是

排序条件orderBysString是

前top条topint是

返回数据：

查询数据，DynamicObjectCollection

•查询(返回DataSet)

staticDataSetqueryDataSet(StringalgoKey,StringentityName,StringselectFields,QFilter[]filters,

StringorderBys)

传入参数：

参数名称参数参数类型是否必传

algoKeyalgoKeyString是

实体名称（即表单编码）entityNameString是

查询字段selectFieldsString是

过滤条件filtersQFilterQ是

排序条件orderBysString是

返回数据：

查询数据，DataSet

•查询(返回DataSet,前top条)

staticDataSetqueryDataSet(StringalgoKey,StringentityName,StringselectFields,QFilter[]filters,

StringorderBys,inttop)

传入参数：

参数名称参数参数类型是否必传

algoKeyalgoKeyString是

实体名称（即表单编码）entityNameString是

查询字段selectFieldsString是

过滤条件filtersQFilter[]是

排序条件orderBysString是

前top条topint是

返回数据：

查询数据，DataSet

•查询单条数据

staticDynamicobjectqueryOne(StringentityName,StringselectFields,QFilter[]filters)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectFieldsString是

过谑条件filtersQFilterQ是

返回数据:

单条数据

•查询主键

staticList</Object>queryPrimaryKeys(StringalgoKey,IDataEntityTypeentityType.QFilter[]filters.StringorderBy

s,inttop)

传入参数：

参数名称参数参数类型是否必传

algoKeyalgoKeyString是

实体名称（即表单编码）entityNameString是

实体类型entityTypeIDataEntityType是

过滤条件filtersQFilterQ是

排序条件orderBysString是

前top条topint是

返回数据：

主键列表,List

•查询主键

StaticList</Objcct>queryPrimaryKeys(StringcntityNamc.QFilterf]filters.StringordcrBys,inttop)

传入参数

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

过滤条件filtersQFilter[]是

排序条件orderBysString是

前top条topint是

返回数据：

主键列表,List

•查询主键

staticList<Object>queryPrimaryKeys(StringalgoKey,StringentityName,QFilter[]filters,Stringor

derBys,inttop)

传入参数：

参数名称参数参数类型是否必传

algoKeyalgoKeyString是

实体名称（即表单编码）entityNameString是

过灌条件filtersQFilter[]是

排序条件orderBysString是

前top条topint是

返回数据：

主键列表,List

3.实体操作服务帮助类

kd.tionServiceHelper实体操作服务类为实体操作的上层封装，简化实体操作服务调用操作。

举例，调用提交操作：

OperationResultresult=teOperate("submit".FormId_Bill2.newDynamicObject[](billObj2),e());

3.1API概览

方法说明

staticOperationResultexecuteOperate(StringoperationKey,StringentityNumber,

执行操作

DynamicObject[]dataEntities,OperateOptionoption)

staticOperationResultexecuteOperate(StringoperationKey,StringentityNumber,

执行操作

ObjectQids,OperateOptionoption)

3.2API详情

3.2.1执行操作

staticOperationResultexecuteOperate(StringoperationKey,StringentityNumber,DynamicObject[]

dataEntities；OperateOptionoption)

传入参数：

参数名称参数参数类型是否必传

操作keyoperationKeyString是

实体编码entityNumberString是

操作数据dataEntitiesDynamicObject[]是

操作选项optionOperateOption是

返回数据：

操作结果，OperationResult

3.2.2执行操作

staticOperationResultexecuteOperate(StringoperationKey,StringentityNumber,Object[]ids,Op

erateOptionoption)

传入参数：

参数名称参数参数类型是否必传

操作keyoperationKeyString是

实体编码entityNumberString是

操作数据dataEntitiesObjectO是

操作选项optionOperateOption是

返回数据：

操作结果，OperationResult

4.业务数据服务帮助类

kd.essDahiServiceHelper业务数据服务帮助类提供查询、缓存杳询等功能。

举例，生成实体主键：

DynamicObjectobj=ingleFromCache(pkId.mainEntilyType);

4.1API概览

方法说明

staticDynamicObject[]load(Object[]pkArray,DynamicObjectTypetype)

staticObject[]load(Object[]pkArray,IDataEntityTypetype)

staticDynamicObject[]load(StringentityName,StringselectProperties,

QFilter[]filters)

staticDynamicObject[]load(StringentityName,StringselectProperties,

加载数据

QFilter[]filters,StringorderBy)

staticDynamicObject[]load(StringentityName,StringselectProperties,

QFilter[]filters,StringorderBy,inttop)

staticDynamicObject[]load(StringentityName,StringselectProperties,

QFilter[]filters,StringorderBy,intpageindex,intpagesize)

staticMap<Object,DynamicObject>loadFromCache(DynamicObjectType

type,QFilter[]filters)

staticMap<Object,DynamicObject>loadFromCache(Object[]pkArray,

DynamicObjectTypetype)

staticMap<Object,DynamicObject>loadFromCache(Object[]pkArray,String

entityName)

从缓存加载数据

staticMap<Object,DynamicObject>loadFromCache(StringentityName,

QFilter[]filters)

staticMap<Object,DynamicObject>loadFromCache(StringentityName,

StringselectProperties,QFilter[]filters)

staticMap<Object,DynamicObject>loadFromCache(StringentityName,

StringselectProperties,QFilter[]filters,StringorderBy)

读取实体，仅包含根实

staticDynamicObjectloadHead(Objectpk,DynamicObjectTypetype)

体数据，不含分录数据

staticvoidloadRefence(Object[]dataEntitys,IDataEntityTypetype)加载实体引用数据

staticDynamicObjectloadSingle(Objectpk,DynamicObjectTypetype)

加载动态实体

staticDynamicObjectloadSingle(Objectpk,DynamicObjectTypetype,int

方法说明

start,intlimit)

staticDynamicobjectloadSingle(Objectpk,StringentityName)

staticDynamicobjectloadSingle(Objectpk,StringentityName,String

selectProperties)

staticDynamicObjectloadSingle(StringentityName,StringselectProperties,

QFilter[]filters)

staticDynamicObjectloadSingleFromCache(Objectpk,DynamicObjectType

type)

staticDynamicObjectloadSingleFromCache(Objectpk,StringentityName)

staticDynamicObjectloadSingleFromCache(Objectpk,StringentityName,

StringselectProperties)从缓存加载实体

staticDynamicObjectloadSingleFromCache(StringentityName,QFilter[]

filters)

staticDynamicObjectloadSingleFromCache(StringentityName,String

selectProperties,QFilter[]filters)

通过实体名称创建一

staticDynamicObjectnewDynamicObject(StringentityName)

个动态实体类型

staticvoidremoveCache(DynamicObjectTypetype)移除缓存

4.2API详情

4.2.1加载数据

StaticDynaniicObjectl]load(Objcct[]pkArray,DynamicObjectTypetype)

传入参数：

参数名称参数参数类型是否必传

主键IdspkArrayObjectf)是

实体类型typeDynamicObjectType是

返回数据：

数据列表，DynamicObject[]

4.2.2加载数据

StaticObjectf]load(Object[]pkArray,IDataEntityTypetype)

传入参数:

参数名称参数参数类型是否必传

主键IdspkArrayObject[]是

实体类型typeIDataEntityType是

返回数据：

数据列表，Object[]

4.2.3加载数据

StaticDynamicObjectUload(StringcntityName,StringselcctPropcrties,QFilter[]filters)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectPropertiesString是

过滤条件filtersQFilter[]是

返回数据：

数据列表，DynamicObject[]

4.2.4加载数据

staticDynamicObject[]load(StringentityName,StringselectProperties,QFilter[]filters,StringorderBy)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectPropertiesString是

过滤条件filtersQFilter[]是

排序条件orderByString是

返回数据：

数据列表，DynamicObject[]

4.2.5加载数据

StaticDynamicObject||load(StringentityName,StringselectProperties,QFil(er|]fillers.StringorderBy,inttop)

传入参数:

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectPropertiesString是

过滤条件filtersQFilter[]是

排序条件orderByString是

前top条topint是

返回数据：

数据列表，DynamicObject[]

4.2.6加载数据(分页)

staticDynamicObject[|load(StringentityName,StringselectProperties,QFilter[]filters,StringorderBy,intpagelnd

ex,intpagesize)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectPropertiesString是

过滤条件filtersQFilter[]是

排序条件orderByString是

页码pageindexint是

分页大小pageSizeint是

返回数据：

数据列表，DynamicObject[]

4.2.7从缓存加载数据

staticMap<Object,DynamicObject>loadFromCache(DynamicObjectTypetype,QFilter[]filters)

传入参数：

参数名称参数参数类型是否必传

实体类型typeDynamicObjectType是

过滤条件filtersQFilter[]是

返回数据：

缓存数据，Map<Object,DynamicObject>

4.2.8从缓存加载数据

staticMap<Object,DynamicObject>loadFromCache(Object[]pkArray,DynamicObjectTypetype)

传入参数：

参数名称参数参数类型是否必传

主键IdspkArrayObject[]是

实体类型typeDynamicObjectType是

返回数据：

缓存数据，Map<Object,DynamicObject>

4.2.9从缓存加载数据

staticMap<Object,DynamicObject>loadFromCache(Object[]pkArray,StringentityName)

传入参数：

参数名称参数参数类型是否必传

主键IdspkArrayObject[]是

实体名称（即表单编码）entityNameString是

返回数据:

缓存数据，Map<Object,DynamicObject>

4.2.10从缓存加载数据

staticMap<Object,DynamicObject>loadFromCache(StringentityName,QFilterQfilters)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

过滤条件filtersQFilter[]是

返回数据：

缓存数据，Map<Object,DynamicObject>

4.2.11从缓存加载数据

staticMap<Object,DynamicObject>loadFromCache(StringentityName,StringselectProperties,Q

Filter[]filters)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectPropertiesString是

过滤条件filtersQFilter[]是

返回数据：

缓存数据，Map<Object,DynamicObject>

4.2.12从缓存加载数据

staticMap<Object,DynamicObject>loadFromCache(StringentityName,StringselectProperties,Q

Filter[]filters,StringorderBy)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectPropertiesString是

过滤条件filtersQFilter[]是

排序条件orderByString是

返回数据：

缓存数据，Map<Object,DynamicObject>

4.2.13读取实体（仅包含根实体数据不含分录数据）

staticDynamicobjectloadHead(Objectpk,DynamicObjectTypetype)

传入参数：

参数名称参数参数类型是否必传

主键idPkObject是

实体类型typeDynamicObjectType是

返回数据：

实体数据，DynamicObject

4.2.14加载引用数据

staticvoidloadRefence(Object[]dataEntitys,IDataEntityTypetype)

传入参数：

参数名称参数参数类型是否必传

实体数据dataEntitysObject。是

实体类型typeDynamicObjectType是

返回数据：无

4.2.15加载单介实体

staticDynamicObjectloadSingle(Objectpk,DynamicObjectTypetype)

传入参数：

参数名称参数参数类型是否必传

主键idPkObject是

实体类型typeDynamicObjectType是

返回数据：

实体数据，DynamicObject

4.2.16加载单个实体

staticDynamicObjectloadSingle(Objectpk,DynamicObjectTypetype,intstart,intlimit)

传入参数：

参数名称参数参数类型是否必传

参数名称参数参数类型是否必传

主键idPkObject是

实体类型typeDynamicObjectType是

分录起始行startint是

分录行数limitint是

返回数据：

实体数据，Dynamicobject

4.2.17加载单个实体

staticDynamicobjectloadSingle(Objectpk,StringentityName)

传入参数：

参数名称参数参数类型是否必传

主键idPkObject是

实体名称（即表单编码）entityNameString是

返回数据：

实体数据，Dynamicobject

4.2.18加载单个实体

staticDynamicobjectloadSingle(Objectpk,StringentityName,StringselectProperties)

传入参数：

参数名称参数参数类型是否必传

主键idPkObject是

实体名称（即表单编码）entityNameString是

查询字段selectPropertiesString是

返回数据：

实体数据，Dynamicobject

4.2.19加载单个实体

staticDynamicobjectloadSingle(StringentityName,StringselectProperties,QFilter[]filters)

传入参数：

参数名称参数参数类型是否必传

实体名称（即表单编码）entityNameString是

查询字段selectPropertiesString是

过滤条件filtersQfilter[]是

返回数据：

实体数据，Dynamicobject

4.2.20从缓存加载单个实体

staticDynamicobjectloadSingleFromCache(Objectpk,DynamicObjectTypetype)

传入参数：

参数名称参数参数类型是否必传

主键idPkObject是

实体类型typeDynamicObjectType是

返回数据：

实体数据，DynamicObject

4.2.21从缓存加载单个实体

staticDynamicObjectloadSingleFromCache(Objectpk,StringentityName)

传入参数：

参数名称参数参数类型是否必传

主键idpkObject是

实体名称（即表单编码）entityNameString是

返回数据：

实体数据，DynamicObject

4.2.22从缓存加载单个实体

staticDyn