浪潮Loushang Studio使用手册

浪潮LoushangStudio使用手册山东浪潮齐鲁软件产业股份有限企业修订历史版本号修改人修改日期摘要V1.0-创立文档V1.1郑洋-11-6增长广西国税版Studio功能V2.0郑洋-12-28增长StudioV2.0功能并修改文档整体格式V2.0江燕-2-11修改3.4节视图DataSourceExplorer和5.4节通过数据库中的表和视图生成E-R模型

目录1 安装 22 配置应用服务器 22.1 简介 22.2 定义服务器运行时 22.3 定义服务器实例 23 配置数据库连接 23.1 简介 23.2 定义JDBC驱动 23.3 定义数据库连接 23.3.1 采用通用的数据库连接向导 23.3.2 采用特定数据库类型向导 23.4 视图DataSourceExplorer 24 新建Loushang项目 25 创立E-R模型 25.1 数据构造 25.2 新建模型文献 25.3 设计模型 25.4 创立数据库表 26 生成代码 27 数据来源定义 27.1 下拉框 27.1.1 来源于表 27.1.2 来源于枚举值 27.2 联动下拉框 27.3 弹出框 27.3.1 来源于系统 27.3.2 来源于表 27.4 联动弹出框 28 布署Loushang项目及调试代码 28.1 布署Loushang项目 28.2 设置断点 28.3 系统调试 2安装简朴地将获得的压缩文献包解压缩即可使用、不需要复杂的安装过程。启动根目录下的start.bat即可启动studio工具。图1-1配置应用服务器简介Studio对应用服务器的管理分为服务器运行时(Runtime)的管理和服务器实例(Server)的管理；服务器运行时，就是硬盘上的一种应用服务器安装，但不包括配置文献；服务器实例，就是在运行时上加上配置文献；这样，硬盘上的一种应用服务器安装在studio工具里可以作为多种服务器使用（配套不一样的配置文献）。Studio工具在第一次使用时会自动定义服务器运行时和服务器实例对应studio工具自带的tomcat5.5；假如不想使用工具自带的tomcat，可以参照本节的后续小节，自己定义服务器。定义服务器运行时在“Window”“Preferences”中，找到“Server”节点，并展开选择“InstalledRuntimes”，如下图所示，(下图中显示的运行时：ApacheTomcatv5.5(Built-in)就是studio工具自动定义的)图2.2-1点“Add”按钮，可以定义新的运行时，以tomcat举例：图2.2-2

