十分钟玩转EasyCode(快速指南与演练)

系统主界面

(建议:在窗口最大化模式下阅读本说明)

EasyCode是一款全新的、功能极为强大的.Net软件辅助设计与代码生成系统,EasyCode不仅可以为您生成专业级“同时支持多数据库的三层架构”数据访问源码,还可以为您生成专业级的系统模块界面。使用EasyCode绝不只是简单的对数据库进行反向工程,你可以轻松解决:类与类之间的交互引用、类与数据库表之间映射、数据访问中的多表关联等问题。

EasyCode还贴心的为您提供了:在线翻译与自动匹配属性名称、生成及执行数据表的创建SQL,导出各类开发常用文档(WORD2003格式)、直接预览所设计系统的运行时效果等功能,让您的系统设计开发工作,真正事半功倍。EasyCode也十分容易使用,您只需花几分钟时间阅读完本文档,便可以轻松掌握EasyCode所提供的强大功能。

1.使用帐号登录系统

系统Login界面

在您下载并解压最新版本的EasyCode绿色版压缩包后,双击运行“EasyCode.exe”,运行EasyCode主程序。系统会出现“用户登录”窗口,输入您所注册的EasyCode帐号和密码,单击确定按钮后就可以进入系统主界面。如果您没有EasyCode帐号,可以根据界面提示先注册一个新的帐号,并获取3天的免费试用许可。单击此处了解EasyCode的帐号及许可信息。 在您进入系统后,仅需3步(设置项目信息、设计基础对象/类、设计功能模块)便可以轻松设计出专业、美观的.Net软件信息系统。

2.项目信息设置

使用用户帐号登录进入EasyCode后,系统会自动为您创建一个空的新项目。单击界面上方导航条中“开始”区域的按钮,可以新建、打开、保存EasyCode的项目文件(后缀名为.project),在您第一次进入系统时,系统为建立文件关联,之后您双击project文件,EasyCode会自动帮您打开。您也可以将您设计项目保存为project文件,与给您的朋友或同事分享,以便共同开发一个系统或相互学习。

单击“设计”区域的“项目信息”按钮,进入“项目信息设置”界面,里面包含4个TabPage选项卡页面,项目信息设置主要内容及相关注意要点如下:

项目信息设置

基本信息:设置或填写所要设计项目的中文项目全称、设计人员、项目说明。EasyCode在生成Visual Studio项目源文件时:会根据内置的界面模板,使用“项目全称”生成一张系统的Logo图片供界面显示,使用“设计人员”中的内容为每个所生成的代码文件开头加上作者注释。(如项目全称:员工信息管理系统、设计人员:李雷、韩梅梅)

命名空间:设置或填写所要设计项目的命名空间信息。EasyCode所生成的项目源代码基于“三层架构”,采用CompanyName.ProjectName.LayerName对不同层的命名空间进行命名,您可以根据实际情况填写公司名称、项目名称、以及各层的名称,系统会以项目名称作为VS解决方案的名称,需要注意的是所有命名空间都应当为英文。(如公司名称:NASA、项目名称:HRSystem)

项目模板:设置或填写当前设计项目所要使用的项目模板。目前EasyCode模板类型有Asp.Net和WinForm(3.0版本推出SilverLight及WPF)两种,都包含了一套基于Outlook经典样式的模板(将不断免费扩充),请根据需要选择项目所要使用的模板类型,EasyCode在生成Visual Studio项目源文件时,会根据模板类型分别生成Asp.Net/WinForm项目。

数据存储:设置或填写当前设计项目所要支持的数据库种类及相关配置信息。EasyCode所生成的Visual Studio项目源代码,可以同时支持多种主流数据库,当后台数据库发生变更时,仅需修改应用程序配置.config文件,无需修改任何代码。您在此处配置的数据库连结信息,也可以用于直接在EasyCode中生成并执行数据库脚本,以创建相关的数据表。

演练:

您可以使用当前所安装的数据库系统,SqlServer、Oralcle、Access均可,建立一个空白的数据库(Access请使用2000文件格式),数据库名称为HRSystem。使用“数据存储”选项卡中的配置功能,建立与您所使用的数据库的连结,并设为默认。

3.基础对象设计

