国际结算系统开发平台TopTool 管理中心(PssAdmin)-毕业论文

1 1 本科毕业论文本科毕业论文 (科研训练、毕业设计) 题题 目：目：国际结算系统开发平台国际结算系统开发平台 TopToolTopTool 管理中心管理中心(PssAdmin)(PssAdmin) 姓 名： 学 院：软件学院 系：软件工程 专 业：软件工程 年 级： 学 号： 指导教师（校内）： 职称： 指导教师（校外）： 职称： 年 月 日 2 2 摘要 鼎盛（厦门）电脑系统有限公司开发的 TopTools 平台是用于开发银行系统 的全参数开发平台。TopTools 旗下有六套产品： Pss，PssAdmin，PMS，JDS，Jss，JssAdmin。本文所说的 PssAdmin 就是 Pss 的 一个监控系统。我的毕业设计的任务就是要详细了解原有的 PssAdmin 系统实现 了哪些功能，然后在此基础上去添加系统部给我派发的新的功能。在这过程中 我要去详细看 PssAdmin 的代码，要画原来的 PssAdmin 实现功能的 UML 图，然 后跟业务部的人员谈他们要在 PssAdmin 系统中添加的新的功能的需求，接下去 就是软件开发的步骤了：写需求书、概要设计、详细设计、编码、测试、交接 功能。 那此次我要在 PssAdmin 系统中添加的新的功能有三个：XML 编辑器、导入 导出功能、恢复时间点功能。对它们的简要说明如下： XML 编辑器要实现对 XML 文件的增、删、改、查操作，具体的内容我在“第 二章 XML 编辑器”有更加详细的说明。 导入导出的功能是要实现将数据库的内容导出到硬盘上与将硬盘上的内容 导入到数据库中，具体的内容请看“第三章 导入导出功能” 。 关键词：XML 编辑器 代码复用 导入导出 参数开发 3 3 Abstract The Toptools developed by DingSheng(Xiamen) Computer Systems Ltd. Is an all- parametric platform used for the banking system development. There are six kinds of products in the TopTools, including Pss, PssAdmin，PMS，JDS，Jss，JssAdmin. The PssAdmin mentioned in this article is one of Psss monitoring system. I am aiming at comprehending the functions of the original PssAdmin System thoroughly by my graduation design. Basing on this, I am going to add some new functions distributed by our board to the system. I decide to look through the codes of the PssAdmin carefully, and draw a UML graph indicating how to implement the functions of the original PssAdmin. Then I will talk to the business department staff about the need they want to add new function in PssAdmin System, it follows the step of software development: writing requirement specification, summary designing, details designing, coding, measuring and testing, connecting function. This time I want to add three functions in the PssAdmin system. They are XML editor, the function of import and export and resuming the time. My brief introduction about then are as follows. XML editor aims to operate the XML file with adding, deleting, altering and checking. I have more detailed introduction about the concrete content in the chapter two XML editor. The function of import and export aims to educe the content of the database to the 4 4 hard disk and then enter the database. The concrete content is in the chapter three the Function of import and export. Key words: XML editor Code resumes import and export parameter exploitation 目录 第一章第一章 引言引言 -8 1.1写作目的 -8 1.2本文的现实意义 -8 1.3对所研究问题的认识 -8 1.4本文所要说明的问题 -9 第二章第二章XMLXML 编辑器编辑器-10 2.1制作 XML 编辑器的背景-10 2.1.1有关 Pss 系统的配置信息-10 2.1.2 配置 pss.xml 文件遇到的问题 -10 2.2设计框架-10 2.2.1设计框架图-10 2.2.2对框架图的说明-11 2.3具体设计的说明-13 2.3.1XML 编辑器的用例图 -13 2.3.2XMl 编辑器的设计界面 -15 2.4代码架构的说明-19 2.5遇到的问题-20 2.5.1JDOM 解析 XML 文件的问题-20 2.5.2中文编码的问题-21 2.5.3树的同名节点的问题-22 2.5.4动态局部刷新界面的问题-24 2.5.5远程读写文件的问题-26 2.5.6一个类做太多的事-27 2.6小结-27 第三章第三章 导入导出功能之代码复用导入导出功能之代码复用-29 3.1 制作导入导出功能的背景-29 3.1.1 介绍导入导出的功能-29 3.1.2 我的任务功能移植及添加新的功能 -29 3.1.3 有关“恢复时间点”的功能 -29 3.1.4PMS，PssAdmin，Pss 三者在导入导出功能中的作用-29 3.2设计框架-30 5 5 3.2.1框架图-30 3.2.2对框架图的说明-30 3.3功能移植的步骤-30 3.4 功能移植过程中遇到的问题-31 3.5 代码复用的原则-31 3.5.1 实现接口继承抽象类-31 3.5.2优先使用对象组合，而不是类继承 -32 3.5.3将可变的部分和不可变的部分分离 -32 3.5.4方法不能写得过长-32 3.5.5减少参数个数而将要传递的数据封装起来 -33 3.5.6类层次的最高层应该是抽象类 -33 3.5.7尽量减少对变量的直接访问而应该使用方法访问变量 -34 3.5.8子类应该特性化，完成特殊功能 -34 第四章第四章 总结总结-35 致谢致谢 -37 参考文献参考文献 -38 附附 录录 -39 附件一 pss.xml -39 附件二 pss_help.xml-39 附件三 TopTools 下的 PssAdmin 管理系统需求分析.doc -39 附件四 TopTools 下的 PssAdmin 系统概要设计.doc -39 附件五 PssAdmin 系统 uml 图-39 附件六 New Java TopTools 系统简介.ppt -39 附件七 TopTools 软件工具介绍.ppt -39 附件八 XML 编辑器的源码 -39 附件九 TopTools 下的 PssAdmin 管理系统测试方案系统测试方案.doc -39 附件十 TopTools 下的 PssAdmin 管理系统测试计划.doc -39 附件十一 TopTools 下的 PssAdmin 管理系统测试总结报告.doc -39 附件十二 毕业论文任务书.doc-39 附件十三 分阶段进度安排.doc-39 附件十四 厦门大学软件学院毕业设计（论文） 开题报告_.doc-39 6 6 Contents Chapter 1 introduction-8 1.1Writing purpose-8 1.2Practical Significance of the Article-8 1.3Recognition of the Problems Studied-8 1.4Problems Explained in the Article-9 Chapter 2 XML Editor-10 2.1The Background of XML Editors Production-10 2.1.1Configuration Information About the Pss System-10 2.1.2 Problems Encountered When Configuring Pss.xml-10 2.2Framework Design-10 2.2.1Frame Diagram Design-10 2.2.2Explanation of the Frame Diagram-11 2.3Explanation of the Specific Design-13 2.3.1The Use Case Diagram of the XML Editor-13 2.3.2The Interface Design of the XML Editor-15 2.4Explanation of the Code Structure-19 7 7 2.5Problems Encountered-20 2.5.1Problems of analyzing XML File by JDOM-20 2.5.2Problems of the Chinese Encoding-21 2.5.3Problems of the Same Named Note of the Tree-22 2.5.4Problems of Refreshing the Interface in Dynamic Local-24 2.5.5Problems of Remote Read-write file-26 2.5.6One class Implementing Too Many Tasks-27 2.6Brief Summary-27 Chapter3 Functions of import and export and Code Multiplexing-29 3.1 Making Background of the import- export Function-29 3.1.1 Introduction of the import-export Function-29 3.1.2 My Task: Function Transplant and New Function Addition-29 3.1.3 Functions Concerning Time Points Recovery-29 3.1.4PMS, PssAdmin, and Psss Role in Enter-educe Function-29 3.2Framework Design-30 3.2.1Frame Diagram-30 3.2.2Explanation of Frame Diagram-30 3.3Steps of Function Transplant-30 3.4 Problems Encountered in the Process of Function Transplant-31 3.5 Principle of Code Multiplexing-31 3.5.1 Interface Inheritance to Achieve an Abstract Category-31 3.5.2Priority in Object Combinatory Instead of Class Succession-32 3.5.3Segregation of Changeable and Unchangeable Parts-32 3.5.4Passage of Method Should not Be Written Too Long-32 3.5.5Reducing the Number of Parameters and Packaging the Data Transferred-33 8 8 3.5.6Abstract Category-Category of the Highest Level-33 3.5.7Minimizing the Variable Direct Access, Using Method to Access Variable Instead-34 3.5.8Subcategory Should Be Specified And Particular Function Be Completed-34 Chapter4 Summary-35 Thanks-37 Reference Documentations-38 Appendix-39 Accessory 1 pss.xml-39 Accessory 2 pss_help.xml-39 Accessory 3 Requirement analysis of management system of pssadmin In toptools-39 Accessory 4 Summary design of pssadmin system In toptools. doc-39 Accessory 5 UML graph of pssadmin System 39-39 Accessory 6 Brief Introduction of new java toptools system-39 Accessory 7 Introduction of software toptools.ppt-39 Accessory 8 Source code of XML Editor-39 Accessory 9 Management system testing program of pssadmin in toptols.doc-39 Accessory 10 Management system test plan of pssadmin in toptools.doc-39 Accessory 11 Management system testing summary report-39 Accessory 12 Thesis of the task.doc-39 Accessory 13 Phased schedule-39 Accessory 14 Opening report of graduation design (Thesis) by Zhenrong, Chen in software Institute of Xiamen University-39 9 9 第一章 引言 1.1写作目的 一是作为学校布置的毕业论文，二是对我做毕业设计过程的一个总结，三 是为我以后写技术性的文档做一次很有意义的练习。 1.2本文的现实意义 对我大学四年生涯所学知识的一次回顾，从中去思考我目前所达到的程度。 完成学校布置的毕业论文的任务。作为以后供自己或别人参考的文献。 1.3对所研究问题的认识 本文的研究问题主要有三个：XML 编辑器、导入导出功能。 做技术预言的时候我认识到 XML 编辑器所涉及到的内容是比较广的，它涉 及到：有关操作 XML 的 JDOM 技术，远程读写文件的技术，局部刷新界面的技术， 树的操作的技术，JAVA 事件处理技术等等。而且还要考虑到实际的需求，比如 要考虑到业务人员提出的读取两个 XML 文件这样的让人一时手足无措的需求。 而就我刚要开发 XML 编辑器当时的能力而言，很多技术是要我重新去学的，比 如 JDOM，远程读写文件，局部刷新界面。因而对我当时来说，做这样的一个编 辑器时有技术上的难度与经验上的难度的。所以选择这样的一个功能来做为我 毕业设计的一部分是很有意义的。具体对 XML 编辑器的论述请看“第二章 XML 1010 编辑器” 。 导入导出功能在原有 TopTools 系统中就有的，我的任务在于将该功能移植 到 PssAdmin 系统中，刚开始我以为这是很简单的，但看完 PssAdmin 系统后我 才认识到要添加这样的一个功能是不容易的；难点在于导入导出功能在原有系 统并不是独立的一个包，它与原系统的其他功能有很多相互依赖的关系；难点 还在于 PssAdmin 系统于 Pss 系统的通讯中并没有有关导入导出功能的处理，这 意味着我要在 Pss 系统中添加很多的代码；难点还在于导入导出功能中的参数 数据是如此之多，每个参数数据的导入与导出实现又是不一样的，这意味这我 要好好的看导入导出功能的代码。导入导出功能其实就是对数据库的操作，但 我原有的数据库知识是很有限的，再加上我对参数数据库中表与表之间的联系 并不了解，这增加了我移植导入导出功能的难度。所以原以为移植一个功能是 很简单的，但仔细考虑后却有这么多的难题。具体对导入导出功能的论述请看 “第三章 导入导出功能” 。 1.4本文所要说明的问题 本文是做为一篇技术报告类的文章，目的在于报告我毕业设计所做的事情， 写下我在毕业设计的过程中遇到的问题，我是如何解决的，我在这次毕业设计 过程中的体会，我所学到的知识，我所懂得的道理，我所解决的问题，我做毕 业设计的意义。 1111 第二章 XML 编辑器 2.1制作 XML 编辑器的背景 2.1.1 有关 Pss 系统的配置信息 在 Pss 系统中，它的配置信息是存贮在 XML 文件中的，该 XML 文件的名称 是 pss.xml，pss.xml 文件在附录的附件一中。 2.1.2 配置 pss.xml 文件遇到的问题 在原有的 PssAdmin 系统中没有对该 pss.xml 文件的配置操作,因而每次要 更改配置的话都要直接更改 pss.xml 的源码，这样带来很大的操作上的麻烦。 而且在原有的 pss.xml 文件中并没有对某个标签的注释，以上的注释是重新归 纳的存贮在另一个文件的。为了防止以后 pss.xml 文件配置信息的更好操作， 系统部的决定要在 PssAdmin 中做一个 XML 文件的编辑器，用图形界面化来操作 在 Pss 系统中的 pss.xml 文件。 2.2设计框架 2.2.1 设计框架图 1212 2.2.2 对框架图的说明 1. 有关 pss.xml 与 pss_help.xml pss_help.xml 文件是 pss.xml 文件的一个扩充，pss_help.xml 文件里的每 个元素与 pss.xml 文件里的元素一样，只是在 pss_help.xml 文件里，每个元 素都有 desc,enum,help 三个子元素。其中 desc 元素是对该元素的描述，enum 元素是表明该元素是不是可选项的类型，help 是有关该元素的帮助信息。具体 的例子如下： 基础信息配置 主要是对数据库的信息进行的配置 其中 desc 元素的内容说明 BASIC 元素是“基础信息配置” ；enum 元素的 flag 属性为 N，说明 BASIC 元素是文本型的；help 元素的内容说明 BASIC 元素的帮 PSS 系统系统 PssAdmin 系统系统 pss.xml 文件文件 pss_help.xml 文件文件 XML Editor 功能功能 读进 读进 修改 修改 1313 助信息是“ 主要是对数据库的信息进行的配置” 。 系统语言 1 2 目前系统只支持两种语言 chinese 与 english 其中 desc 元素的内容说明 SYSTEM_LANGUAGE 元素是“ 系统语言” ；enum 元素 的 flag 属性为 Y，说明 SYSTEM_LANGUAGE 元素是下拉框型的，并且当前的可选 项是”chinese”与”english” ；help 元素的内容说明 SYSTEM_LANGUAGE 元素 的帮助信息是“目前系统只支持两种语言 chinese 与 english” 。 2. XML 编辑器对 pss.xml 与 pss_help.xml 的操作 XML Editor 会读 pss.xml 与 pss_help.xml 文件，然后用 pss.xml 文件形成 一棵树,而对树的操作，如：增加新的子节点，会相应修改 pss.xml 与 pss_help.xml 文件。 3. pss_help.xml 文件在附录的附件二中。 1414 2.3具体设计的说明 2.3.1 XML 编辑器的用例图 说明：本部分中所述的 元素包括标签、属性、注释。 1） 基本描述 客户用例 ID U8 需求 ID 用例名称XML 编辑管理系统 优先级别 行为者管理员 描述对 PSS 系统中的 XML 配置文件进行管理，消除原系统中要增 加一个 UNIT 也要直接在 XML 配置文件的源码进行更改的麻 烦，使系统更容易管理与操作。 2） 用例图 1515 管理员 XML编编辑辑管管理理系系统统 XML编辑管理系统U8 * Delete U8-1Copy U8-2 Add Attribute U8-4 Add Comment U8-5 Paste U8-3 Add Child U8-6 Add Before U8-7 Add After U8-8 Add Value U8-9 Edit U8-10Save U8-11 3） 限制 4） 前提条件 管理员已登录。 5） 后续结果 6） 功能清单 具体每个子用例的用例图可以看附录中的附件五 PssAdmin 系统 uml 图 在了解需求后我要首先提取出需求中的所有的用例，然后我用 Visio 画出了用 例图，序列图，流程图；当然在这过程中我要参考有关 UML 的资料，这里给出 1616 一个我参考过的网址8 /oobject/oobject.asp。我在 这里想要说点我在画 UML 图的过程中的一点体会。那就是在画图的时候如果遇 到了要画逻辑性的图要画的是序列图还是流程图。在我看来如果不是 if else 型的逻辑的画就画序列图，否则就画流程图，这个算是我画了这许多 UML 图的 一点体会吧。 2.3.2 XMl 编辑器的设计界面 1. 界面编号 GUI-0002 2. 名称 XML 编辑器界面 3. 界面图形 1717 （图 1） 1818 （图 2） 1919 （图 3） 2020 （图 4） 对界面简要的说明: 点击树上的某个节点时会动态弹出该节点的详细信息，如： Path,Name,Value,desc,help。详细信息的说明如下： Path:节点在 pss.xml 文件中的路径。 Name:节点在 pss.xml 文件中的名字。 Value:根据节点在 pss_help.xml 文件中的子元素 enum 的 flag 属性的值，如果 flag=”Y”,则 Value 用下来框显示所有的可选 2121 项，如图 1；否则用文本框显示节点 的值如图 2。 desc:节点在 pss_help.xml 文件中的子元素 desc 的值。 help:节点在 pss_help.xml 文件中的子元素 help 的值。 对节点点击右键会弹出菜单，可以对节点进行相应的操作如图 3。 只有按下“Save”按钮所有的更改才会写到 pss.xml 与 pss_help.xml 文件。 2.4代码架构的说明 XML 编辑器的包总共包含八个类： RemoteFileClient，SaveButtonHandler，ShowElementDetailPane，ShowSourc eCodeArea，TreeNodeObject，XmlEditorPanel，XmlReader，XmlTree，XmlTre eNode。各类的说明如下： RemoteFileClient：是远程读文件类，它远程读取在 Pss 系统中的 pss.xml 与 pss_help.xml 文件。 SaveButtonHandler：是保存按钮的事件类，它处理的是将最后的操作结果 写入 Pss 系统中的 pss.xml 与 pss_help.xml 文件。 ShowElementDetailPane：是显示 XML 节点的详细信息的界面的类。 ShowSourceCodeArea：是显示 XML 文件的源码的类。 TreeNodeObject：是树节点的对象类，相当与树的 UserObject。 XmlEditorPanel：是 XML 编辑器的界面与程序的入口类，main 函数在该类 内。 XmlReader：是 XML 文件的解析类。 2222 XmlTree：是将 XML 文件的节点构造成树的类。 XmlTreeNode：是树的节点类。 详细源码见附录的附件八。 2.5遇到的问题 2.5.1 JDOM 解析 XML 文件的问题 /* * param xmlFile 要解析的XML文件 * return document XML文件的Document * 20080411 */ public Document parseXml( File xmlFile ) Document doc = null; try FileInputStream fs = new FileInputStream(xmlFile); InputStreamReader isr; isr = new InputStreamReader(fs,“UTF-8“); BufferedReader br = new BufferedReader(isr); doc = new Document(); 2323 SAXBuilder sax = new SAXBuilder(); doc = sax.build(br); br.close(); catch (Exception e) e.printStackTrace(); return doc; /end parseXml() 以上就是 JDOM 解析 XML 文件的方法，确实是很简单的，而我要写出这个方法也 是在不断改进过程中，我刚开是给 parseXml 传入的参数是 String 型的，这样 给我的后续操作带来了很多的问题。我上网查找了 JDOM 的相关资料如：1 /kingwong/291878.html 2.5.2 中文编码的问题 如果XML文件中含有汉字的话，在解析XML文件的时候有可能会出现解析后 出现中文的乱码。这个问题让我吃了不少的苦头。出现问题的原因在与XML文件 的编码与我们要解析的环境的编码不一致造成的。如XML文件可能编码可能是 UTF8，而我们的开发环境的编码是GBK。所以要把开发环境的编码与XML文件 2424 的编码统一起来。XML文件可以在，encoding的值就是XML文件的编码，现在该XML文件的编码是“UTF8”， 所以我也将自己的eclipse环境的编码换成UTF8。也许这样做了后在解析XML 文件时还会出现中文的乱码。处理的办法就是我们解析XML文件也要用 “UTF8”的编码格式进行解析，如上面的“DOM解析XML文件的问题”的isr = new InputStreamReader(fs,“UTF-8“);就是讲读进的XML文件用UTF8的编码格 式读进的。最后在保存操作结果的是后也用UTF8的格式进行保存。如下面的 代码： String helpFileName = “pss_help.xml”； Format format = Format.getCompactFormat(); format.setEncoding(“UTF-8“); /设置xml文件的字符为UTF-8 format.setIndent(“ “); /设置xml文件的缩进为4个空格 XMLOutputter xmlOutput = new XMLOutputter(format); xmlOutput.output(XmlReader.helpXmlDocument, new FileOutputStream(helpFileName); 2.5.3 树的同名节点的问题 树的同名节点的问题是一个很棘手的问题，JTree 是不支持在同一路径下的 同名节点的，如果存在在同一路径下有一对同名节点，那么在定位 JTree 下的 同名节点是就不知道要定位哪个节点。而 XML 是支持在同一路径下有同名节点 的。我所设计的 JTree 是根据 XML 文件来生成的，而 XML 文件下是允许