API
Component

BizData ($UI/system/components/justep/data/bizData)

使用范围：UI2

Contents

component BizData ($UI/system/components/justep/data/bizData) extends Data

<b>使用场景</b>：页面上有复杂的后台数据交互时使用; <b>使用方法</b>：将组件拖入数据模型中，添加概念关联后台数据，可以对后台数据实现增、删、改、查; 

 
	BizData是和biz端createAction、queryAction、saveAction绑定的业务data
	refreshData对应执行queryAction
	saveData、deleteData对应执行saveAction
	newData对应执行createAction

Constructor Top

  BizData ()

Properties Top

Filter filters

数据过滤条件控制对象
Request.ActionParam newParam

[readonly]data的新增参数，为createAction准备的action请求参数
Request.ActionParam queryParam

[readonly]data的刷新参数，为queryAction准备的action请求参数
Request.ActionParam saveParam

[readonly]data的保存参数，为saveAction准备的action请求参数

Attributes Top

calculateRelation

[attribute]计算关系
columns = queryAction中select定义

data使用的关系，不能大于queryAction中select定义的范围
concept

操作的概念，需要和queryAction中定义的一致
String creator

新增数据的action，通常指定概念的createAction，当data数据不需要新增时可以不指定
filter

过滤
boolean isTree

是否树形数据
String orderBy

数据查询排序，如：sLastModifyTime:desc;sName:asc
String reader

获取数据的action，通常指定概念的queryAction
treeOption

树参数
String updateMode = whereVersion

数据更新模式,取值：whereVersion/whereAll
String writer

写数据的action，当保存或者删除数据提交时执行的action，通常指定概念的saveAction，当data数据不需要保存时可以不指定

Methods Top

String getActivity ()
String getNewAction ()
String getProcess ()
String getQueryAction ()
String getSaveAction ()

Events Top

void onDeleteError (ErrorEvent event)
void onNewCreateParam (NewCreateParamEvent event)
void onNewError (ErrorEvent event)
void onRefreshCreateParam (RefreshCreateParamEvent event)
void onRefreshError (ErrorEvent event)
void onSaveCreateParam (object event)
void onSaveError (ErrorEvent event)

Constructor details Top

public BizData ()

<b>使用场景</b>：页面上有复杂的后台数据交互时使用; <b>使用方法</b>：将组件拖入数据模型中，添加概念关联后台数据，可以对后台数据实现增、删、改、查; 

 
	BizData是和biz端createAction、queryAction、saveAction绑定的业务data
	refreshData对应执行queryAction
	saveData、deleteData对应执行saveAction
	newData对应执行createAction

Properties Detail Top

public Filter filters

数据过滤条件控制对象

public Request.ActionParam newParam

[readonly]data的新增参数，为createAction准备的action请求参数

public Request.ActionParam queryParam

[readonly]data的刷新参数，为queryAction准备的action请求参数

public Request.ActionParam saveParam

[readonly]data的保存参数，为saveAction准备的action请求参数

Attributes Detail Top

public calculateRelation

[attribute]计算关系

	包括属性：
		relation [attribute] 关系名

		type [attribute] 数据类型

	
		xml格式:
		<calculateRelation relation="calculateRelation" type="string"/>

public columns = queryAction中select定义

data使用的关系，不能大于queryAction中select定义的范围

public concept

操作的概念，需要和queryAction中定义的一致

public String creator

新增数据的action，通常指定概念的createAction，当data数据不需要新增时可以不指定

	xml格式：
	
		<creator action="/SA/task/logic/action/createWorkRecordAction"/>

public filter

过滤

	包括属性：
		name [attribute] 过滤名称
		
		filter [attribute] 过滤表达式
	
	xml格式：
	
		<filter name="filter1">sName="aaa"</filter>

See $UI/system/components/justep/data/data#filters

public boolean isTree

是否树形数据

public String orderBy

数据查询排序，如：sLastModifyTime:desc;sName:asc

public String reader

获取数据的action，通常指定概念的queryAction

	xml格式：
	
		<reader action="/SA/task/logic/action/queryWorkRecordAction"/>

public treeOption

树参数

	包括属性：
		parentRelation [attribute] 父关系，形成父子树的父关系
		rootFilter [attribute] 根过滤条件，当设置时树形数据将按节点加载数据
		delayLoad [attribute] 延迟数据加载，默认值为true
		nodeKindRelation [attribute] 节点类型关系，data操作时使用指定relation自动记录是否叶子节点信息
	xml格式：
	
		<treeOption parentRelation="" delayLoad="" rootFilter=""
			nodeKindRelation=""
			nodeLevelRelation="" />