在您设置完项目的基础信息后,单击“设计”区域的“基础对象”按钮,就可以开始对您系统中的基础对象(类)进行设计了。在基础对象设计界面的中间,显示当前项目中已有的基础对象(类)的列表,右侧有一排按钮可以用于添加、修改、删除当前项目中的类,列表的上方有“由数据库中的表导入为类”链接。EasyCode完全遵循面向对象设计开发的准则,推荐您先对系统中相关的类进行分析和设计,而不是直接进行面向数据库的设计。

基础对象设计

单击右侧的“添加”按钮,系统弹出基础对象(类)设计窗口,在“基本信息”选项卡上可以设置或填写类的名称、友好名称、功能描述、对象类型等信息。EasyCode在生成Visual Studio项目源文件时:会根据类的名称(英文)建立相应的cs文件及代码、根据友好名称和功能描述分别生成相关的提示与注释信息。

EasyCode中的对象类型有“普通基础类”、“数据转换类”、“数据访问类”3种,在您切换不同类型时,窗口中的TabPage选项卡也会发生相应变化,不同类型的主要功能与区别如下所述:

普通基础类:EasyCode在生成“普通基础类”的代码时,仅在数据实体层生成代码,所生成的代码包括类的属性定义与相关注释,不具备数据库访问功能,或作为其它类的一个属性被引用。“普通基础类”仅用于生成类的代码主体框架,以便于手工进行改写等用途。

数据转换类:EasyCode在生成“数据转换类”的代码时,仅在数据实体层生成代码。数据转换类与枚举十分相似,主要供其它类作为一个属性进行引用。如“性别”在数据库存储为数字编号,但在界面上需要显示为“男”等应用。“数据转换类”在设计时必须要进行“可引用性”设置,以便被其它“数据访问类”进行引用。

数据访问类:EasyCode在生成“数据访问类”的代码时,会分别在数据实体层、业务逻辑层、数据访问层生成相关代码,使其具备增删改删、数据分页等功能。并可以为关联的模块生成增删改查界面、关联的数据表生成SQL创建脚本。“数据访问类”通过“可引用性”设置,也可以作为其它“数据访问类”的一个属性,从而实现多表关联操作。

下面将对不同类型对象的设计方法和要领进行详细阐述。

数据访问类设计

在您使用EasyCode添加新的基础对象(类)时,对象类型默认便为“数据访问类”,弹出基础对象(类)设计窗口中包括基本信息、类的属性、数据映射、列表显示、控件绑定、可引用性6个选项卡。

基本信息设计

在“基本信息”选项卡上填写类的名称、友好名称、功能描述等信息(如类的名称:Employee、友好名称:员工信息、功能描述:用于实现员工信息的维护。关联数据表:TblEmployee),并设置对象类型为“数据访问类”后,单击“类的属性”卡开始对类中的属性进行设计。你可以在界面中依次填写属性的友好名称、属性名称、属性类型、描述信息。其中友好名称用于作为类代码中属性名称的注释,并且可以在生成界面时,作为属性关联控件前的Lable显示。

基础对象设计

类的属性设计

EasyCode更加推荐您一次完成所有友好名称的输入,再单击“自动翻译友好名称为属性名称”链接将中文的友好名称自动翻译为英文的属性名称,之后在“属性类型”列的标题栏上右击,系统会弹出“批量设置属性类型”菜单用于批量设置属性类型。EasyCode还支持粘贴多行文本或以逗号分隔的文本作为类的友好名称,您可以尝复制以下蓝色的文本,之后在“友好名称”列的标题栏上右击,选择“粘贴整列友好名称”看到实际效果,再通过“自动翻译”与“批量类型设置”功能,轻松快速的完成类的的属性设计工作。

演练:

员工信息主要包括信息有:自动编号,工号,姓名,性别,出生日期,身份证号,民族,政治面貌,婚姻状况,户口所在地,所在部门,现居住住址,毕业学校,所学专业,毕业时间,学历,联系电话,紧急联系人,紧急电话

复制上面的蓝色文本之后,在属性设计选项卡中右击“友好名称”标题栏完成粘贴,单击“自动翻译友好名称为属性名称”链接,右击“属性类型”标题栏批量设置属性类型为string,修改自动编号的“属性类型”为int,出生日期的“属性类型”为DateTime。

