基于实体模型开发主题管理简析

简介:

实体模型主要实现单表操作(insert, update, delete, select),凡是需要这4条SQL语句要完成的功能,基本上都可以完成。多表处理的,需要用到关系模型,后续专门讲述。

前面写过一篇文章叫“主题切换及其管理”,连接地址为http://my.oschina.net/u/1245989/blog/165402

里面有详细的模型配置文件,但只是一个结果而已,接下来,对其进行详细剖析,讲述如何进进行配置。


?
1
2
< entity-model id = "theme" name = "theme" title = "主题"
     enable-delete = "true" enable-modity = "true" version = "2.0" cache-enabled = "true" >
上面是根节点,描述了模型的基本信息,几鼐enable-开头的标记,主要是为工具提供的参数,使得工具进行处理时,通过这些参数控制对文档的编辑,删除等处理。


?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
< groups >
   < group id = "basicgroup" name = "basicgroup" title = "基本字段"
     enable-delete = "true" enable-modity = "true" >
     < field standard-field-id = "theme_id" primary = "true" unique = "true"
       display = "false" not-null = "false" auto-increase = "false" editable = "false"
       hidden = "false" table-field = "true" id = "theme_id" />
     < field standard-field-id = "theme_code" primary = "false" unique = "false"
       display = "false" not-null = "false" auto-increase = "false" editable = "false"
       hidden = "false" table-field = "true" id = "theme_code" />
     < field standard-field-id = "theme_title" primary = "false" unique = "false"
       display = "false" not-null = "false" auto-increase = "false" editable = "false"
       hidden = "false" table-field = "true" id = "theme_title" />
     < field standard-field-id = "theme_css_path" primary = "false"
       unique = "false" display = "false" not-null = "false" auto-increase = "false"
       editable = "false" hidden = "false" table-field = "true" id = "theme_css_path" />
     < field standard-field-id = "theme_thumbnail" primary = "false"
       unique = "false" display = "false" not-null = "false" auto-increase = "false"
       editable = "false" hidden = "false" table-field = "true" id = "theme_thumbnail" />
   </ group >
</ groups >
上面定义了实体模型中的字段,一个实体的字段可以分成多个分组,这样即便于展现,又便于管理。所有字段都是引用标准字段的,标准字段相关内容参见元数据相关文章。其中field的属性:
?
1
table-field="true"


定义了其是否是一个表字段,实体模型对象与数据表是一一对应的,但是实体模型中的字段不一定都是建表所有的。

比如:我们要做一个用户管理,其中要做一个修改密码的功能,一般来说,修改密码都有一个重复输入密码的框来进行验证,避免用户打入时不小心输入错误,而无法登录的问题。很显然,我们在做功能的时候是需要有这个域的,但是在数据库表中,是不需要有这么个字段的,因此,可以通过配置其属性table-field="false",来增加这个域,但是以建表的时候,又忽略它。

如此,就可以把模型的字段定义好了。

模型上,有两种类型的操作对象可以配置,一种是操作,一种是视图。

下面逐个进行分析:

首先是新建操作


?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
< operation id = "thememodelopadduuid" name = "addTheme" title = "新增"
   enable-delete = "true" enable-modity = "true" type = "add" fixed-size = "false"
   modal = "true" >
   < operation-group id = "addopbasicgroup" name = "basicgroup"
     title = "操作字段" enable-delete = "true" enable-modity = "true" >
     < operation-fields >
       < operation-field editable = "true" hidden = "false"
         field-id = "theme_code" />
       < operation-field editable = "true" hidden = "false"
         field-id = "theme_title" />
       < operation-field editable = "true" hidden = "false"
         field-id = "theme_css_path" >
         < input-mode type = "textWholeLineMode" ></ input-mode >
       </ operation-field >
       < operation-field editable = "true" hidden = "false"
         field-id = "theme_thumbnail" >
         < input-mode type = "textWholeLineMode" ></ input-mode >
       </ operation-field >
     </ operation-fields >
   </ operation-group >