在tomcat服务器配置页面中定义好名称、tomcat的安装目录，使用哪个jre。图2.2-3选择“Finish”按钮，完毕tomcat服务器的配置。定义服务器实例可以通过新建向导进入服务器实例新建界面，菜单途径为：“File”“New”“Other”，选择Server类别下的Server节点，点击“Next”按钮。图2.3-1也可以通过视图”Servers”里的右键菜单进入新建界面，如下图：图2.3-2在新建界面中输入主机名并选择应用服务器类型，然后再选择一种服务器运行时：图2.3-3点击“Next”,进入向该服务器添加/删除web应用的界面：图2.3-4点击“Finish”完毕服务的创立。在Servers项目下可以看到我们新创立的服务。图2.3-5此外虽然在服务器实例定义好了，也可以通过视图“Servers”的右键菜单添加/删除web应用：图2.3-6视图Servers对应用服务器的管理大部分都可以通过视图Servers开始，除了前面提到的新建服务器实例、增长/删除web应用外，尚有服务器的起停、公布、监控、调试都可以通过它进行。假如该视图不在工作区，可以手动打开：通过菜单“Window”“ShowView”“Other”,选择Server节点下的Servers节点。项目Servers该项目的存在使得可以以文献的方式管理服务器实例的配置文献：图2.3-7配置数据库连接简介Studio工具对数据库的管理分为驱动程序的管理和数据库连接的管理：驱动器管理就是定义驱动程序jar包在什么位置；数据库连接管理就是定义数据库的url以及对应的顾客名和密码。 定义JDBC驱动在“Window”“Preferences”中，找到“Connectivity”节点，并展开选择“DriverDifinitions”，可以看到驱动程序的分类目录：图3.2-1我们以oracle9i版本为例，选择Oracle类型下的“9”，没有发现该版本的驱动，点击“Add”新增该版本的驱动。进入选择驱动模板和定义驱动名称界面，我们选择“OracleThinDriver”，采用默认的驱动名称，并将立即定义新驱动选项选中，点击“OK”。图3.2-2在设置驱动界面，会出现驱动包找不到的错误，我们重新编辑选择Oracle驱动包的对的位置。图3.2-3将其改为我们在jdbc文献夹中提供的classes12.jar图3.2-4此时，在Oracle类型“9”版本节点下展现了我们刚刚定义的驱动：图3.2-5定义数据库连接可以通过新建向导进入数据库连接新建界面，菜单途径为：“File”“New”“Other”，选择ConnectionProfile类别下的ConnectionProfile节点，点击“Next”按钮进入数据库连接的新建向导：图3.3-1图3.3-2也可以通过视图”DataSourceExplorer”里的右键菜单进入新建界面，如下图：图3.3-3进入“创立数据库连接向导”，有两种创立数据库连接的向导。一种是通用的数据库连接向导，另一种是针对特定数据库类型的向导。两者的区别在于，后者根据特定数据库的特性，简化了数据库的设置项，使顾客更轻易操作。采用通用的数据库连接向导选择“GenericJDBCConnection”，点击“Next”。图3.3-4进入基本信息设置界面。填写连接的名称为“loushang”；描述配置项因是可选项，可不必填写；考虑性能问题，对于启动时连接数据库配置项，采用默认不选状态。点击“Next”。图3.3-5进入数据库连接的详细设置界面。点击下拉框选择JDBC驱动。输入数据库对应的url、顾客名和密码、并选中”SavePassword”。图3.3-6然后点击TestConnection测试连接配置与否成功，假如弹出对话框显示PingScucceed表达配置成功，否则配置失败。图3.3-7点Next进入明细界面，假如有些设置项不合理，可以选择“Back”进行重新设置。图3.3-8点击“Finish”，完毕数据库连接的创立。采用特定数据库类型向导还是以Oracle数据库为例。直接选择“OralceJDBCConnection”，点击“Next”按钮。图3.3-9进入数据库连接基本信息设置界面，填写名称为“loushang2”，选择“Next”。图3.3-10进入数据库连接详细设置界面。和通用数据库连接向导不一样的是，数据库驱动只显示Oracle类型；顾客以填写主机地址和端口来替代修改URL，提高易操作性。在这里采用默认的数据驱动。根据实际状况设置主机地址、端口、数据库名称及顾客名和密码。选中”SavePassword”点击“Next”。图3.3-11进入设置明细界面，假如有些设置项不合理，可以选择“Back”进行重新设置。图3.3-12点击“Finish”按钮，完毕数据库连接的创立。同样会在“DataSourceExplorer”视图下看到新增的“loushang2”连接。视图DataSourceExplorer视图DataSourceExplorer提供了数据库维护中比较常用的功能，包括连接数据库，查看数据库中的表和视图，并对表中的数据进行维护等。该视图假如不在目前工作区，可以通过通过菜单“Window”“ShowView”“Other”,选择Connectivity节点下的DataSourceExplorer节点打开。连接数据库打开DataSourceExplorer视图，在Databases节点下会显示出已经配置好的数据库连接。选择一种数据库连接节点，在右键菜单中选择Connect，如下图，这样就可以连接上对应的数据库了。图3.4-1查看数据库内容连接上数据库之后，展开数据库连接节点，就可以查看数据库中的详细内容了。展开以数据库名命名的节点，根据数据库类型的不一样，会列示出该数据库的内容。下图中展示的是一种Oracle数据库，展开Schemas节点，会列示出该数据库中所有的Schema。选择要查看的Schema，并展开该节点，会列示出该Schema中的详细内容。展开对应的节点，可以查看表、视图等内容。图3.4-2关闭数据库连接假如不需要连接数据库了，为了节省系统资源，可以关闭该连接。措施是：选择一种数据库连接节点，如图3.4-1，在右键菜单中选择Disconnect，这样就可以关闭连接了。新建Loushang项目在菜单中选择“File”“New”“Project”，在新建项目向导中选择“Loushang”“LoushangWebProject”。图4-1选择“Next”设置新建项目，在项目名称中输入项目名：例如Loushang，选择“Next”按钮。图4-2此时出现功能组件选择向导，各选项保持默认值，点击“Next”。图4-3进入web项目设置界面，设置web项目的上下文、内容目录和Java源目录，我们采用默认值。点击“Next”。图4-4出现选择数据设置界面，选择先前我们设置的“loushang”数据库连接，也可以点击右侧的“New…”新建数据库连接，详细环节参照“创立数据库连接”章节。选中“Initializedatabase”进行loushang应用环境的数据库初始化。下图所示。图4-5选择“Finish”开始创立Loushang项目及数据库的初始化。在新建Loushang项目向导完毕的最终，假如目前透视图不是Loushang透视图会提醒顾客与否选择用Loushang项目视图查看项目文献。图4-6选择“Yes”，打开Loushang视图，看到通过向导创立的Loushang项目文献。图4-7假如在建完项目后需要修改数据库连接配置，在Loushang项目上点击右键，选择属性“Properties”：图4-8在打开的Loushang属性窗口中单击ChangeLoushangDatabase，在右侧窗口的下拉框中选择需要连接的数据库，假如尚未定义，可以点击“New…”，之后的配置与上面配置数据库连接措施相似。图4-9假如需要，可以选择初始化数据库：图4-10点击“OK”即可自动修改Loushang项目中的数据库连接。创立E-R模型LoushangStudio提供模型编辑器，生成的模型文献扩展名是.diagram，每个模型表单独对应一种.table文献。通过向导可以建立模型文献，一种模型文献中包括1个或多种单表或者主从表模型。完毕模型设计后可以生成对应的代码，也可以在连接数据库后直接创立数据库表。下面分别展示Studio的模型设计、代码生成和创立数据库表功能。数据构造以PERSON表为例阐明单表功能，表构造如下：表5-1字段名称中文描述类型长度备注ID内码VARCHAR20PrimaryKeyCODE编码VARCHAR20NAME姓名VARCHAR30SEX性别CHAR10：男1：女新建模型文献在loushang项目的model文献夹上选中右键菜单的“New”“NewE-RDiagram”：图5.2-1输入要建模型文献的文献名后，点击finish图5.2-2点击Finish可看到下图，左边的设计区域，右边是控件选择面板，下面就可以开始设计模型了。图5.2-3设计模型在打开的diagram文献中，选择面板中的表放到文献中。图5.3-1双击表，弹出表属性对话框，设置表的基本信息如下，点击Finish。图5.3-2图5.3-3选择字段，添加到表中。图5.3-4双击添加的字段，在弹出窗口中设置字段信息，点击Finish。图5.3-5图5.3-6尚有此外一种措施添加字段信息，双击表，弹出表属性对话框，选择第二个选项卡页“字段列表”：图5.3-7填充其他三个字段信息如下：图5.3-8不用管自动添加的最终一行，点击Finish，并点击“保留”按钮，模型设计完毕。图5.3-9注意：不容许直接修改文献系统中的table文献和diagram文献的文献名和内容，假如要修改，必须通过E-R图修改后保留，才能对的生效。通过数据库中的表和视图生成E-R模型除了使用5.3节中的措施在E-R模型编辑器中新建表模型外，LoushangStudio还支持从数据库中拖拽已存在的表和视图到E-R模型编辑器中，详细的措施如下：在第3节中，已经简介了配置数据库连接和通过DataSourceExplorer视图查看数据库中的表和视图的措施。这里要先保证已经通过第3节中的措施，连接上了数据库，并且通过DataSourceExplorer视图可以查看到表和视图，如下图：图5.4-1在Tables节点下选择一种表，点击鼠标左键同步拖动鼠标到E-R模型编辑器的设计区域，松开鼠标，该表就自动转换成表模型，显示在编辑器中，如下图：图5.4-2也可以在Views节点下选择一种视图，点击鼠标左键同步拖动鼠标到E-R模型编辑器的设计区域，松开鼠标，该视图就自动转换成视图模型，显示在编辑器中，如下图：图5.4-3通过数据库中的表和视图转换生成的E-R模型与在E-R编辑器中新建的表模型具有相似的功能，都可以作为生成代码的数据模型。创立数据库表LoushangStudio同步提供创立数据库表的功能，前提条件是数据库连接正常。右键选择菜单创立数据库表图5.4-1在弹出的窗口中，选择数据库连接，点击Finish。图5.4-2生成数据库表的sql语句如下：图5.4-3假如数据库表中存在该表，则会提醒如下信息：图5.4-4选择“yes”，则会将数据库中的表删除，然后重新建表；假如选择“no”，则创立失败。图5.4-5生成代码在新建的模型表的右键菜单或区域中的任何位置的右键菜单中选择生成代码，弹出生成代码向导。图6-1在定义窗口向导的第一种页面，先选择生成代码方式。我们提供四种内容的生成代码方式：前端、后台、所有代码和不生成代码，只保留窗口，点击Next：图6-2之后出现“定义窗口构造”页面。（注意：假如上页选择的是生成后台代码时，不转向到该页面）点击左侧树型菜单中的新窗口，右侧出现窗口内容列表：图6-3填充列表如下，在“选择主表”中我们E-R图的所有模型都会在这里显示，选择一种主表后，E-R模型的Java包途径和JSP途径就会自动展目前下方，此处是不可以修改的，假如要修改必须回E-R图中修改：图6-4接着，我们添加窗口节点的子节点，在“人员信息维护”窗口的右键菜单中选择“增长表单”，则增长一种“Form”；假如是主从表，则“增长列表”就是增长一种“EditGrid”；“增长面板”则是增长一种容器，容器中可以放除widow外的其他构件；“增长选项卡”就是增长“Tab”，选项卡下可以增长若干个选项卡页，即“Card”。图6-5我们增长一种表单，填充列表如下，展现对象选择“PERSON”，与模型关联后，自动填充字段列表。可以通过“上移”和“下移”按钮调整页面上展现字段的前后次序：图6-6注：假如定义窗口向导第一种页面选择只生成前台代码或只保留窗口不生成代码时，则不显示该页面，上页面中“Finish”按钮变为可选，直接结束生成代码。图6-7点击“Next”，显示“公布为web服务”页面：图6-8当“选择公布为web服务”选中时，下面的增、删、改、明细四个复选框变为可选并选中，可以调整公布为web服务的措施：图6-9提醒“成功生成代码”。图6-10查看生成一种.window文献，保留窗口模型，还生成了java文献、jsp和xml配置文献。图6-11数据来源定义在实际项目中，我们常常会碰到某些字段中的数据来源于此外的表或人为定义的状况，我们统一将这些状况归为需要定义数据来源，如下我们分三种状况讲解。下拉框来源于表为讲解数据来源定义，我们修改E-R模型。为PERSON表增长两个字段PROVINCE（省或直辖市）和CITY（市），从数据库中拖出PUB_CANT表，只保留如下四个字段，新E-R图如下：图7.1-1在刚刚生成的person.window文献中的右键菜单中选择“loushang”“生成代码”菜单，可以修改我们刚刚生成的窗口模型。（注：我们不支持手动修改窗口模型的任何值，只支持通过向导修改）图7.1-2在向导的第二个页面，我们在表单中双击“PROVINCE”字段，弹出“域定义”窗口，在展现类型中选择“下拉框”，此时“数据来源定义”按钮变为可用。图7.1-3点击“数据来源定义”按钮，弹出“数据来源定义”对话框，默认数据来源类型为“来源于表”。输入框我们支持手动输入，也支持选择。在表名字段处单击右键，点击“请选择表”；图7.1-4弹出的窗口列出了E-R图中的所有表，我们选择PUB_CANT，点击“OK”图7.1-5在“显示字段”处的右键菜单中点击“请选择列或域”图7.1-6在弹出窗口中有选择列和选择域两个复选框，“选择列”列出的是刚刚表名中的所有列的字段名，而“选择域”列出的是窗口模型中所有域的域名。我们选择“CANT_NAME”字段，点击“OK”。图7.1-7相似的措施，我们填充“返回字段”为“CANT_CODE”。假如我们只让下拉框中显示省或直辖市一级的记录，则在查询条件中填写“CANT_TYPE=’1’”图7.1-8此时，来源于表的下拉框已定义完毕。来源于枚举值性别是枚举字段，我们双击“性别”字段行，弹出属性定义框。在展现类型中选择“下拉框”，“数据来源定义”按钮变为可用，点击“数据来源定义”按钮：图7.1-9选择来源于枚举值，点击“增长”按钮，增长对应枚举值后点击“OK”：图7.1-10回到表单定义页面后点击“Next”“Finish”，生成代码：图7.1-11生成代码后的成果如下：图7.1-12图7.1-13联动下拉框常常的，我们会碰到下拉框中的值是随界面上某个值的变化而变化的状况，如下例子中我们以省、市两个字段为例，阐明联动下拉框的配置方式。在生成代码配置窗口双击“CITY”字段，在“域定义”窗口的“展现类型”中选择“下拉框”，单击“数据来源定义”按钮。图7.2-1在弹出窗口中填写“表名”、“显示字段”和“返回字段”如下。通过查询数据库我们得知，每个都市是通过“SUPER_CODE”来标示是哪个省的，在“查询条件”中右键单击，点击“请选择列或域”菜单，选择“SUPER_CODE”字段。图7.2-2然后再输入“=’@@’”，其中“@@”表明来源于窗口域中的值。我们把光标放在两个@之间，右键选择“请选择列或域”。图7.2-3在弹出窗口中选择“选择域”，然后选择“PROVINCE”域，点击“OK”返回。图7.2-4配置好的界面如下图所示，就表达“CITY”的显示是由界面上“PROVINCE”的值决定的。图7.2-5生成代码后的效果如下：图7.2-6图7.2-7弹出框来源于系统为简介弹出框，我们在“PEOPLE”表中增长一种字段“LEADER”字段，如下：图7.3-1在“生成代码”窗口中我们重新选择一下“展现对象”，则“LEADER”字段就会显示在字段列表中：图7.3-2双击“LEADER”字段，在“域定义”的“展现类型”下拉框中选择“弹出框”，“数据来源定义”按钮变为可用，点击“数据来源定义”按钮：图7.3-3在“数据来源定义”窗口中默认选择“来源于系统”单项选择框，在窗口的下部有“数据来源”下拉框中我们看到：顾客：弹出窗口中将显示系统中登录顾客权限下的所有顾客；组织：弹出窗口中将显示系统中登录顾客权限下的所有组织；角色：弹出窗口中将显示系统中登录顾客权限下的所有角色；员工：弹出窗口中将显示系统中登录顾客权限下的所有员工；图7.3-4此例中我们选择“员工”，点击“OK”并生成代码，启动应用后将在维护页面看到如下图所示，单击“LEADER”后的，弹出通用协助对话框，我们看到只有人员可以选。图7.3-5来源于表我们回到“生成代码”的“定义窗口”界面，双击“PROVINCE”字段，在“域定义”的“展现类型”下拉框中选择“弹出框”，“数据来源定义”按钮变为可用，点击“数据来源定义”按钮：图7.3-6在“数据来源定义”窗口中选择“来源于表”，在窗口的下部，我们看到一种，点击“协助”。图7.3-7信息如下：图7.3-8按照前面协助的格式，填写信息如下（多种符号未提供选择，请大家手动输入）：图7.3-9其中查询条件“CANT_TYPE='1'”表达只查询省或直辖市一级的行政区划。生成代码后，运行成果如下：图7.3-10联动弹出框类似于联动下拉框，我们也提供联动弹出框功能。再次回到“生成代码”的“定义窗口”界面，双击“PROVINCE”字段，在“域定义”窗口中点击“数据来源定义”按钮：图7.4-1我们修改“返回字段”填充内容，在最前面加上“CANT_CODE:”，注意“:”为半角，起分隔符的作用，此时我们定义从“PROVINCE”的通用协助中选择一种省或直辖市后，不仅返回省或直辖市的名称，还要返回其内码值。图7.4-2我们以同样的方式，定义“CITY”字段，双击“CITY”字段，在“域定义”的“展现类型”下拉框中选择“弹出框”，“数据来源定义”按钮变为可用，点击“数据来源定义”按钮：图7.4-3填充信息如下：图7.4-4生成代码后，运行成果如下。“PROVINCE”域我们选择“山东省”：图7.4-5则在“CITY”的通用协助中，我们就可以看到山东省的各个市了。图7.4-6布署Loushang项目及调试代码布署Loushang项目点击右下方“Servers”视图，假如没有找到，选择“Window”“ShowView”“Servers”打开该视图。右键选择该视图下的服务，选择“AddAndRemoveProjects”。图8.1-1进入向该服务添加删除项目的界面，选择我们创立的loushang项目点击“Add”，将我们的项目添加到我们的服务中。图8.1-2最终点击“Finish”，完毕项目的添加。为调试代码，我们右键选择服务，点击“Debug”，以debug模式启动服务。图8.1-3当服务启动完毕后，服务的状态会显示为“Debugging”。图8.1-4打开浏览器，在地址栏中输入“http://localhost:8080/loushang”，当看到如下界面时，表达我们的应用启动成功。图8.1-5接下来，我们就可以根据需要调试我们的代码了。设置断点在将要执行的程序中设置断点，断点设置措施为在要设置断点的程序行左侧的竖条中双击两下，或者在程序左侧的竖条中选择“ToggleBreakpoint”即可。假如要取消该断点，只需要在表达断点的小圆点上双击两下即可。也可以在断点小圆点的右键菜单中选择“ToggleBreakpoint”。以在“代码生成机”章节定义的模型“PESON