基础对象设计

数据映射设计

EasyCode的属性类型输入具备代码联想功能,在您完成上面的演练后,便可以单击“数据映射”选项卡,对当前类所关联的数据表、及映射关系进行设计。您可以直接单击“数据映射”选项卡中的“快速匹配数据列的名称与类型”链结,让EasyCode自动帮您设置“数据列名称”、“数据列类型”、“数据列大小”信息(如果您完成了上面的演练,您可以看到“自动编号”的数据列类型被设置为了“整数”、“出生日期”的数据列类型被设置为了“日期”),之后再手工对相关的信息进行调整。EasyCode允许数据列名称与属性名称不同,也可以将某个属性的“数据列类型”设置为“不关联”,之后您可以设置属性是否为主键、是否为自动编号、可否为空等信息(如指定自动编号属性为主键、自动编号、不可为空)。需要注意的是:一个对象最多只能有一个主键和自动编号,主键应当是没有意义的、不会因为人为失误创建记录后再进行修改的。

在您完成数据映射设计工作的同时,实际上您也已经完了关联数据表的设计,EasyCode此时已经可以为您生成并执行关联数据表的SQL创建脚本,我们将在下文继续介绍。如前文所述:EasyCode中的“数据访问类”可以用于生成界面,下面我们介绍一下如何使用EasyCode进行相关界面的设计。

列表显示设计

单击“列表显示”选项卡,进入信息列表显示样式设计界面。我们在设计信息系统时,常需要将业务对象的主要信息设计成一个可以分页显示列表,供用户检索查看。“列表显示”选项卡主要用于设计当前类中哪些属性显示于信息列上、显示的宽度、居左居中居右等信息。您可以单击“自动设置列表显示与宽度”链接,让EasyCode自动根据数据列名称与大小帮您设置列表的显示样式,之后再手工根据实际需求进行调整。您还可以通过鼠标右击相应的标题栏,进行“全部居左/中/右”、“批量设置显示宽度”、“全部显示/不显示”操作。其中列表显示宽度可以为*号,用于表示自适应宽度,我们强烈建议您每个列表至少有一个*号自适应宽度列。

基础对象设计

在EasyCode中您可以直接预览代码生成后的列表界面显示效果,单击“在新窗口预览列表显示效果”链接,EasyCode将根据您的设置,快速实时生成列表显示界面供你参考,您可以通过预览与调整设置的交替快速设计出美观的界面效果,而无需等到Visual Studio解决方案生成之后,可以大大提高您的开发效率。

控件绑定设计

单击“列表显示”选项卡,进入属性与界面控件绑定关系设计界面。默认情况下查看界面所关联的控件都为文本标签,添加和修改界面所关联的控件都为文本框。您可以单击“自动设置控件类型与大小”链接,让EasyCode自动根据属性类型与大小帮您设置相关控件的类型与显示大小,之后再手工根据实际需求进行调整。您也可以鼠标右击相应的标题栏,进行批量设置操作。其中标签宽度、控件宽度、间隔宽度、新行显示、分组显示标题的含义如下图所示:

基础对象设计

由上图可以看出通过合理设置标签宽度、控件宽度、间隔宽度、新行显示、分组显示标题,我们不用在Visual Studio中编写任何Html或拖拽任何控件,就可以轻松获得专业、美观系统界面,并且如同“列表显示”设计一样,您可以随时单击“在新窗口预览控件显示效果”链接,随时预览界面显示效果并进行调整。

通过上图可以看出“性别”和“所在部门”通常应使用下拉框控件,但如果我们指定其编辑界面控件为下拉框时,EasyCode会提示“仅当属性的类型为其它“可引用的自定义对象”时,关联控件才可以设置为下拉框。”,关于如何进行“可引用性设置”及“实现多表关联”我们在下文中继续介绍。如果您同时也在参照本说明进行演练操作,请您单击“确定”按钮,保存该员工信息对象(类),系统将会关闭基础对象设计窗口,返回到基础对象列表界面。

数据转换类设计