</ operation >
操作的基本描述:



?
1
2
3
< operation id = "thememodelopadduuid" name = "addTheme" title = "新增"
   enable-delete = "true" enable-modity = "true" type = "add" fixed-size = "false"
   modal = "true" >

type="add",是指这个操作的操作类型是什么,可选的范围在模型类型定义文件中获取,fixed-size表示窗口大小是否允许修改,如果是true,则表示不允许修改,如果是false,则可以修改。modal属性标明了是否是模式窗口,建议所有的操作都采用模式窗口方式。


?
1
2
< operation-group id = "addopbasicgroup" name = "basicgroup"
     title = "操作字段" enable-delete = "true" enable-modity = "true" >
操作分组,是一个嵌套结构,也就是说operation-group 节点下面可以有多个operation-group节点,上面只包含了基本的信息,实际上它下面还有大量的其它属性可用。


display-mode表明分组的显示方式,其值可以为:Tab,FieldSet,Wizard,Expander,Accordion,Carousel等,以控制字段的显示方式,实际上,通过配置display-mode及多层分组可以做出非常漂亮的界面组织形式,强烈建议必须掌握。如果不会用display-mode和operation-group嵌套,做出来的界面只能叫normal,如果会用的话,做出来的界面就是professional,差别是非常大的。

有时,界面中还要引用其它操作或视图的内容,显示在当前操作界面中。此时可以在operation-group节点下添加reference节点来完成:

?
1
< reference id = "" type = "operation|view" model-id = "" />

id为所引用对象的id,type可以有两种选择,operation或view,model-id表示引用的模型的ID,如果是当前模型,则可以忽略。

当然,引用的内容也有可能来自其它页面,这个时候可以用属性url=""的方式进行指定。

好吧,由于我们的主题管理太过简单,所以这些内容都没有用到,先跳过之。

?
1
2
< operation-field editable = "true" hidden = "false"
         field-id = "theme_code" />


指操作时用的字段,它只能从group中的field中进行引用。editable="true" 表示是否可编辑,hidden="false"表示是否隐藏。在它下面可以添加子节点input-mode,可以用来指定各种输入模式,如果不指定则表示用标准的文本输入框模式

?
1
< input-mode type = "textWholeLineMode" ></ input-mode >
通过指定输入模式,可以把我们的界面中的输入形式丰富起来。 


对于添加操作来说,没有查询字段,对于修改和删除字段,则需要添加查询字段,一般来说是主键,如果不配置查询字段,后续会非常严重!会导致全表删除或修改。

在修改及删除中就存在查询字段,来控制修改的范围。


?
1
2
3
4
< condition-fields >
   < condition-field editable = "false" hidden = "false"
     field-id = "theme_id" connect-mode = "AND" />
</ condition-fields >
其它的操作,基本类似。



?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
< view id = "thememodeloptableuuid" name = "tabletheme" title = "主题管理"
   enable-delete = "true" enable-modity = "true" type = "table" page-size = "10"
   allow-edit = "false" allow-filter-front = "false" fixed-size = "false"
   modal = "false" front-paging = "false" >
   < view-groups >
     < view-group id = "viewbasicgroup" name = "basicgroup" title = "基本信息"
       enable-delete = "true" enable-modity = "true" >
       < display-field editable = "false" hidden = "true"
         field-id = "theme_id" aggregate-by-view = "false" />
       < display-field editable = "false" hidden = "false"
         field-id = "theme_code" aggregate-by-view = "false" />
       < display-field editable = "false" hidden = "false"
         field-id = "theme_title" aggregate-by-view = "false" />
     </ view-group >
   </ view-groups >
   < references >
     < operation-reference type = "operation" id = "thememodelopadduuid" />
     < operation-reference type = "operation"
       id = "thememodelopaddcopyuuid" />
     < operation-reference type = "operation"
       id = "thememodelopdeleteuuid" />
     < operation-reference type = "operation"
       id = "thememodelopupdateuuid" />
     < operation-reference type = "operation"
       id = "thememodelopqueryuuid" />
   </ references >
