网上书店系统开发说明文档.doc

网上书店系统开发说明文档姓名：陆旭 学号：11221100611 开发环境搭建过程1.1 软件下载开发环境所使用的软件名称及其版本信息如下表所示：软件名称版本信息JDK1.6.0_02Tomcat5.5MyEclipse5.5.1Axis2bin_1.5.4war_1.5.4Axis2_Codegen_Wizard_1.3.0Axis2_Service_Archiver_1.3.01.2 搭建步骤(1). 安装JDK，Tomcat服务器和MyEclipse开发环境；(2). 启动MyEclipse，配置JDK和Tomcat相关参数；(3). 将Axis2_Codegen_Wizard_1.3.0和Axis2_Service_Archiver_1.3.0放至Myeclipse安装目录下的plugins子目录（D:Program FilesMyEclipse 5.5.1 GAeclipseplugins）；(4). 将axis2.war包拷贝到Tomcat安装目录下的webapps子目录；(5). 启动Tomcat服务器，打开浏览器，输入并访问地址http:/localhost:8080/axis2/，成功得到Axis2部署成功的信息。1.3 所遇问题搭建过程中以及在在服务实现及部署时均遇到了一些问题。下面简要介绍所遇问题及解决方法。(1). 在1.2第(3)步，MyEclipse没有识别Axis2的两个插件（Axis2_Codegen_Wizard_1.3.0和Axis2_Service_Archiver_1.3.0）。解决方法：需要在D:Program FilesMyEclipse 5.5.1 GAeclipselinks目录下新建文件并命名为axis-eclipse-plugin.link，文件中的内容为path=D:Program FilesMyEclipse 5.5.1 GAeclipseplugins；(2). 在使用Codegen插件来从WSDL文件生成代码时，到了最后一步出现“An error occurred while completing process -java.lang.reflect.InvocationTargetException”错误。解决方法：从axis2的lib库中复制“geronimo-stax-api_1.0_spec-1.0.1.jar”和“backport-util-concurrent-3.1.jar”（这个文件我没有找到，直接从网上下载的）文件到Codegen的lib目录中，同时修改plugin.xml文件，添加到plugin.xml文件中,保存后重新启动MyEclipse即可。(3). 在使用Codegen插件来从WSDL文件生成代码后，代码出现错误。解决方法：在工程中添加axis2的lib文件。2 服务端实现及服务部署2.1 服务实现(1). 创建Web工程：启动MyEclipse，File-New-Project-Web Project，Project name取名为OnlineBookstore；(2). 导入axis2库：右键工程名OnlineBookstore-Build Path-Add External Archives，导入axis2的所有jar包；(3). 生成WSDL文件：右键工程名OnlineBookstore-New-Other-WSDL，按照向导填写WSDL文件内容。文件名称为OnlineBookstore.wsdl，其中包含一个操作QueryBook，输入为QueryBookRequest，输出为QueryBookResponse，QueryBookRequest含有三个string类型的参数，名称分别为bookName、authorName和ISBN，QueryBookResponse也含有三个string类型的参数，名称分别为bookName、authorName和ISBN；(4). 由WSDL生成服务端代码：右键工程名OnlineBookstore-New-Other-Axis2 Wizards-Axis2 Code Generator，根据向导一步步填写相关信息，完成后需要修改服务包的名称以及test case文件的两个错误（利用MyEclipse提供的自动提示功能）；(5). 编写服务端代码：修改OnlineBookstoreSkeleton.java文件和OnlineBookstoreTest.java文件，增加BookInfo.java文件（用于记录查询结果）。由于系统并未采用数据库支持，因此假设只提供四本书的检索（四大名著）。OnlineBookstoreSkeleton.java代码片段OnlineBookstoreTest.java代码片段BookInfo.java代码片段2.2 服务部署(1). 将服务实现打包：右键工程名OnlineBookstore-New-Other-Axis2 Wizards-Axis2 Service Archiver，根据向导一步步填写相关信息，最终生成OnlineBookstore.aar文件；(2). 服务部署：将打包好的OnlineBookstore.aar文件，拷贝至D:Program FilesApache Software FoundationTomcat 5.5webappsaxis2WEB-INFservices目录下；(3). 服务发布：启动Tomcat服务器，在浏览器中输入地址http:/localhost:8080/axis2，点击其中的“service”链接，看到OnlineBookstore的Web服务发布成功。3 客户端实现客户端采用简单的一个JSP页面呈现，主要分为两部分，其中一部分是用户查询界面，采用表单实现，包括书名、作者名和ISBN号输入框以及查询、取消按钮；另外一部分为查询结果界面，为了简单起见，只给出该书是否存在的信息以及书名、作者名和ISBN号等信息。JSP页面主要代码主要包括四部分内容：(1). 第一部分：根据用户输入调用服务，如果没有得到用户输入或所查询书籍不存在，返回信息为空，否则返回书籍的相应信息。(2). 第二部分：表单提交验证代码，需要用户至少输入书名、作者名或ISBN号三者其中之一，然后才允许用户查询操作。(3). 第三部分：用户查询表单界面，包括三个输入框，分别记录用户对书名、作者名以及ISBN号的输入信息。一个查询按钮和一个取消按钮，分别用于提交查询信息以及取消当前输入信息。(4). 第四部分：返回信息界面，包括显示是否查询成功，以及书名、作者名和ISBN号的信息。4 运行结果(1). 服务端只提供四大名著书籍的检索，如下表所示，对于其它输入，均提示不存在信息。书名作者名ISBN号三国演义罗贯中001红楼梦曹雪芹002西游记吴承恩003水浒传施耐庵004(2). 要求用户至少输入书名、作者名或ISBN号其中之一，服务端根据输入情况匹配书籍的相关信息。如果用户未输入任何信息便点