在软件系统的设计开发过程中,我们常会碰到如:性别(男/女)、人员状态(正常/病假/事假/出差)、会员类型(普通会员-0.9折/高级会员-0.8折/黄金会员-0.7折)这类在数据库中需要存为数字编号,但在界面上需要显示为中文字符的属性或字段。单独为这些字段建立一张表显得比较浪费,直接在下拉框或其它代码中写“死”又显得不够灵活,如果在多处使用修改起来也很麻烦。使用枚举类型,在与下拉框或列表控件(Repeater、DataGridView)进行绑定时,又需要增加许多额外代码。EasyCod中的“数据转换类”可以有效的解决此类问题。

单击基础对象列表界面右侧的添加按钮,弹出基础对象设计窗口,在“基本信息”选项卡中设置对象类型为“数据转换类”,可以发现窗口中的TabPage数量由6个变为4个,分别为基本信息、类的属性、内置数据、可引用性。基本信息与类的属性选项卡中的内容,您依然可以像设计“数据转换类”一样使用“粘贴整列”、“在线翻译”、“批量设置属性类型”等功能来进行快速属性设计。

演练:

1.添加一个新的基础对象,类的名称为:“Sex”,友好名称为:“性别”,对象类型设置为:“数据转换类”;

2.在“类的属性”选项卡中增加两个属性,友好名称、属性名称、属性类型分别为:“编号、Id、int”和“名称、Name、string”;

3.在“内置数据”选项卡中依次输入两行数据:“Male、1、男”和“Female、2、女”;

4.在“可引用性”选项卡中选中“该类可以作为其它数据访问类的一个属性被引用”,用作界面显示的属性选择“Name”,用作数据存储的属性选择“Id”。

基础对象设计

单击“确定”按钮,便完成了一个“性别”数据转换的设计。下面我们看看如何在之前建立的“员工信息”类中,将“性别”类作为一个属性来引用,以解决数据存储与界面显示信息内容不同的问题。

将“数据转换类”作为其它“数据访问类”的一个属性

演练:

1.双击基础对象列表中之前所创建的“员工信息”类,在弹出的对象设计窗口中,单击“属性设计”选项卡,将属性“性别”的“属性类型”,由原本的“string”删除并重新输入为“Sex”;

2.切换至“数据匹配”选项卡,使用“快速匹配”功能,会发现数据列名称已由原先的“Sex”变为“SexId”,数据列类型也由文本变为了整数(也可手工修改)。

3.切换至“控件绑定”选项卡,使用“自动设置”功能,会发现“性别”属性的关联的添加和修改控件,都由“文本框”自动设置成了“下拉框”(也可手工修改)。

单击“确定”按钮,便完成了将“性别”对象作为“员工信息”对象的一个属性进行引用,EasyCode在生成代码时,会自动生成相关联的数据访问代码及界面控件绑定代码。

将“数据访问类”作为其它“数据访问类”的一个属性

前文中曾提到EasyCode可以轻松处理多表关联的数据访问,我们之前所设置的“员工信息”类,已经可以做到将“性别”属性与下拉框进行绑定、在界面上显示中文性别名称而在数据库存储为数字编号。“员工信息”类的“所属部门”信息通常需要可以由用户维护,因此我们在做设计时,会建立一个“部门信息”类及一张关联的数据表,如何让“员工信息”的“所属部门”属性,在数据库中存为“部门信息”的编号,而在界面显示为“部门信息”的名称呢?请看如下演练:

演练:

1.添加一个新的基础对象,类的名称为:“Department”,友好名称为:“部门信息”,对象类型设置为:“数据访问类”,关联数据表为:“TblDepartment”;

2.复制本段中的蓝色文本:“自动编号,部门名称,经理姓名,联系电话,备注说明”,在属性设计选项卡中右击“友好名称”标题栏完成粘贴,单击“自动翻译友好名称为属性名称”链接,右击“属性类型”标题栏批量设置属性类型为string,修改自动编号的“属性类型”为int;

3.切换至数据映射选项卡,使用“快速匹配”功能,设置属性“自动编号”为主键、自动编号、不可为空,属性“备注说明”的数据列类型为“超长文本”、数据列大小为空;

4.分别切换至“列表显示”和“控件绑定”选项卡,依次使用“自动设置”功能,预览列表显示及控件绑定界面;