</ view >
视图节点描述,除了基本的信息之外,需要注意的是type="table",这个类型可以有多种选择,具体参照模型类型定义文件  ,这里的是表格。后面定义了分布大小,窗口是否固定大小,是否模式窗口,是否支持前台分页等。


?
1
2
3
4
< view id = "thememodeloptableuuid" name = "tabletheme" title = "主题管理"
   enable-delete = "true" enable-modity = "true" type = "table" page-size = "10"
   allow-edit = "false" allow-filter-front = "false" fixed-size = "false"
   modal = "false" front-paging = "false" >

View-groups中可以有多个group,如果有多个group,支持二层表头模式,大致如下:


?
1
2
3
4
5
6
7
8
9
10
11
< view-groups >
     < view-group id = "viewbasicgroup" name = "basicgroup" title = "基本信息"
       enable-delete = "true" enable-modity = "true" >
       < display-field editable = "false" hidden = "true"
         field-id = "theme_id" aggregate-by-view = "false" />
       < display-field editable = "false" hidden = "false"
         field-id = "theme_code" aggregate-by-view = "false" />
       < display-field editable = "false" hidden = "false"
         field-id = "theme_title" aggregate-by-view = "false" />
     </ view-group >
   </ view-groups >


下面是引用的操作,引用了操作或视图后,可以在操作列表中显示相关的按钮,以便于进行相应的操作。


?
1
2
3
4
5
6
7
8
9
10
11
< references >
   < operation-reference type = "operation" id = "thememodelopadduuid" />
   < operation-reference type = "operation"
     id = "thememodelopaddcopyuuid" />
   < operation-reference type = "operation"
     id = "thememodelopdeleteuuid" />
   < operation-reference type = "operation"
     id = "thememodelopupdateuuid" />
   < operation-reference type = "operation"
     id = "thememodelopqueryuuid" />
</ references >

上面就引用了添加,修改删除,复制添加等操作。具体如下图所示:

下面是选择并修改主题的视图:
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
< view id = "thememodelopcarduuid" name = "cardtheme" title = "主题选择"
   enable-delete = "true" enable-modity = "true" type = "card" page-size = "0"
   allow-edit = "false" allow-filter-front = "true" fixed-size = "false"
   modal = "false" front-paging = "false" >
   < customize-stage-configs >
     < customize-stage-config stage-name = "card"
       view-path = "/biz/theme/theme_card.page" >
     </ customize-stage-config >
   </ customize-stage-configs >
   < condition-fields >
   </ condition-fields >
   < view-groups >
     < view-group id = "viewbasicgroup" name = "basicgroup" title = "基本信息"
       enable-delete = "true" enable-modity = "true" >
       < display-field editable = "false" hidden = "true"
         field-id = "theme_id" aggregate-by-view = "false" />
       < display-field editable = "false" hidden = "false"
         field-id = "theme_code" aggregate-by-view = "false" />
       < display-field editable = "false" hidden = "false"
         field-id = "theme_title" aggregate-by-view = "false" />
       < display-field editable = "false" hidden = "false"
         field-id = "theme_css_path" aggregate-by-view = "false" />
       < display-field editable = "false" hidden = "false"
         field-id = "theme_thumbnail" aggregate-by-view = "false" />
     </ view-group >
   </ view-groups >
</ view >
从配置可以看到,采用的类型是card类型,也就是卡片。


由于其渲染方式比较特殊,因此采用下面的配置来修改渲染模板为自定义模板:


?
1
2
3
4
5
< customize-stage-configs >
   < customize-stage-config stage-name = "card"
     view-path = "/biz/theme/theme_card.page" >
   </ customize-stage-config >
