TAMC@web技术开发手册.doc

技术开发手册综合业务管理平台TAMCwebV1.1技术开发手册 恒 生 在 您 身 边恒生电子股份有限公司二七 年 九 月修订记录日期版本修订目的描述作者2007-09-03V1.1建立文档张庆目 录配置维护开发手册1第 1 章TAMC的运行与配置说明11.1TAMC的目录结构11.1.1config目录11.1.2app目录11.1.3system目录11.1.4operation目录11.1.5WEB-INF目录11.1.6report目录11.1.7log目录21.1.8sendPack目录21.2TAMC配置文件说明21.2.1config目录下的配置21.2.2WEB-INO目录下的配置61.2.3WEB-INO/classes目录下的配置61.3TAMC的运行8第 2 章TAMC的模块开发82.1开发环境的搭建82.2JSP界面开发92.3Hibernate数据库映射开发182.4control控制类开发212.5trans.xml配置文件注册28第 1 章 发布产品及开发工具说明1.1 JDK1.5/JDK1.4由于TAMCweb1.2 Java开发工具EclipseTAMC主要包括以下几个子目录：config、app、operation、report、sendPack、system、WEB-INF、log，其余目录如：css、error、images、js、main、META-INF、password、treeimg等，由于与系统配置和开发无关性，我们暂且不予介绍。 1.3 J2ee开发工具MyEclipseTAMC主要包括以下几个子目录：config、app、operation、report、sendPack、system、WEB-INF、log，其余目录如：css、error、images、js、main、META-INF、password、treeimg等，由于与系统配置和开发无关性，我们暂且不予介绍。 1.4 Hibernate开发工具HibernateTool1.5 报表开发工具iReport1.6 Web服务Tomcat第 2 章 开发运行环境搭建2.1 开发环境的搭建TAMC的开发采用eclipse3.1.1+myeclipse 4.0.3开发平台，以恒生j2ee底层为支持， tamcBase1.0.jar为基础。tamc_kf是我们专门为开发tamc业务功能组装的基础开发环境，在myeclipse环境下，打开tamc_kf工程，并导入WEB-INF/lib下的所有的*.jar包，即可构成tamc的开发环境。第 3 章 目录及配置说明3.1 TAMC的目录结构TAMC主要包括以下几个子目录：config、app、operation、report、sendPack、system、WEB-INF、log，其余目录如：css、error、images、js、main、META-INF、password、treeimg等，由于与系统配置和开发无关性，我们暂且不予介绍。 3.1.1 config目录此目录下包括四个配置文件： perties、base.xml、trans.xml、dict.xml。3.1.2 app目录此目录是开发业务应用的jsp页面存放目录，所有业务相关的开发页面都放在此目录中，便于以后升级管理和版本控制。3.1.3 system目录此目录下存放的是系统开发的jsp页面，所有系统级开发都放在此目录下。3.1.4 operation目录此目录下存放的是，共用的业务jsp页面，所以可以共用的业务jsp页面都放在此目录下。3.1.5 WEB-INF目录WEB框架的指定目录，存放web.xml文件和lib,及相关的classes文件。3.1.6 report目录报表配置文件存放目录和报表文件下载目录。3.1.7 log目录日志文件存放目录。3.1.8 sendPack目录gaps通讯包存放目录，每次gaps交易都更新交易的通讯包内容，以交易代码为名称的xml文件，主要用来整理gaps交易报文的结构的。3.2 TAMC配置文件说明3.2.1 config目录下的配置此目录下包括四个配置文件： perties、base.xml、trans.xml、dict.xml。 perties此配置文件是配置多个gaps平台数据源的，其内容如下：#gaps30=gaps3.0平台localhost=本机gaps“localhost”必须是web应用服务器的连接池的jndi名，“本机gaps”是在登录框里显示的别名。此处配置后，登录页面才会有相应的下拉列表，提示选择登录的gaps平台。 base.xml此配置文件是TAMC相关应用的配置文件，其内容如下： trans.xml此配置文件是web框架的交易配置文件，开发一个新的功能组件，必须要在此处登记注册才可运行,其内容如下：此配置文件大致分为三个部分：系统内置交易区、可配置的系统交易区、可配置的业务交易区。其中系统内置交易区是TAMC Web框架用到的交易注册，不可以更改，否则可能引起系统无法进入；可配置的系统交易区是供TAMC的开发人员在开发公用的系统级的功能时配置的区域，一般业务开发不可修改此处；可配置的业务交易区是TAMC业务交易开发注册的区域，开发业务的配置注册都加在此处。code: 这里是指页面提交的代码，即form表单中action的指定路径；name: 这里是对此交易的中文说明。code: 此处是子交易的代码，即页面提交中的subTranCode参数，由不同的subTranCode来判断不同的子交易，默认子交易代码为“def”；name: 子交易的名称，此处的名称会记录日志中，所以请写明确的操作；ctlCalss: 此交易对就原后台控制类；retPage: 此交易完成后返回的页面路径，由于是相对路径，所以必须有目录结构；funcId: 此交易代码是gaps平台的交易代码，如果不与gaps通讯交易，则此处为空。 dict.xml此配置文件是字典配置，在开发页面时需用到列表或字义报表条件需用到列表时需在此处字义，其内容结构如下：DictKind: 此处为字典的键值；DictKey: 此处为字典的值；DictName: 此处为字典的中文说明；DictInfo: 此处为字典值的中文对照。配置好一个字典后，可以开发的jsp页面调用相应的代码即可显示对应的字典下拉列表，即：可显示字典(DictKind) “JejybzType”下拉列表。 WEB-INO目录下的配置此目录下包含lib目录、classes目录和web.xml文件。其中lib目录下存放的公共的开发包，classes存放class文件和相应的配置文件，web.xml是web框架的指定配置文件。web.xml的相应配置在开发时已经定好，此处不再说明，相关资料可参考Java Web开发文档。 WEB-INO/classes目录下的配置此目录下包含class文件的存放目录和logconfig.xml、perties、hibernate.cfg.xml配置文件。其中logconfig.xml和perties文件是写日志的配置文件，perties文件是hibernate用到的基本不用改，此处着重说明一下logconfig.xml和hibernate.cfg.xml。 Logconfig.xml配置logconfig.xml文件内容如下：truefalseDEBUGDEBUG%d %-5p %c: %m%nyyyyMMddtraceIsFile: 此处为写日志文件的开关，true为写日志文件，false为不写日志文件；IsConsole: 此处为写Web应用服务器控制台日志开发，true为写，false为不写；ConLevel: 此处是控制台日志的级别，分为DEBUG、INFO、ERROR、FATAL；FileLevel: 此处是文件日志的级别，分为DEBUG、INFO、ERROR、FATAL；LogFormat: 此处是日志输出的格式，具体可参见log4j的文件说明；LogFileDate: 此处是日志文件的格式，以日期为界限，一天一个文件；LogFileName: 日志文件输出的目录和文件名，可以用./来回到上级或下级目录，默认为Web应用服务器的启动目录。 hibernate.cfg.xml配置hibernate.cfg.xml是hibernate的配置文件，“hibernate.”的文件名需要根据实际配置的连接池名称来更改，如连接池的JNDI名称为“localhost”则此处的文件名就为：“localhost.cfg.xml”,多个数据源，应配置多个cfg.xml文件。该文件内容如下：trueorg.hibernate.dialect.InformixDialectjava:comp/env/localhosttrueGBKshow_sql: 是否在控制台显示SQL语句，此开关在开发阶段打开，运行阶段关闭；dialect: 数据库种类；connection.datasource：数据源的JNDI。： 是hibernate的数据实体映射配置文件，此配置文件必须要在此注册才可以程序中调用，否则程序中将不可识别。3.3 TAMC的运行TAMC采用web网页的形式进行，启动tomcat的bin目录下的startup.bat、或是weblogic的beauser_projectsdomainstamcstartWebLogic.cmd，则可启动web服务，打开浏览器在IE地址栏输下：/tamc即可访问TAMC服务程序。界面如下：第 4 章 应用模块的开发4.1 主界面菜单及权限设置为了便于管理，所以业务相关的jsp页面都必须存放在/app目录下，jsp页面的开发可参照opration下的jsp页面，一般来说，查询页面带后缀为*Qry.jsp，增加和修改页面带后缀*Edt.jsp，列表页面带后缀*Lst.jsp。4.2 trans.xml配置文件注册控制类和jsp页面开发完成后，都必须在/config/trans.xml配置文件中做相应的配置注册才可生效，具体配置方法见。4.3 JSP界面开发为了便于管理，所以业务相关的jsp页面都必须存放在/app目录下，jsp页面的开发可参照opration下的jsp页面，一般来说，查询页面带后缀为*Qry.jsp，增加和修改页面带后缀*Edt.jsp，列表页面带后缀*Lst.jsp。*Qry.jsp如下：管理台操作日志查询function doQuery() document.tamcForm.subTranCode.value=lst;document.tamcForm.submit();function add()document.tamcForm.subTranCode.value=add; document.tamcForm.submit();function initDate() var currDate = getCurrDate();document.tamcForm.jyrqQry.value=currDate; input type=hidden name=prvModuleid value= 管理台操作日志查询     交易日期   机构编号   操作员号    交易代码 *Lst.jsp页面如下：机构项目分配A.MzTreeview font-size: 9pt; padding-left: 3px;A:visited color: #000000;text-decoration: none;function operate(id,jgbh,nbjgbs)document.tamcForm.subTranCode.value=lst;document.tamcForm.id.value=id;document.tamcForm.jgbh.value=jgbh;document.tamcForm.nbjgbs.value=nbjgbs;document.tamcForm.target=orgFram;document.tamcForm.submit();机构项目分配 机构项目分配 机构信息区 项目分配区 var tree = new MzTreeView(tree); tree.iconsproperty = ././treeimg/property.gif; tree.iconscss = ././treeimg/collection.gif; tree.iconsbook = ././treeimg/book.gif; tree.iconsExpandbook = ././treeimg/bookopen.gif; /展开时对应的图片 tree.setIconPath(././treeimg/); /可用相对路径 tree.nodes0_ = text:机构信息;hint:; tree.nodes_ = text:;method:operate(,);hint:; document.getElementById(treeviewarea).innerHTML = tree.toString();*Edt.jsp如下：构构项目分配!-function operate()if