5.切换至可引用性选项卡,选中“该类可以作为其它数据访问类的一个属性被引用”,用作界面显示的属性选择“DepartmentName”,用作数据存储的属性选择“Id”。

6.单击确定按钮,保存“部门信息”类,返回到基础对象列表。

7.双击基础对象列表中之前所创建的“员工信息”类,在弹出的对象设计窗口中,单击“属性设计”选项卡,将属性“所在部门”的“属性类型”,由原本的“string”删除并重新输入为“Department”;

8.切换至“数据匹配”选项卡,使用“快速匹配”功能,会发现数据列名称已由原先的“Department”变为“DepartmentId”,数据列类型也由文本变为了整数(也可手工修改)。

9.切换至“控件绑定”选项卡,使用“自动设置”功能,会发现“性别”属性的关联的添加和修改控件,都由“文本框”自动设置成了“下拉框”(也可手工修改)。

单击“确定”按钮,便完成了将“部门信息”对象作为“员工信息”对象的一个属性进行引用,从而实现了多表关联数据访问的设置,EasyCode在生成代码时,会自动生成相关联的数据访问代码及界面控件绑定代码。

普通基础类设计

如果您已经阅读了上文中的内容,并且按照提示进行了相关演练,那么你已经掌握了:如何设计EasyCode中的“数据访问类”、“数据转换类”,如何将一个对象作为另一个对象属性进行引用,如何实现多表关联数据访问的设置。同时,您也了解了EasyCode中的“在线翻译”、“快速数据匹配”、“批量设置”、“自动设置列表与控件”、“实时预览界面效果”等好用、实用功能。

那么如何设计一个普通基础类,一定难不到您。普通基础类仅需设置类中的属性,本文中将不在赘述。

4.功能模块设计

在您设计完项目信息和基础对象(类)后,如果您不进行功能模块设计,此时其实也可以进行:生成Visual Studio的解决方案、生成项目中类的三层框架代码、生成数据库创建SQL脚本,生成常用的开发说明文档等操作。但所生成的生成Visual Studio的解决方案中,将只有一个欢迎界面,而没有之前您所设计对象的相关增删改查界面。“功能模块设计”就是用于对您系统中的功能模块如何划分进行设计,并指定系统中所设计的对象以何种界面形式进行展现。

单击“设计”区域的“模块划分”按钮,进入“功能模块设计”主界面,界面中包含模块分组和功能模块两个信息列表,通过列表旁的按钮对分别对其中的信息进行维护。每个模块分组中都可以包含若干个功能模块,EasyCode在生成Visual Studio解决方案时,会根据模块分组与其中的功能模块生成相应的导航菜单。

模块分组

演练:

1.单击添加功能模块按钮,在弹出的功能模块设计窗口中,输入如下信息,模块名称:“员工信息管理”、所在路径:“ManageEmployee”、模块类型:“列表-添加-修改-删除”,设置相应的按钮图片和主题图片,切换至“参数设置”选项卡选择“关联基础对象”为“Employee”,单击“确定”按钮保存“员工信息管理”模块。

2.单击添加模块分组按钮,在弹出的添加模块分组窗口中,输入如下信息,模块分组名称:“系统设置”,单击“确定”按钮保存模块分组。

3.选中刚创建的“系统设置”模块分组,可以发现右侧功能模块列表中有一个空白模块,双击该空白模块修改其中的信息,模块名称:“部门信息管理”、所在路径:“ManageDepartment”、模块类型:“列表-添加-修改-删除”,设置相应的按钮图片和主题图片,切换至“参数设置”选项卡选择“关联基础对象”为“Department”,单击“确定”按钮保存“部门信息管理”模块。

4.单击“系统运行时界面效果预览”链结,查看系统界面效果预览。

模块分组

5.生成VisualStudio解决方案

单击“设计”区域的“VS项目”按钮,进入“Visual Studio项目生成选项”界面,设置或填写项目的类型、Visual Studio的版本(2008/2010)、输出路径信息,单击“立即生成”按钮后,EasyCode便会开始生成您所设计的项目,EasyCode所生成Visual Studio解决方案源代码文件,包含有详细的注释且没有使用任何第三方控件或dll,您可以放心的进行使用和扩充改写。