eeplat开发文档

eeplat开发文档内容摘要：

据类型 配置界面 注意： 可以通过业务对 象的配置界面，创建业务对象，创建服务，创建面板，创建菜单，创建动态树，关联业务对象，关联工作流。 业务对象生成后，名称不要更改；如果更改名称，那么要把相应的缺省实现的服务的名称也要改掉。 主键类型包含： UUID,HI/LOW,NAITIVE(数据库原生类型如自 增 ),KEY_TYPE_ASSIGN_STRING(程序手动指定 STING 类型 ),KEY_TYPE_ASSIGN_LONG（程序手动指定整形）； 现在平台默认支持UUID,其它类型需要对生成的配置数据进行修改。 特征值列：可以不用指定，一般指实 体的名称，例如学生表里面的姓名。 数据源：如果业务对象的类型为基本表，必须指定。 可以通过这个界面创建服务、面板、菜单、动态树。 关联业务对象 通过外键关联其它业务对象。 在下面界面上选择本业务对象的列表，选择需要关联的其它业务对象。 点击 “生成关联 ”即可，生成的过程可能持续 10 几秒时间。 关联流程 把业务对象关联到某个流程下面，使该流程流转的是该业务对象的数据。 点击 “生成关联 ”即可，生成的过程可能持续 10 几秒时间。 导出 导出该业务对象的 XML 格式的交换文件，交换文件包含业务对象的 配置数据以及业务对象下面的所有属性、参数、服务、规则等配置数据，业务对象下面 UI 的所有配置数据。 删除 谨慎使用删除操作，删除将会把业务对象下面的所有配置数据全部删除。 业务对象属性 基本概念 业务对象属性指业务对象所拥有的属性。 对于类型为基本表的业务对象，属性基本是相应表的列名。 但是属性可以不对应列，列也可以不对应属性。 属性可以是一个集合，为属性定义一个查询服务，属性对应的是该服务执行返回的集合。 这种情况下一般用于处理业务对象之间一对多或多对多的情形。 属性的类型影响查询后数据的类型，如 果数据库中表的类型修改后，属性的类型也要进行修改。 参数一般会关联属性，表格元素一般也会关联属性，表格元素被提交后存储于业务对象总线上 FORM 节点 的 KEY 指使表格元素关联属性的名称（如果表格元素进行重命名那么用重命名的值）。 参数根据关联属性的名称从业务对象总线中取值（如果没有关联属性或根据 关联属性没有取到值，则根据参数名称）。 对应 JAVA 数据类型 配置界面 可以通过属性列表界面，查看、新增、修改、删除一个业务对象属性。 当新增业务对象属性后，系统会自动增加一个对应的参数，并会修改缺省实现的以 update、insert 结尾命名的服务的 sql 语句。 删除时，系统会自动删除对应的参数，并会修改缺省实现的以 update、 insert 结尾命名的服务的 sql 语句。 修改时，系统不会做相应的操作，需要手动修改。 注意：  如果属性对应于数据表中的列，则不能为空  数据库类型来自于 ,并不是物理数据库的类型。  平台内部基本处理类型包括 STRING， INT， LONG， DOUBLE， DATE， TIMESTAM， CLOB，BLOB；一般不需要指定，会自动进行匹配。 参数 基本概念 参数的作用主要是从业务对象总线上获取对应的值。 服务可以不定义参数，也可以定义一个或多个参数。 服 务中 sql 语句中的。 的数量要和参数的数量相同，并且按顺序对应（带通配符的服务，如自动条件查询，执行中，平台会自动根据参数补全 sql）。 这样服务就 通过参数获取总线上的值。 如果界面的表格元素采用重命名的方式，那么建立一个新的参数，参数的名称和表格元素重命名的名称一致，不定义业务对象属性，那么通过这个新建立的参数就可以得到表格元素对应的值。 参数类型： CURRENT：业务对象当前值 产生来源：  用户当前的点击选中  服务（刷新类型不是 REFRESH_NO）执行后对业务对象新增一条记录或修改一条记录，那么这条记录作为 CURRENT。  服务执行查询后，如果刷新类型为 REFESH_CURRENT， REFESH_ALL，如果查询返回多条记录，则把第一条作为 CURRENT,如果查询结果集为空，则不刷新。 默认情况下，只有 ID 字段生成了 CURRENT 类型的参数，但是其他字段和 ID 是等同的，可以通过增加参数的办法新增 CURRENT 类型 的参数。 GLOBAL_CUR：全局当前值 产生来源： 服务执行查询后，如果刷新类型为 REFESH_CURRENT， REFESH_ALL，如果查询返回多条记录，则把第一条作为 CURRENT,如果查询结果集为空，则不刷新。 LOGIN_ID， LOGIN_NAME， LOGIN_MAIN_STATION， LOGIN_MAIN_DEPT， LOGIN_KEY：登录相关 参见 业务对象总线 USER 的获取 DATE：当前时间， 类型 TIMESTAMP：当前时间， 类型 FORM：来自界面 参见 业务对象总线 FORM 节点 FORM_CAL：来自界面的 值可以经过一定的计算，计算表达式填放到备注字段。 还有一个用途是当参数的缺省值设为 checkbox 的时候，可以把多选的值以。 分割存放 NULL： NULL 值 RECURSION_PARENT： CURRENT 子类型，递归情况下父亲的值 KEY：主键 CODE：使用代码生成器，需要指定代码生成器 SCRIPT：参数的值来自于脚本，脚本填写在备注中 ACTION：参数的值来自于自定义动作，需要指定自定义动作 MD5： FORM 类型的子类型，对相应值做 MD5 运算 SECURITY_REVERS： FORM 类型的子类型，对相应值做可逆的加密算法 LUCENE_SEARCH： FORM 类型的子类型，使用 LUCENE 查询时，自动把 LUCENE 和数据库管理 LUCENE_CREATE： FORM 类型的子类型，当数据保存时，自动创建 LUCENE 索引 对应 JAVA 数据类型 配置界面 服务 基本概念 服务是描述业务对象的行为。 这个服务既可以是底层数据层面的操作，也可以是粗粒度的业务行为。 当一个数据表被初始化为业务对象后，会形成 6 个基本服务， 命名规则是业务对象 + _ + 后缀，后缀分别为 browse、 list、 insert、 update、 delete、 auto_condition。 一个面向底层数据操作的业务对象必须含有后缀为 browse 的服务，自动生成的该服务不要修改。 服务按照复杂程度可以分为两类 : 1. 基本服务，只定义的一个 sql 语句。 2. 一般服务，定义了自定义动作或者定义了规则。 一般服务如果定义有 sql 语句，那么可以 “退化 ”作为基本服务使用。 在配置中跟控制器的选择有关系，控制器的后缀名如果含有 uf，那么它既可以执行基本服务也可以执 行一般服务，否则只能执行基本服务。 服务按照操作类型可以分为： 1. 简单查询 定义的 SQL 语句只包含针对一个表的查询。 2. 查询 定义的 SQL 语句完成的是 select 操作 查询类的 SQL 语句，可以是分为两段，第一段是需要完成查询的 SQL,第二段是第一段 SQL 语句取回结果的数量，如 select * from demo。 select count(*) from demo 在一般情况下，都会写作 select * from demo 因为在需要结果集数量的场合，系统可以把后面的语句补写完整。 但是如果是非 常复杂的 SQL 语句，系统可能无法进行补写，需要写完整的两段。 1. 修改 定义的 SQL 语句完成的是 update 操作 2. 新增 定义的 SQL 语句完成的是 insert 操作 3. 保存 是新增或者是修改 4. 删除 定义的 SQL 语句完成的是 delete 操作 5. 自动条件查询 定义的 SQL 语句含有通配符 /*condition*/，运行时可以根据用户的输入自动匹配查询条件；如果需要排序，通配符为 orderby defaultcols desc@， 一个例子 (democo1 为默认的排序字段 )： select * from demo /*condition*/ orderby democol1 desc@ 改 变排序字段和排序方式需要通过表单传递，在查询表单上加两个下列列表，EXEDO_ORDER 表示排序字段， EXEDO_ORDER_TYPE 表示排序方 式，这两个下列列表的控制器均为 或 ，前者的相关配置： 排序字段名称 ,排序字段中文名。 排序字段名称 ,排序字段中文名。 排序字段名称 ,排序字段中文名。 后者为： desc,降序。 asc,升序。 如果有其它条件， /*condition*/ 要放到最后，如 where =1 /*condition*/。 1. 自动条件修改 修改的一种特殊形式， update 语句必须按照类似系统生成的严格格式编写，执行时系统会自动重新组装 sql 语句，用户录入的才修改，没有录入的不是置为 null，而是不作修改。 2. 自由查询 和自动条件查询的功能类似。 可以适用更复杂的情况，一个例子： select * from v_tbclass where objuid in (select objuid from v_tbclass minus (select fdclassid from V_STU_ALRDY_KAOQING WHERE 1=1 FDCLASSNUM[AND =39。 ?39。 ])) and 1=1 and fdhaspersons0 and fdifpassed=0 FDCLASSNUM[and fdtotaltimes=39。 ?39。 ], fdnianfen[AND fdnianfen=39。 ?39。 ],fdxueqiname[AND fdxueqi=39。 ?39。 ],fdgrade[AND fdgrade=39。 ?39。 ], fdsubject[AND fdsubject=39。 ?39。 ],fdclasslevel[AND fdclasslevel=39。 ?39。 ],fdarea[AND fdarea=39。 ?39。 ], fdxuequ[AND fdxuequ=39。 ?39。 ],fdclassareaname[AND fdclassareaname=39。 ?39。 ], fdclassroomid[AND fdclassroomid=39。 ?39。 ],fdteacherid[AND fdteacherid=39。 ?39。 ], fdclasstemplateid[AND fdclasstemplateid=39。 ?39。 ],fdstarttime[AND fdstarttime=39。 ?39。 ] 3. 自由保存 4. 脚本 定义一个 javascript 脚本，最后一行返回 sql。 5. 自定义动作查询 定义一个自定义动作，自定义动作返回一个结果集。 自定义动作查询属于基本服务。 自定义动作通过 setInstances 设置返回的结果集，结果集是一个BOInstance 的 List。 注意在这个自定义动作里面不能直接使用该服务的 invokeSelect()方法，否则要引起死循环。 服务定义的 SQL 语句会默认处理为小写，除非前面加上 /*keep*/以保持原来的大小写。 服务的执行 1. 简单执行 即只执行所定义的 SQL 语句， JAVA 代码 DOService aService = (服务名称 )。 ()。 //或者 2. 完全执行 指定所定义的规则、自定动作等。 如果定义了自定义动作，则不执行所定义的 SQL 语句。 JAVA 代码 DOService aService = (服务名称 )。 ()。 调用服务的表格元素控制器，如果是完全执行， 一般以 uf 为后缀。 服务可以通过修改 “业务对象 ”改变其隶属的业务对象，放到其它业务对象下面。 restful webservice 调用及可见性 可见性 ,包括公开 (public),保护 (protected),私有 (private)。 平台的服务可以通过 restful web service 的方式供外部访问。 restful web service 是一种轻量 级的 web service 的实现。