</ customize-stage-configs >
theme_card.page的文件内容如下: 
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
#@wijDialog("${modelDefine.id}_${operationDefine.id}" "${operationDefine.title}" "" $option $captionButtons)
#foreach($bean in $modelProcessResult.beans)
     < a href = "javascript:doChangeTheme('${TINY_CONTEXT_PATH}$bean.themeCssPath')" >< img title = "$bean.themeTitle" style = "float:left;border:1px solid;margin:5px 5px;width:50pt;" src = "${TINY_CONTEXT_PATH}$bean.themeThumbnail" /></ a >
#end
 
#end##dialog
 
< script >
     function doChangeTheme(path){
         var list=$("link");
         for(var i=0;i< list.length ;i++){
             var link = list .get(i);
             var pos = link .href.indexOf("/themes/");
             if(pos>0){
                 pos=link.href.indexOf(contextPath+"/");
                 link.href=link.href.substr(0,pos)+ path;
             }
         }
     }
 
</ script >


就产生了下面的窗口:

因此,只需要通过简单的配置就可以生成非常漂亮的界面。实际上,还支持数据校验等功能,上面没有演示。

只要在group下的field节点下,增加下面的节点即可:

?
1
2
3
4
< validate-rules >
   < validate-rule rule-name = "required" />
   < validate-rule rule-name = "max" rule-value = "30" />
</ validate-rules >
这里的校验规则同时支持前后台校验,也就是说,JS校验首先会通不过。

如果被使用者禁用了前台校验,直接向后台提交数据,还会进行一次后台数据校验,确保数据的合法有效。

当然,上面的文章还只是简明扼要的讲一下,详细参见开发手册。

相关文章
|
XML JSON 算法
【软件设计师备考 专题 】编写内部设计文档:构件划分图和接口
【软件设计师备考 专题 】编写内部设计文档:构件划分图和接口
56 0
|
2月前
|
传感器 运维
【软件设计师备考 专题 】编写外部设计文档:系统配置图和关系图
【软件设计师备考 专题 】编写外部设计文档:系统配置图和关系图
52 1
|
安全 Java API
设计一个小接口展开的讨论
设计一个小接口展开的讨论
设计一个小接口展开的讨论
|
数据可视化 测试技术 uml
【UML建模】(1) UML建模的初了解,概述,组成,作用
UML (Unified Modeling Language)是一种通用的可视化的建模语言,可以用来描述、可视化、构造和文档化软件密集型系统的各种工件。它不是一种程序设计语言。 UML 是独立于过程的,它可以在软件生命周期的各个阶段运用,不过主要应用于软件开发的设计与分析阶段。
350 0
【UML建模】(1) UML建模的初了解,概述,组成,作用
|
XML 前端开发 Java
从产品展示页面谈谈Hybris的特有概念和设计结构
从产品展示页面谈谈Hybris的特有概念和设计结构
207 0
从产品展示页面谈谈Hybris的特有概念和设计结构
|
SQL Java 关系型数据库
JSP+Servlet培训班作业管理系统[8]–实体模型类开发
本文目录 1. 本章任务 2. 代码实现 3. 总结
132 0
|
SQL 存储 数据库
其实添加数据也可以这样简单——表单的第一步抽象(针对数据访问层)《怪怪设计论: 抽象无处不在 》有感
更正:不好意思,昨天晚上思路有点混乱。有几个前提忘记说明了,现在补充一下。 1、缩小范围。按照由简到难的思路,这里先讨论最简单的添加数据的情况。就是单表的添加和修改;这里讨论的是webform的情况。
1066 0
【小试身手】几个自定义控件的组合应用,实现简单的“增删改查”功能(有源码)
     分页控件、查询控件、显示数据的控件和表单控件,终于把这几个控件结合在一起了,和在一起之后就可以让“增删改查”变的非常的简单和容易了,当然还需要数据访问函数库的支持。      综合演示的IDE是 vs2008,.net Framework2.0,C#, B/S 。
1025 0