Rad工具使用说明

经典word整理文档，仅参考，转Word此处可删除页眉页脚。本资料属于网络整理，如有侵权，请联系删除，谢谢！1背景介绍...............................................................................................................................21.1Asura页面结构...............................................................................................................21.2Rad工具布局..................................................................................................................22单表实体示例.......................................................................................................................32.1创建项目.........................................................................................................................32.2创建模块.........................................................................................................................82.3创建实体.......................................................................................................................102.4创建功能......................................................................................................................1611背景介绍Asura架构中的基本页面布局如下：图1在上图中：项目：页面中就是访问的地址；模块：项目中包含模块，一个模块通常对应一个以及菜单（也可能不对应）；实体：与数据库中一个表对应的一个Java类；功能：对应模块下的一个具体菜单，通常对应一个或多个实体。Rad工具的基本布局如下：菜单栏区：包括项目、功能、工具、窗口、帮助等各种菜单命令；2工具栏区：提供一些常用菜单的快捷方式。主要有：新建项目、打开项目、保存、保存全部、新建模块、新建实体、新建功能、生成代码等；导航区：包括模块、项目、文件三种导航视图，分别浏览模块信息、项目配置和项目下的文件；主编辑区：用来查看、编辑各种配置信息；输出区：输出辅助的操作信息，说明相关操作执行的具体动作，便于用户监控。图22单表实体示例下面做一个单表的例子，使用户可以快速熟悉Rad工具的使用与操作。．1创建项目的过程如下：13>新建项目”（图4），还可以在导航面板中点右键菜单中的“新建项目”（图5）。3图3图4图52、之后你将看到“新建项目”的导航窗口，它将引导你一步一步创建自己的项目，首先，在第一页（图），是项目的基本信息设置，你输入好相应的代码后，点击下一步。需要输入的项有：项目代码：在Rad工具中显示的项目名(不能为中文)项目名称：项目的名称（可以为中文）项目描述：页面上方显示的项目信息，可简要说明项目的作用（最好为中文）如图6。图6所在路径：默认为本工具目录下\workspace（可以点击浏览自己选择）4图7testProject3、第二页数据库设置，选好“数据库类型”后，“JDBC”与“数据库连接串”会有初步的设置，你只需要修改连接串中的IP地址和ID即可，然后继续完成下面的设置。数据库类型：用户自己的数据库类型(目前有Oracle10g\Oracle9i\MySQL\SQLServer四项可供选择，但目前只支持Oracle数据库)JDBCDriver:JDBC驱动（有默认值、可修改）youroraclehost和yoursid，可修改）UserName:数据库管理的用户名5Password:数据库管理的密码图8:OracleJDBCDriver:youroraclehost:3yoursid:c2devdbUserName:166046Password:1660464、点击下一步后，如果出现图9的页面，则显示创建项目成功。点击完成则可，否则返回数据库设置重新设置。6图95、项目创建成功后，右下角会出现项目代码的加载进度条（图），稍等一会，新建的项目下会有四个缺省的系统模块，提供框架相关功能的实现。用户也可以手工修改这些模块的代码，但不建议用户在工具上对这些模块进行维护。图107图111、项目创建好后，接着就要创建模块了，可以选择菜单栏“功能—>新建模块”，也可以选择工具栏快捷按钮，我们用的是第三种方式，在要创建模块的项目上点击右键，选择弹出菜单的“新建模块”功能（图12）。图122、新建模块的第一页（图14），前三项都是要求用户输入，“所属项目”一项默认的是用户选中的项目，用户也可以选择往别的已存在项目中创建模块。模块代码：模块的代码，如果该模块下有功能，则会向TS_Module中填充一条记录；模块名称：模块的名称，会对应到页面的一个以及菜单图13模块描述：模块的简要描述所属项目：决定此模块归属哪个项目，默认为当前选中的项目，可选择。8图14testModule1113、模块创建好之后，可以在导航区的模块面板中相应的项目下找到它（图15）。新建好的模块会包含action\biz\domain\jsp\I18n等默认子节点。9图151、同样有三个选择：1菜单栏“功能—新建实体”；2工具栏快捷按钮“新建实体”；3在相应模块上点击出右键菜单（图）。图162、“新建实体”对话框首页中（图18），“实体名称”、“显示名称”需按要求输入，然后选择所对应的项目和模块，一般默认即可。最后选择好对应的表名。点击下一步。所属项目：决定此实体归属哪个项目，默认为当前选中的项目，可选择。所属模块：选中项目所包含的所有模块，默认为当前选中的模块，可选择。对应表名：选中项目对应数据库中的所有表名，表与实体只能一一对应，可选择。10实体名称：新建实体对象的名称，对每个实体将生成一个JAVA类。工具会根据表名按照命名规范生成一个缺省的类名，可修改。显示名称：生成页面上新增和修改页面中显示的名称图17图18TT_TEST_USER_SINGLETestUserSingle113、接下来设置的是字段映射，如图19的表所示：是/否映射——选择框，选中代表该字段需要被映射属性名——字段名的映射，可修改，不可为空显示名——页面中的显示名称，会在查询、编辑及列表中显示，若有映射关系，则不可为空字段名——已选表中所有字段名字段类型——字段所对应的类型，只能修改可隐式转换的类型（如Short可修改为Integer）长度——字段长度，字节为单位，可修改小数点位数——只有数值型的字段可以修改允许为空——设置字段是否允许为空，不能和表中的设置冲突设置好之后，点击下一步继续设置图19124、字段映射完成后，即需设置“设置主键信息与字段配置”，图20.主键字段——设置主键字段，必须是“Long”型字段主键生成器——主键字段的处理方式，系统对主键的处理是可以自动生成的。Sequence选择——如果采用SEQUENCE主键生成，则在此选择数据库的Sequence.版本号字段——HibernateMapping中的版本号字段。“创建人字段”等――实体的一些基本字段，如果设定了这些字段，系统会在用户修改或新增数据时自动给这些字段赋值；如果没有，可以为空。设置好之后，点击下一步图20testIdSEQUENCE13SequencecreatedEmpCodecreatedTmmodifiedEmpCodemodified5、最后一步是设置关联实体，如没有关联关系直接点击“完成”。如果有关联关系，点击“插入”，输入相应的代码即可。实体字段——本实体的关联字段关联实体——关联实体名称关联字段——与本实体相关联的字段关联类型——关联字段的类型本例无关联实体。图216、点击“完成”，实体创建成功后则出现在模块的“domain”子目录下，图22.14图227、现在可以打开实体编辑页面继续修改，也可以进行新建功能操作。图23151、菜单栏与工具栏的“新建功能”按钮都可以用，我们继续用右键菜单中的“新建功能”选项（图24）。图242、在弹出的新建功能第一页，是功能基本信息的设置（图27）。功能代码、功能名称、功能描述需用户输入，输入好后，选择功能所属的项目和模块及对应的实体。完成之后点“下一步”。所属项目：决定此功能归属哪个项目，默认为当前选中的项目，可选择所属模块：决定此功能归属哪个模块，默认为当前选中的模块，可选择对应实体：相对应的实体，功能必须与一个实体相对应，且该实体不能已经存在相关的功能，否则会覆盖已有的代码；功能代码：功能对应的功能代码，对应于TS_Module中的Module_Code，要求功能代码不能与项目代码、模块代码以及已有功能代码相同；功能名称：生成页面中功能的显示名（即模块标签下的子标签名）图25功能描述：功能的简要描述，会在页面中出现（下图中黄色背景中的字符）16图26图27TestUserSingle:TT_TEST_USER_SINGLEtestUserSingle328.可任意选择（如果全导航条——页面左侧的导航区域查询表单——查询页面区域17编辑表单——弹出的编辑表单对话框显示列表——数据显示区域图28对页面中每一部分的设置方法，以下分别说明：2.4.1导航树设置Action以及Biz方法暂时不生成，需要用户自己去添加和实现。数据来源Action：用户自定义的Action；对应实体名：导航树节点对应的对象类；KeyKey值来展开子节点；节点显示字段：导航树节点的显示名称，可以是节点对象的任意属性（目前不支持属性的组合）；18实体关联查询字段：页面对应实体属性中的一个字段，会根据该字段对实体进行查询。比如导航树的对象类为Department，其Key值为ID，页面对应的实体为User，选择的关键查询字段为DeptID，那么当用户点击导航树某个节点ID＝5时，会使用查询条件User.deptId=5去查询数据，并将查询结果显示到右侧的列表中；根节点关键字段初始值：导航树根节点Key的初始值；根节点显示字段初始值：导航树根节点的显示值。图29数据来源ActiondataSource.ActioncorrEntityNamenodeKeynodeNametestId19rootKeyrootNameAction2.4.2查询表单“查询表单”设置页面如图22所示：实体字段——对应实体中的各个字段列表，不可编辑是否显示——可选框，选中则会显示在查询表单中，至少需选择一个可显示输入方式——可选择多种输入方式单行文本输入:普通的文本框输入，只能单行输入图30日期输入弹出日历形式的输入器，选择日期即可完成输入时间输入同上，也是弹出一个时间选择框，选择完成就可以完成输入日期时间输入:日期输入与时间输入的集合输入图31组合框输入(ComboBox):下拉框式输入，数据源需用户自己输入20图32复选框输入(CheckBox):只有两种值，选择或不选图33校验方式——默认“无校验”，可选“数字范围校验”与“长度校验”图34组合框输入(ComboBox)选中输入方式中的组合框输入时，下方会出现一个“数据源”输入框，用来输入组合框的数据。此数据源只能有三种形式，示例如下：1：map类型，示例：男女2：list类型，是例：男,女3：action类型，示例：action:findByTestTeam.action,entity=testTeams,key=teamCode,value=teamName其中，action项是action名称，entity项是action返回的数据属性名称，key项是实体的关键字段，value项是显示字段。图35当有选中“是否显示”时，下方的“输入方式”和“校验方式”选择框可用（图36），也可在此设置选中字段的“输入方式”与“校验方式”。图36复选框输入(CheckBox)对CheckBox输入，只要需要设定该输入项的选中值和不选中值（通常为1和0）校验方式目前工具提供了两种校验方式：数字范围校验和字符长度校验。“校验方式”选中“数字范围校验”时，右下方会出现两个输入框，分别输入数字37了“最小长度”与“最大长度”，这时候输入长度的最小值与最大值即可（图38）。“数字范围校验”与“长度校验”的最大最小值都必须是整型数值。图3723图38testId是是是是是是是是否否否codenamegenderbirthdaydiscoverIssuesteamCodecreatedEmpCodecreatedTm24modifiedTmvalidFlag否是map:1=,2=女List:10大于1050大于50个action:findByTestTeam.action,entity=testTeams,key=teamCode,value=teamName111050100图39设置完成后（图39），点击“下一步”。252.4.3编辑表单编辑表单主要用来新增或修改数据，其配置界面如图40。其中上面的配置项有：表单宽度：弹出的编辑窗口的宽度，单位为象素；表单高度：弹出编辑窗口的高度，单位为象素；表单列数：编辑窗口中每行编辑的属性数目，输入多少，每行就有多少个输入项。设置表中各列含义如下：实体字段：对应实体中的各个字段，不可编辑；是否显示：可选，选中则在编辑表单中显示；可否编辑：可选，选中则在编辑表单中允许修改；可否为空：该字段是否可以为空，如果不为空，页面会做非空校验；输入方式与校验方式同查询页面说明。如实体有从表，则可在下方的表中设置从表配置，本例无从表，不再累述。26图401testId否是是否是是否否否codename是是是gender是是是是是是否否否否是是是是是是是是是是birthdaydiscoverIssues是teamCodecreatedEmpCode否createdTm否组合框输入（③）无校验是否modifiedTmvalidFlag否是复选框输入（④）无校验完成设置，点击“下一步”。2.4.4数据表格数据表格用来显示查询出来的数据，其设置页面，默认如图41：表单每页记录数：显示页面显示的最大行数表格中：27实体字段：实体中的各个字段；是否显示：可选，选中则在列表中显示；列宽：可输入，设置该属性在列表中的列宽，单位为象素；如果是0，则系统会自动分配列宽；允许排序：可选，是否允许列表安指定字段排序；显示格式：设置属性的显示格式，其中文本格式：记录显示为普通文本格式复选框显示：记录显示为复选框形式日期格式：记录显示为日期格式时间格式：记录显示为时间格式日期时间格式：记录显示为日期+时间格式数据转换：选中后，下方会出现转换的参数输入框（图），数据参数格式与ComboBox中的数据源输入方式相同，具体参见节。28图41图42本例代码：表单每页记录数：20实体字段testId是否显示列宽允许排序显示格式文本格式是是是是是是是是是是0000000000否否否是是是否否否否code文本格式name文本格式age文本格式gender文本格式birthdaydiscoverIssuesteamCodecreateEmpCodecreateTm日期时间格式文本格式文本格式文本格式日期时间格式29modifiedEmpCodemodifiedTm是是是000否否是文本格式日期时间格式文本格式validFlag设置完毕后，点击“完成”。添加完毕后，在jsp部分能看到新建的页面，如图43所示，则新建功能成功。图431、选择菜单栏“工具—生成代码”或工具栏上的快捷按钮（图）。图442、出现图45所示的消息对话框，说明代码生成成功。30图453、生成的代码存放在\workspace\testProject的code目录下。图46代码生成完毕后，即可直接通过工具生成的Ant脚本构建项目，构建出来的项目可以直接在Jboss上运行。前提条件：必须装有Ant和JBOSS（至少支持JDK1.5的）。1、在\workspace\testProject\build\scripts目录下中使用Ant命令，即打开build.bat文件。图47图472、成功后。可看到如下图的代码：图4831图49生成后的代码以war包的形式保存在\workspace\testProject\build\dist目录下，如图50，xml图50将生成的war包和配置文件拷贝到JBOSS安装目录下的\server\default\deploy中（图），并启动。图51JBOSS启动完毕后，在浏览器中输入“http://localhost/8080/testProject”,即可出现登录界面（图）。输入登录账号：admin密码：sf123456，应可登录进入系统。32图53正常登录后，即可看到生成的维护界面如下：33图54其中的权限管理图55为项目的默认模块，后面的图5634测试模块1、测试模块2为我们自己建的模块。本例生成的是“测试模块1”的“测试单表页面”图57打开后如下所示：图58左侧的导航树，因为需要用户自己完善，故没有数据。下图是点击查询后的页面（图59）35图59点击新增后的弹出页面（图60）图60选中数据后，点击修改的弹出页面（图）36图61选中数据后，点击删除的页面（）图62询页面设置）。37图63组合框输入的结果图64复选框输入的结果图65选择数字校验后的结果Eclipse或其他开发工具中对相关的代码或页面进行相应的编辑。3主从表示例下面再做一个主从表的示例：图6838如上图所示，先建好两个实体TestUser.domain与TestUserItem.domain。两个实体可以不在同一模块下。打开TestUser.domain的编辑页面并选择“与其他实体的关联