SearchParameters类,它用于构建搜索查询。搜索参数包括前缀参数、搜索参数列表、搜索分组的逻辑设置、搜索结果元数据、排序表达式、页面模型名称、数据源配置信息、脱敏字段信息等等。

Example

const searchParams = new SearchParameters()

searchParams.addParameter('name', 'John Doe')
searchParams.addParameter('age', 30)
searchParams.setGroupLogic('name', 'or')

console.log(searchParams)

Hierarchy

  • SearchParameters

Constructors

Properties

autoControlArea?: any

自动控制区域属性

closeDes?: any

关闭脱敏

codetypes?: any
desFields?: any

脱敏字段信息

distinct?: any

distinct

dsConfig?: any

数据源配置信息

extendQuery?: any
fields?: string[]

搜索结果元数据

fillCNMetaData?: boolean
fillCodeValue?: boolean
getCodeValue?: any

获取代码值

gisFilter?: any
groups?: any[]

搜索分组的逻辑设置

isgis?: boolean
javaClass: string = 'com.longrise.LEAP.Base.Objects.SearchParameters'

Java 类名

name?: any

搜索名称

name2?: any
order?: any

排序表达式

pageCount?: number
pageModule?: any

页面模型名称

pageNum?: number

页码

pageSize?: number

每页大小

parameters?: QueryParameters[]

搜索参数列表

prefixParameter?: any

前缀参数

returnCodeValue?: boolean
toCount?: boolean

到计数

toResult?: boolean

