1、DORADO 5 快速入门 V1.1第 1 页 共 149 页DORADO 5快速入门(四)V1.1-Marmot 入门-BSTEK2007 年 6 月DORADO 5 快速入门 V1.1第 2 页 共 149 页DORADO 5 快速入门 V1.1第 3 页 共 149 页1. 前言 42. 下载以及安装 .72.1. 配置 Java 运行环境 72.2. 下载并解开 dorado5 开发包 .72.3. 相关资源 .73. 创建 Marmot 工程 .113.1. 创建 dorado 工程 .113.2. 拷贝运行库文件 .113.3. 拷贝 marmot 的系统资源 .123.4. 拷贝
2、 marmot 的核心 xml 配置文件 .133.5. 修改 web.xml 文件 144. 制作登录界面 .194.1. 概述 .194.2. 添加视图模型对象 204.3. 添加 dataset 对象 .204.4. 添加 AutoForm 224.5. 添加 label 和 button 244.6. AutoForm 引入 label 和 button 254.7. 添加 MarmotRPCCommand 对象 274.8. 添加 loginService .294.9. 创建 hr-context.xml 文件 .304.10. 创建 JSP .304.11. 运行测试 .315.
3、 制作主框架界面 335.1. 主界面说明 335.2. 实现 .346. 组织结构维护 .356.1. 部门维护 .356.1.1. 简述 356.1.2. 实现 376.2. 员工信息维护 676.2.1. 简述 676.2.2. 实现 686.3. 综合管理 .1206.3.1. 简述 1206.3.2. 实现 1206.3.3. 组件添加 1306.3.4. 浏览页面效果 .143第一章 前言第 4 页 共 149 页1. 前言DORADO5 是 BSTEK 公司推出的一种展现中间件技术，BSTEK 借助于自己在 J2EE领域的长期经验积累，以及对 AJAX 技术的敏锐把握和创造性的使
4、用之后，持续的在展现中间件领域推出自己的品牌产品，其中 DORADO5 是继 EXTRA3,DORADO4 之后的又一个里程碑式的产品，它带人们进入了 WEB2.0 时代。当今更多的业务系统选择 Brower/Server 架构，日益复杂的业务需求使 Web 界面与交互操作便捷也越来越复杂，而带来一个两难选择。一方面，此时用户已习惯享受随时随地通过浏览器访问并操作业务系统这种便利，而提出操作体验的更高要求，特别是用户经常以之前使用过的 C/S 版的软件系统的体验为基准，抱怨 B/S 系统难用，进而造成用户满意度下降。另一方面开发者在实现交互性复杂的用户界面时，往往需付出极其繁重的、低效而重复的
5、劳动，进而造成开发周期长、开发成本过高。或者牺牲开发成本来保持用户满意度，或者牺牲用户满意度来保持开发成本，面对这个两难选择似乎只能取其一，而随着 dorado 5 版本的推出，出现了一个新解：提高用户满意度同时降低开发成本，快速响应需求变化。dorado 音 ，英文指旗鱼、剑鱼，天文学中为剑鱼座，是海洋里游得最快的大型鱼类，时速可达 120 公里以上，它极其迅速而优雅地畅游于蓝色的海洋中。用dorado 来命名产品的寓意是：Web 应用开发迅速，Web 应用程序优雅而交互性极强。dorado 是下一代 web 应用的引擎平台，有效增进 Web 应用的用户体验与交互效率，并大幅提升开发效率。基
6、于 dorado 可以快速创建 Rich Internet Application 与 AJAX应用，使 B/S 应用保留 C/S 应用的优势。dorado 填补了 J2EE 架构中表述业务交互的架构空白，以标准化自动化的作业方式，低成本、快速实现业务交互层（包括用户界面，人机交互，界面与后台交互等）的用户需求，快速响应需求变化，同时提高用户业务操作的效率。近两年来，在 AJAX 技术的推波助澜之下， dorado5 的开发者群体也在日益扩大。本书通过一个实际的项目引领初学者快速地了解和掌握 dorado 编程。相信对于初学者有很好的参考价值和指导意义。由于编撰的工作量较大，在文档后期的很长一
7、段时间内我们仍会尝试不断的对其进行完善和补充。所以，当您有部分疑问无法从本书中找到答案时，您可以关注一下 对此文档的后续更新。或者您对本文档的有任何意见或建议， 也请通过 与我们联系。阅读群体本书属于 dorado 快速入门系列中的第四本，适合对 dorado 比较了解，能用第一章 前言第 5 页 共 149 页dorado 本身提供的框架体系快速的开发简单的系统的技术人员。在此之前最好先掌握和。在比较了解dorado 基本工作原理的情况下阅读本书更为有效。本书可用于正式的教学。本书主要使用 Marmot 框架实现提供的对 spring，hibernate 与 dorado 开发的整合。本
8、书重点在于帮助读者快速的掌握 Marmot 框架的核心部分。使技术人员可以利用Marmot 框架快速的搭建 spring，hibernate 等开源框架与 dorado 整合开发项目。关于marmot 框架的详细说明请下在 marmot 开发包：http:/61.151.239.187/download/marmot/marmot.zip 在开发包内部包含 marmot 的本文依然延续中的风格，并依然以实现 HR 为目标。通过对 dorado 中相关组件和 MarmotDataset 的使用，使读者能够了解 Marmot的基本使用技巧。本文中对于常用的 dorado studio 的常用操作技
9、巧和 dorado 中常用的词汇不再详细解释。详细内容请参考其他的参考文档。第二章 安装第 7 页 共 149 页2. 下载以及安装2.1.配置 Java 运行环境通过如下地址获取 JDK 开发包：http:/ dorado5 开发包通过如下的地址获取 dorado5 的开发包：http:/61.151.239.187/download/dorado/dorado5.zip详细设定参考。2.3.相关资源目前学习 dorado 可以获得的主要相关资源如下：BBS： http:/61.151.239.187/bbs技术支持电话：86-21-64260839（上海）86-10-51292870（北京
10、）020-89225055(广州)官方网站：http:/主要技术文章：文档 下载地址 开发包的 doc 目录中 开发包的 doc 目录中 http:/61.151.239.187/download/dorado/dorado5UserGuide.zip http:/61.151.239.187/download/dorado/dorado5ComponentsGuide.zip http:/61.151.239.187/download/dorado/dorado5PerformanceGuide.zip http:/61.151.239.187/download/dorado/dorado5
11、QuickStart1.zip http:/61.151.239.187/download/dorado/dorado5QuickStart2.zip 第二章 安装第 8 页 共 149 页 http:/61.151.239.187/download/marmot/marmot.zip 第四章 制作登陆界面第 9 页 共 149 页第三章 创建 Marmot 工程第 11 页 共 149 页3. 创建 Marmot 工程3.1.创建 dorado 工程参考创建一个 dorado 工程，命名为doradosample。图表 3-1 eclipse 工程3.2.拷贝运行库文件拷贝 marmot 所
12、需要的运行库文件：文件名 说明marmot.jar marmot 库的核心文件marmot-springmvc.jar 如果你使用了 Spring 的 MVC 处理页面流技术则需要添加该文件其他的库文件包括 spring 以及 hibernate 的运行库。附录中还包含的marmot/web/web-inf/lib 目录下可以拷贝。如下图：第三章 创建 Marmot 工程第 12 页 共 149 页图表 3-2第三方 jar 包列表：文件名spring.jarspring-hibernate3.jarhibernate3.jarjakarta-oro-2.0.8.jarcglib-2.1.ja
13、rasm-attrs.jarasm.jarjta-1-0-1a.jarehcache-1.2.3.jar3.3.拷贝 marmot 的系统资源拷贝 marmothome 文件夹覆盖新建项目的 home。图表 3-3 marmot 资源文件第三章 创建 Marmot 工程第 13 页 共 149 页其中主要新增的文件有：文件名 说明marmot-plugin.js homesmartwebv2lib 目录下javascript-lib.xml dorado js 库配置文件，用以引入homesmartwebv2lib 目录下的 js 文件，便于系统运行时自动的支持该 js 库文件。3.4.拷贝
14、marmot 的核心 xml 配置文件拷贝 webWEB-INFconfigs 目录到新建项目的 webWEB-INF 目录中，其中configs 文件夹下包含了 base-context.xml 为 marmot 的核心 bean 声明代码，jdbc.properties 文件为数据库链接配置文件。修改 jdbc.properties 文件，保证其中的路径配置正确，配置办法可以参考 中的工程创建部分的数据源连接。本例直接利用doradosample 提供的 HSQL 数据库实现，配置如下：#Thu Jan 04 16:09:12 CST 2007jdbc.url=jdbc:hsqldb:fi
15、le:D:/dorado5/sample/data/hsqldb/doradosamplejdbc.username=sajdbc.password=jdbc.driverClassName=org.hsqldb.jdbcDriver拷贝 src/log4j.properties 到新建项目的 src 目录下图表 3-4 核心配置文件另外还需要拷贝 web/WEB-INF 目录中的 spring-mvc-servlet.xml 到新建项目的web/WEB-INF 目录下。该文件只有在你的系统需要支持 Spring 提供的 MVC 时才需要。第三章 创建 Marmot 工程第 14 页 共 14
16、9 页图表 3-5 spring-mvc-servlet.xml3.5.修改 web.xml 文件在新建项目 web.xml 的代码顶部加入 context-param 配置：contextConfigLocation/WEB-INF/configs/*-context.xmllog4jConfigLocation/WEB-INF/classes/log4j.properties添加 filter：hibernateFilterorg.springframework.orm.hibernate3.support.OpenSessionInViewFilterhibernateFilter*.d
17、ohibernateFilter*.jsp添加 listener：第三章 创建 Marmot 工程第 15 页 共 149 页org.springframework.web.context.ContextLoaderListenerorg.springframework.web.util.Log4jConfigListener添加 Servlet：spring-mvcorg.springframework.web.servlet.DispatcherServletcontextConfigLocation/WEB-INF/spring-mvc-servlet.xmlspring-mvc*.do
18、以上代码在 marmot 开发包的 web.xml 中已经包含了模板文件：图表 3-6 web.xml 模板文件最终 web.xml 代码如下：contextConfigLocation/WEB-INF/configs/*-context.xmllog4jConfigLocation/WEB-INF/classes/log4j.propertiesdoradofiltercom.bstek.dorado.core.DoradoFilterdoradofilter/*hibernateFilterorg.springframework.orm.hibernate3.support.OpenSes
19、sionInViewFilterhibernateFilter*.dohibernateFilter*.jsporg.springframework.web.context.ContextLoaderListener第三章 创建 Marmot 工程第 17 页 共 149 页org.springframework.web.util.Log4jConfigListenerdoradoservletcom.bstek.dorado.core.DoradoServlet2doradoservlet*.dspring-mvcorg.springframework.web.servlet.Dispatc
20、herServletcontextConfigLocation/WEB-INF/spring-mvc-servlet.xmlspring-mvc*.dohttp:/ 制作登录界面第 19 页 共 149 页4. 制作登录界面4.1.概述下面我们利用 Marmot 框架实现登陆界面，利用 AJAX 技术将用户登陆账号和密码发送到 Server，而由 Spring 的 BeanFactory 中的一个 Bean 对象完成登陆校验。界面效果如下：图表 4-1第四章 制作登录界面第 20 页 共 149 页4.2.添加视图模型对象首先，在 src 中添加目录 hr，并在 hr 目录下新建 Login
21、视图模型。如下图：图表 4-24.3.添加 dataset 对象在 Login 视图模型中的 Datasets 节点下创建一个 FormDataset（dsLogin）来保存用户登录时输入的用户名和密码信息。我们修改新增的 dataset 的 id 为“dsLogin” 。第四章 制作登录界面第 21 页 共 149 页图表 4-3并展开 dsLogin 节点，选择 Fields 节点，利用快捷按钮添加两个新的 Field 对象。新加的 field 对象的 name 属性设置分别为 id 和 pwd， label 设置为用户名和密码。数据类型(dataType)都设置为 string。最终结果
22、如下：第四章 制作登录界面第 22 页 共 149 页图表 4-44.4.添加 AutoForm选择 controls 节点对象，并利用左侧快捷工具栏上的快捷按钮添加 AutoForm 组件将新增的 AutoForm 对象的 id 属性修改为 frmLogin。并设定 frmLogin 的 Dataset 属性为 dsLogin。 frmLogin 的基本属性设置如下：第四章 制作登录界面第 23 页 共 149 页图表 4-5保存前面所作的修改之后，利用 AutoForm 提供 Auto create elements 快捷菜单自动导入 dsLogin 中的信息，并生成 AutoForm 的
23、内部元素，展开 frmLogin 对象，可以看到一个 元素，这是自动生成的对象，我们设定自动生成的FormGroup 的 columnCount 属性为“1” ，title 属性为“登录” 。如下图：图表 4-6第四章 制作登录界面第 24 页 共 149 页展开中的 pwd 对象：图表 4-7选择 TextEditor，并设置 editorType 属性为 password。设置这个编辑框的类型为密码编辑框。4.5.添加 label 和 button重新选择 Controls 节点，并利用左侧的快捷按钮添加 Label 组件，增加一个 Label组件，并设定 id 属性为“labelDesc
24、”,text 属性为“* 用户名 : admin 密码 : admin *”：第四章 制作登录界面第 25 页 共 149 页图表 4-8同上方式添加一个 Button 组件，并设定新增按钮的 id 属性为 “btnLogin”,width为“60 ”,value 为“登录” 。添加后系统效果如下：图表 4-94.6.AutoForm 引入 label 和 button下一步我们利用 AutoForm 的容器功能，使将新增的两个组件对象引入到 AutoForm第四章 制作登录界面第 26 页 共 149 页中。选择 frmLogin 的节点，并利用快捷按钮添加两个 Custom Element
25、：图表 4-10设定新增的两个 Custom Element 的属性如下：图表 4-11其中的 controlId 属性分别设定为 “btnLogin”， “labelDesc”，使得这两个自定义第四章 制作登录界面第 27 页 共 149 页的元素与前面添加的 Label 以及按钮绑定。4.7.添加 MarmotRPCCommand 对象增加一个 MarmotRPCCommand（cmdLogin） ，设置 resolver 属性为“loginService”，method 设置为 “login”表示该 Command 将用户登陆信息发送到loginService 的 login 方法 (该
26、 Bean 将在下一节中定义 )中作验证。如下图：图表 4-12在 Studio 的 Login 视图模型中选择编辑界面下方的标签页 Events Inspector 切换到事件视图，并选择 cmdLogin 对象，并选择右侧的事件列表中的 beforeExecute 事件：第四章 制作登录界面第 28 页 共 149 页图表 4-13双击打开事件编辑器，输入如下的代码：var id = dsLogin.getValue(“id“);var pwd = dsLogin.getValue(“pwd“);command.parameters().setValue(“id“,id);command.
27、parameters().setValue(“pwd“,pwd);表示从 dsLogin 中取出用户名 id 和密码 pwd 放到 cmdLogin 的 parameters 中。并选择 cmdLogin 的 onSuccess 事件，打开事件编辑器输入如下的代码：open(“main.jsp”, “_self”);该事件在登陆校验成功之后触发。通过 open 方法我们将当前的页面跳转到主界面上，main.jsp 会在第五章实现。为了单击按钮时可以执行这个命令，我们将 btnLogin 按钮的 command 属性设置为cmdLogin。这样按钮被单击时，会自动地执行 cmdLogin 命令，
28、并最终会将登陆信息发送到 loginService 中作校验，下一步我们就是要在服务器定义一个 Bean，用来实现登陆验证。并配置到 Spring 中。第四章 制作登录界面第 29 页 共 149 页图表 4-144.8.添加 loginService在 src/hr 目录下添加 service 目录，并在 service 目录中添加LoginService.java，负责处理客户端得登陆校验，代码如下：package hr.service;import java.util.Map;import org.springframework.util.Assert;public class Logi
29、nService public Object login(Object parameter) throws Exception Map inParams = (Map) parameter;String userId = (String) inParams.get(“id“);String password = (String) inParams.get(“pwd“);Assert.hasLength(userId, “用户名不能为空！“);return null;第四章 制作登录界面第 30 页 共 149 页login 方法通过 parameter 对象获得参数用户登录时输入的 id 以及 pwd 信息。该处的用户名以及密码校验我们采用比较简单的判断处理(通过 Assert 工具类判断)。实际开发可灵活变通。4.9.创建 hr-context.xml 文件在 WebRoot/configs 目录中新建 hr-context.xml 文件。代码如下：其中粗体代码为在 spring 环境中注册 LoginService.java。4.10. 创建 JSP利用视图模型的 JSP 创建向导，在 WebRoot 根目录下创建 login.jsp，代码如下：
