samples示例项目部署说明

samples示例项目部署与介绍作者：星星二○一○年十一月十二日-I-Copyright(C)2010星星[e-mail]目录一、WABACUSDEMO介绍..........................................................................................................11.1简介......................................................................................................................................11.2WABACUS框架与利用SSH框架的对比...............................................................................1二、部署WABACUSDEMO示例项目步骤..................................................................................2三、WABACUSBLANK................................................................................................................4第1页Samples示例项目部署与介绍共5页Copyright(C)2010星星[e-mail]示例项目部署与介绍一、Samples示例项目介绍1.1简介Samples目录下包括两个示例项目：WabacusDemo和WabacusBlank。WabacusDemo是一个用于展示Wabacus框架功能的示例项目，它基本展示了Wabacus框架能完成的所有功能点，通过它，用户可以切身体会到Wabacus框架功能的强大，而且部署非常简单，可以在几分钟之内部署完毕。WabacusBlank是一个空的示例项目，里面只配置了一个示例报表，用户可以在此基础上开发自己的项目，也可以将它集成到自己项目中。也就是说，此项目不是为了演示，而是方便用户能在自己的项目中快速用上此框架。因为WabacusDemo示例项目用于演示Wabacus框架的绝大部分功能点，下面我们专门介绍一下此项目。虽然WabacusDemo示例项目展示的功能非常多，包括纯数据展示、数据编辑和表单三部分，但是代码量却很少，具体包括如下几部分：src/目录下的类文件和配置文件其中resources_system_en.xml和resources_system_i18n.xml两个配置文件除外，它们是框架内置的配置文件，不属于WabacusDemo项目。WebRoot/wabacusdemo/目录下面的jsp和其它静态资源文件除此之外，其它均不属于WabacusDemo项目，要么是属于框架本身的，比如WebRoot/webresources/目录下面的文件，要么是框架在加载启动时加载配置文件根据用户配置自动生成的，比如wabacus-generatejs/目录下面的文件，要么是其它跟项目功能无关的附属文件等。由此可见，利用Wabacus框架开发项目时，用户不需要或只需要开发极少的jsp/java代码，即可得到复杂的功能，主要是编写配置文件，因此极大地提高了开发效率和系统可维护性。1.2Wabacus框架与SSH框架的对比1、利用SSH做项目的宗旨是：只需编写业务逻辑代码，其它交由框架完成；而利用Wabacus框架做项目的宗旨是：只需在配置文件中声明所需的功能，其它交由框架完成，因此比前面更进了一步，不需编写或极少编写代码。第2页Samples示例项目部署与介绍共5页Copyright(C)2010星星[e-mail]2、SSH框架的处理流程是：先利用Struts框架将展示层映射到模式层，再由Hibernate框架将模式层映射到数据库层；Spring做为粘合剂，负责组织各对象的关系，并进行一些通用处理等等。Wabacus框架的处理流程是直接将展示层映射到数据库层，用户只需声明前台需要显示哪些输入框，每个输入框中的数据与数据库中的哪个表的哪个字段对应就可以了，框架会帮你做好一切，因此无论是性能还是开发效率，都比利用SSH框架做项目高很多。3、Wabacus框架目前还不能完全代替SSH框架，有些更灵活的功能可能还需利用SSH框架自己开发，但随着Wabacus框架的逐步扩展和完善，也许某一天，它将最终成为SSH框架的终结者。二、部署WabacusDemo示例项目步骤WabacusDemo示例项目位于下载的安装包的\samples\目录中。其下包括两个档案文件：WabacusDemo.war和WabacusDemo_project.rar，前者为WabacusDemo示例项目的部署包；后者为此项目在Eclipse中的完整工程，一般采用前者进行部署，后者供研究使用（当然也可以采用目录方式部署它）。下面我们就介绍在tomcat中如何部署WHelloWorld.war包，具体包括如下几步：第一步：根据自己的数据库类型，执行samples\WabacusDemo\dbscript\目录中相应数据库的脚本。这里的脚本用于建立demo示例功能中所用的数据表。如果用户是MySql数据库，则执行完脚本即可。如果是其它类型的数据库，因为没有在脚本中建立数据库对象，因此需要用户自己先建立数据库，或在已有的库中执行数据库脚本。第二步：修改wabacus.cfg.xml配置文件的数据源配置打开war包中的WEB-INF/classes/reportconfig/目录下的wabacus.cfg.xml配置文件1、找到datasources/中自己数据库类型的数据源datasource/的配置（比如连接sqlserver2k的为name为“ds_sqlserver2k”的datasource/），将连接数据库的IP、用户名和密码改为自己环境中的参数。第3页Samples示例项目部署与介绍共5页Copyright(C)2010星星[e-mail]2、将datasources/的default属性指定为自己数据库类型的datasource/的name属性，即上面修改的datasource/的name属性（比如ds_sqlserver2k、ds_sqlserver2k5等等）。第2步是因为WabacusDemo项目中所有测试报表所配置的数据源均为默认数据源，即wabacus.cfg.xml文件中datasources/的default属性指定的数据源，所以为了它们能在自己数据库类型中正常运行，需要将其default属性修改为自己数据库类型对应的数据源的name属性。为了简单起见，这里没有通过JNDI方式配置数据源。第三步：将samples\WabacusDemo目录下的WabacusDemo.war拷入tomcat的%TOMCAT_HOME%\webapps目录中，启动tomcat这样WabacusDemo项目就部署完毕竟。启动完成后，打开浏览器，访问，即可访问DEMO。通过上面的链接可以访问所有演示示例，每个演示示例还可以单独通过URL：=每个示例对应的page/的id属性值进行访问。比如=listpage1=detailpage1=tabspage1等等。另外，如果想在Eclipse项目中部署WabacusDemo_project.rar中的WabacusDemo工程，则需对上面步骤做如下更改：先完成上面介绍的前两步工作，完成方法完全一样，然后将第三步改为在Eclipse中部署WabacusDemo_project.rar中的WabacusDemo工程到tomcat第4页Samples示例项目部署与介绍共5页Copyright(C)2010星星[e-mail]中，而不是将WabacusDemo.war拷入tomcat的%TOMCAT_HOME%\webapps目录中。部署完后，访问URL跟上面是一致的。三、WabacusBlank示例项目部署步骤此示例项目是一个完整的，最小的使用Wabacus框架的项目，用户可以在此项目中直接配置自己报表，也可以将它集成到自己的项目中。在此示例项目中配置的报表访问URL为：=...比如这个示例项目中配置了一个pageid=”listpage1”.../page的报表，访问它的URL即为：=listpage1