Methods

  • 该方法是 addParameter(name, value, flag, type) 方法的简写,两者的作用相同。该方法向搜索参数列表中添加一个参数。其中,参数列表由 QueryParameters 对象组成,该对象包含名称、值、标志和类型等属性。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 add() 方法两次,向实例属性 parameters 中添加两个参数。然后,我们分别使用 getParameter() 方法获取名称为 'name' 和 'age' 的参数对象。我们可以看到,在每次调用中,该方法都会创建一个新的 QueryParameters 实例,并将其添加到实例属性 parameters 中。最后,该方法还会返回新增的实例,以便在需要时进行进一步操作。

    Example

    const searchParams = new SearchParameters()

    searchParams.add('name', 'John Doe')
    searchParams.add('age', 30, 0, SQLDataType.int)

    const p1 = searchParams.getParameter('name')
    console.log(p1) // QueryParameters { name: 'name', value: 'John Doe', flag: null, type: null }

    const p2 = searchParams.getParameter('age')
    console.log(p2) // QueryParameters { name: 'age', value: 30, flag: 0, type: 'int' }

    Parameters

    • name: string

      参数名称。

    • value: any

      参数值。

    • Optional flag: number

      参数标志。可选。第一位:1:and 2: or 第二位开始: 1:= 2:like:%% 3:like % 4:> 5:< 6:>= 7:<= 8:<> 9:like %@v 10:not like %@v 11:not like %@v% 12: not like 13:is null 14:is not null, 默认为:12

    • Optional type: any

      参数类型。

    Returns QueryParameters

    新增的 QueryParameters 实例。

  • 方法的作用是向搜索结果集中添加一个字段名。如果实例属性 fields 为 null,则创建一个空数组;如果传入的字段名不为 null 且尚未存在于数组中,则将其添加到数组末尾

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 addField() 方法两次,向实例属性 fields 中添加两个字段名。然后,我们分别使用 'null' 和已存在的字段名调用该方法,以测试其处理逻辑。我们可以看到,在第一个调用中,该方法不会改变实例属性 fields 的值;在第二个调用中,该方法仍然只向数组末尾添加了一个字段名;在第三个调用中,该方法相应地忽略了重复的字段名。

    Example

    const searchParams = new SearchParameters()

    searchParams.addField('name')
    searchParams.addField('age')

    console.log(searchParams.fields) // [ 'name', 'age' ]

    searchParams.addField(null)
    console.log(searchParams.fields) // [ 'name', 'age' ]

    searchParams.addField('name')
    console.log(searchParams.fields) // [ 'name', 'age' ]

    Parameters

    • name: null | string

      字段名称。

    Returns void

  • 方法的作用是向搜索参数列表中添加一个参数。其中,参数列表由 QueryParameters 对象组成,该对象包含名称、值、标志和类型等属性。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 addParameter() 方法两次。第一次传入了名称为 'name',值为 'John Doe' 的参数,第二次传入了名称为 'age',值为 30,标志为 0,类型为 SQLDataType.int 的参数。我们可以看到,在每次调用中,该方法都会创建一个新的 QueryParameters 实例,并将其添加到实例属性 parameters 中。最后,该方法还会返回新增的实例,以便在需要时进行进一步操作。

    Example

    const searchParams = new SearchParameters()

    const q1 = searchParams.addParameter('name', 'John Doe')
    console.log(q1) // QueryParameters { name: 'name', value: 'John Doe', flag: null, type: null }

    const q2 = searchParams.addParameter('age', 30, 0, SQLDataType.int)
    console.log(q2) // QueryParameters { name: 'age', value: 30, flag: 0, type: 'int' }

    Parameters

    • name: string

      参数名称。

    • value: any

      参数值。

    • Optional flag: number

      参数标志,可选。第一位:1:and 2: or 第二位开始: 1:= 2:like:%% 3:like % 4:> 5:< 6:>= 7:<= 8:<> 9:like %@v 10:not like %@v 11:not like %@v% 12: not like 13:is null 14:is not null, 默认为:12

    • Optional type: any

      参数类型。

    Returns QueryParameters

    新增的 QueryParameters 实例。

  • 方法的作用是创建当前实例的副本。该方法会返回一个新的 SearchParameters 实例,并将当前实例的属性值复制到该实例中。

    Description

    以下代码创建了一个 SearchParameters 实例 searchParams1,并调用了 setName() 方法设置搜索条件名称为 'my-search'。然后,我们调用 clone() 方法创建了一个该实例的副本 searchParams2,并输出了副本实例的属性值。我们可以看到,副本实例的属性值与原始实例相同。

    Example

    const searchParams1 = new SearchParameters()
    searchParams1.setName('my-search')

    const searchParams2 = searchParams1.clone()

    console.log(searchParams2.name) // 'my-search'

    Returns SearchParameters

    新的 SearchParameters 实例。

  • 根据参数名称获取搜索参数列表中的参数对象。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 addParameter() 方法两次,向实例属性 parameters 中添加两个参数。然后,我们分别使用 get() 方法获取名称为 'name' 和 'gender' 的参数对象。我们可以看到,在第一次调用中,该方法返回了名称为 'name' 的参数对象,而在第二次调用中,该方法返回了 undefined。

    Example

    const searchParams = new SearchParameters()

    searchParams.addParameter('name', 'John Doe')
    searchParams.addParameter('age', 30)

    const p1 = searchParams.get('name')
    console.log(p1) // QueryParameters { name: 'name', value: 'John Doe', flag: null, type: null }

    const p2 = searchParams.get('gender')
    console.log(p2) // undefined

    Parameters

    • name: string

      参数名称。

    Returns undefined | QueryParameters

    匹配的 QueryParameters 实例,如果未找到则返回 undefined。

  • 方法的作用是获取是否关闭返回字段。该方法会返回实例属性 closeDes 的值。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 setCloseDes() 和 getCloseDes() 方法。我们可以看到,在调用 getCloseDes() 方法时,如果实例属性 closeDes 尚未设置,则返回 null;否则,返回相应的布尔值。

    Example

    const searchParams = new SearchParameters()

    console.log(searchParams.getCloseDes()) // null

    searchParams.setCloseDes(true)

    console.log(searchParams.getCloseDes()) // true

    Returns null | boolean

    是否关闭返回字段。

  • 方法的作用是获取要返回的字段列表。该方法会返回实例属性 desFields 的值。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 setDesFields() 和 getDesFields() 方法。我们可以看到,在调用 getDesFields() 方法时,如果实例属性 desFields 尚未设置,则返回 null;否则,返回相应的字段列表。

    Example

    const searchParams = new SearchParameters()

    console.log(searchParams.getDesFields()) // null

    searchParams.setDesFields(['name', 'age'])

    Returns null | string[]

    字段列表。

  • 方法的作用是获取数据源配置对象。该方法会返回实例属性 dsConfig 的值。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 setDsConfig() 和 getDsConfig() 方法。我们可以看到,在调用 getDsConfig() 方法时,如果实例属性 dsConfig 尚未设置,则返回 null;否则,返回相应的数据源配置对象。

    Example

    const searchParams = new SearchParameters()

    console.log(searchParams.getDsConfig()) // null

    searchParams.setDsConfig({ type: 'mysql', host: 'localhost', user: 'root', password: '123456' })

    console.log(searchParams.getDsConfig()) // { type: 'mysql', host: 'localhost', user: 'root', password: '123456' }

    Returns any

    数据源配置对象。

  • 方法的作用是获取搜索结果集的排序方式。该方法会返回实例属性 order 的值。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 setOrder() 和 getOrder() 方法。我们可以看到,在调用 getOrder() 方法时,如果实例属性 order 尚未设置,则返回 null;否则,返回相应的排序方式。

    Example

    const searchParams = new SearchParameters()

    console.log(searchParams.getOrder()) // null

    searchParams.setOrder('name DESC')

    console.log(searchParams.getOrder()) // 'name DESC'

    Returns null | string

    排序方式。

  • 方法的作用是获取搜索结果集分页模块。该方法会返回实例属性 pageModule 的值。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 setPageModule() 和 getPageModule() 方法。我们可以看到,在调用 getPageModule() 方法时,如果实例属性 pageModule 尚未设置,则返回 null;否则,返回相应的分页模块。

    Example

    const searchParams = new SearchParameters()

    console.log(searchParams.getPageModule()) // null

    searchParams.setPageModule('pagination')

    console.log(searchParams.getPageModule()) // 'pagination'

    Returns null | string

    分页模块。

  • 方法的作用是根据参数名称获取搜索参数列表中的参数对象 QueryParameters。如果参数列表为 null 或未找到指定名称的参数,则返回 undefined。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 addParameter() 方法两次,向实例属性 parameters 中添加两个参数。然后,我们分别使用 getParameter() 方法获取名称为 'name' 和 'gender' 的参数对象。我们可以看到,在第一次调用中,该方法返回了名称为 'name' 的参数对象,而在第二次调用中,该方法返回了 undefined。

    Example

    const searchParams = new SearchParameters()

    searchParams.addParameter('name', 'John Doe')
    searchParams.addParameter('age', 30)

    const p1 = searchParams.getParameter('name')
    console.log(p1) // QueryParameters { name: 'name', value: 'John Doe', flag: null, type: null }

    const p2 = searchParams.getParameter('gender')
    console.log(p2) // undefined

    Parameters

    • name: string

      参数名称。

    Returns undefined | QueryParameters

    匹配的 QueryParameters 实例,如果未找到则返回 undefined。

  • 方法的作用是删除搜索参数列表中指定名称的参数。其中,参数列表由 QueryParameters 对象组成,该对象包含名称、值、标志和类型等属性。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 addParameter() 方法两次,向实例属性 parameters 中添加两个参数。然后,我们使用 removeParameter() 方法删除名称为 'age' 的参数。我们可以看到,在调用该方法后,实例属性 parameters 中只剩下一个名称为 'name' 的参数。

    Example

    const searchParams = new SearchParameters()

    searchParams.addParameter('name', 'John Doe')
    searchParams.addParameter('age', 30)

    console.log(searchParams.parameters)
    // [
    // { name: 'name', value: 'John Doe', flag: null, type: null },
    // { name: 'age', value: 30, flag: null, type: null }
    // ]

    searchParams.removeParameter('age')

    console.log(searchParams.parameters)
    // [ { name: 'name', value: 'John Doe', flag: null, type: null } ]

    Parameters

    • name: string

      参数名称。

    Returns void

  • 方法的作用是设置是否关闭返回字段。该方法会将传入的参数值赋给实例属性 closeDes。

    Description

    以下代码创建了一个 SearchParameters 实例,并调用了 setCloseDes() 方法一次,设置是否关闭返回字段为 true。我们可以看到,在调用该方法后,实例属性 closeDes 的值被相应地更新。

    Example

    const searchParams = new SearchParameters()

    searchParams.setCloseDes(true)

    console.log(searchParams.closeDes) // true

    Parameters

    • closeDes: boolean

      是否关闭返回字段。

    Returns void

  • 方法的作用是设置要返回的字段列表。该方法会将传入的参数值赋给实例属性 desFields。

    Description

    以下代码创建了一个 SearchParameters 实例,并调用了 setDesFields() 方法一次,设置要返回的字段列表为 [ 'name', 'age' ]。我们可以看到,在调用该方法后,实例属性 desFields 的值被相应地更新。

    Example

    const searchParams = new SearchParameters()

    searchParams.setDesFields(['name', 'age'])

    console.log(searchParams.desFields) // [ 'name', 'age' ]

    Parameters

    • desFields: string[]

      字段列表。

    Returns void

  • 方法的作用是设置数据源配置对象。该方法会将传入的参数值赋给实例属性 dsConfig。

    Description

    以下代码创建了一个 SearchParameters 实例,并调用了 setDsConfig() 方法一次,设置数据源配置对象为 { type: 'mysql', host: 'localhost', user: 'root', password: '123456' }。我们可以看到,在调用该方法后,实例属性 dsConfig 的值被相应地更新。

    Example

    const searchParams = new SearchParameters()

    searchParams.setDsConfig({ type: 'mysql', host: 'localhost', user: 'root', password: '123456' })

    console.log(searchParams.dsConfig) // { type: 'mysql', host: 'localhost', user: 'root', password: '123456' }

    Parameters

    • dsConfig: any

      数据源配置对象。

    Returns void

  • 方法的作用是设置指定名称的分组的逻辑操作符。如果该分组不存在,则创建一个新的分组,并将其添加到实例属性 groups 中。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 setGroupLogic() 方法两次,设置了名称为 'group1' 和 'group2' 的分组的逻辑操作符。我们可以看到,在每次调用中,该方法都会根据传入的逻辑操作符设置逻辑值,并将其添加到实例属性 groups 中。注意,不同的逻辑操作符可以通过字符串或数字类型进行传递。

    Example

    const searchParams = new SearchParameters()

    searchParams.setGroupLogic('group1', 'or')
    searchParams.setGroupLogic('group2', 1)

    console.log(searchParams.groups)

    Parameters

    • name: null | string

      分组名称。

    • logic: any

      逻辑操作符。可选值为 'and' 或 1,表示逻辑与;'or' 或 2,表示逻辑或。

    Returns void

  • 方法的作用是设置搜索条件名称。该方法会将传入的参数值赋给实例属性 name。

    Description

    以下代码创建了一个 SearchParameters 实例,并调用了 setName() 方法一次,设置搜索条件名称为 'my-search'。我们可以看到,在调用该方法后,实例属性 name 的值被相应地更新。

    Example

    const searchParams = new SearchParameters()

    searchParams.setName('my-search')

    console.log(searchParams.name) // 'my-search'

    Parameters

    • name: string

      搜索条件名称。

    Returns void

  • 方法的作用是设置搜索结果集的排序方式。该方法会将传入的参数值赋给实例属性 order。

    Description

    以下代码创建了一个 SearchParameters 实例,并调用了 setOrder() 方法一次,设置搜索结果集的排序方式为 'name DESC'。我们可以看到,在调用该方法后,实例属性 order 的值被相应地更新。

    Example

    const searchParams = new SearchParameters()

    searchParams.setOrder('name DESC')

    console.log(searchParams.order) // 'name DESC'

    Parameters

    • order: string

      排序方式。

    Returns void

  • 方法的作用是设置搜索结果集分页模块。该方法会将传入的参数值赋给实例属性 pageModule。

    Description

    以下代码创建了一个 SearchParameters 实例,并调用了 setPageModule() 方法一次,设置搜索结果集的分页模块为 'pagination'。我们可以看到,在调用该方法后,实例属性 pageModule 的值被相应地更新。

    Example

    const searchParams = new SearchParameters()

    searchParams.setPageModule('pagination')

    console.log(searchParams.pageModule) // 'pagination'

    Parameters

    • pagemodule: string

      分页模块。

    Returns void

  • 设置前缀参数。

    Description

    以下代码创建了一个 SearchParameters 实例,并分别调用了 setPrefixParameter() 方法两次。第一次传入了字符串 'abc',第二次传入了 null。由于第二次传入的是 null,所以该方法没有改变实例属性 prefixParameter 的值。

    Example

    const searchParams = new SearchParameters()
    searchParams.setPrefixParameter('abc')
    console.log(searchParams.prefixParameter) // 'abc'

    searchParams.setPrefixParameter(null)
    console.log(searchParams.prefixParameter) // undefined

    Parameters

    • par: any

      前缀参数值。

    Returns void

Generated using TypeDoc