See GetTreeOption

public String updateMode = whereVersion

数据更新模式,取值：whereVersion/whereAll

	
	BizData更新数据的原理:
		解决数据更新冲突平台采用乐观锁实现，简单说就是多个人同时更新一条数据时只会一个更新成功；
		平台中更新模式有两种：whereVersion,whereAll，其实还可以增加whereKey（目前没有）
		whereVersion更新数据时使用key和version作为条件更新，使用data的save时平台会自动维护version，也就是说在更新语句中会做version+1，当version变化时说明数据已经被人修改，当前更新失败回滚
		whereAll模式使用所有查询列的旧值做更新的条件，当条件不满足就说明数据已经被人修改，当前更新失败回滚
		从数据严格性上说：whereKey<whereVersion<whereAll
		平台BizData默认使用whereVersion

public String writer

写数据的action，当保存或者删除数据提交时执行的action，通常指定概念的saveAction，当data数据不需要保存时可以不指定

	xml格式：
	
		<writer action="/SA/task/logic/action/saveWorkRecordAction"/>

Methods Detail Top

public String getActivity ()

获取data对象指定的activity

Return Value

String

public String getNewAction ()

获取新增biz action 名，对应creator属性

See Creator

Return Value

String

public String getProcess ()

获取data对象指定的process

Return Value

String

public String getQueryAction ()

获取查询biz action 名，对应reader属性

See Reader

Return Value

String

public String getSaveAction ()

获取保存biz action 名，对应writer属性

See Writer

Return Value

String

Events Detail Top

public void onDeleteError (ErrorEvent event)

[回调型事件]直接删除数据失败

Parameters

ErrorEvent event


结构如下：

{ "source" : 组件的js对象, "errorType" : 'server', "errorNode" : 错误信息, "httpError" : http请求失败(true/false), "httpState" : http请求返回码 }

Return Value

void

public void onNewCreateParam (NewCreateParamEvent event)

[回调型事件]业务新增数据创建新增参数事件，可以增加和修改用户自定义的参数

See NewData

See NewParam

Parameters

NewCreateParamEvent event


结构如下：

{ "source" : 组件的js对象, "param" : {Request.ActionParam} 新增参数对象, "table" : {List<$UI/system/components/justep/data/data#Row>} 新增行的默认值数组 ，数组的长度决定新增行数，数组中的对象是列的默认值 "options" {Object} 新增传入的参数,如果是tree时可以使用options.parent获取父行对象 "defaultValues" : {Object} - 新增行的默认值表达式字符串，支持使用Biz的fn函数，如果fName默认值是'abc'那么正确写法是defaultValues['fName']=justep.Util.toExprString('string','abc')，当table上没有给出默认值时使用此默认值表达式，建议简单默认值尽量使用table参数 defaultValues格式：{列名:默认值表达式,...} }

Return Value

void

public void onNewError (ErrorEvent event)

[回调型事件]新增数据失败

Parameters

ErrorEvent event


结构如下：

{ "source" : 组件的js对象, "errorType" : 'server', "errorNode" : 错误信息, "httpError" : http请求失败(true/false), "httpState" : http请求返回码 }

Return Value

void

public void onRefreshCreateParam (RefreshCreateParamEvent event)

[回调型事件]业务刷新数据创建刷新参数事件，可以增加和修改用户自定义的参数

See Request.ActionParam

Parameters

RefreshCreateParamEvent event


结构如下：

{ "source" : 组件的js对象, "options" {Object} 新增传入的参数,如果是tree时可以使用options.parent获取父行对象 "param" : {Request.ActionParam} 刷新参数对象 "offset" : 取数据的偏移 "limit" : 取数据的条数 }

Return Value

void

public void onRefreshError (ErrorEvent event)

[回调型事件]刷新数据失败

Parameters

ErrorEvent event


结构如下：

{ "source" : 组件的js对象, "errorType" : 'server', "errorNode" : 错误信息, "httpError" : http请求失败(true/false), "httpState" : http请求返回码 }

Return Value

void

public void onSaveCreateParam (object event)

[回调型事件]业务数据保存创建保存参数事件，可以增加和修改用户自定义的参数

See Request.ActionParam

Parameters

object event


结构如下：

{ "source" : 组件的js对象, "param" : {Request.ActionParam} 保存参数对象 }

Return Value

void

public void onSaveError (ErrorEvent event)

[回调型事件]保存数据失败

Parameters

ErrorEvent event


结构如下：

{ "source" : 组件的js对象, "errorType" : 'server', "errorNode" : 错误信息, "httpError" : http请求失败(true/false), "httpState" : http请求返回码 }

Return Value

void