《家德瑞手册》第2章-sample实例的部署

HomeDear在发布的时候，提供了一个实例工程和一个生成程序的工具工程，实例工程用于向读者展示HomeDear的基本功能。生成程序的工具工程帮助读者通过在excel文件中定义表对象结构，自动生成一些标准程序，提高研发速度。

2.1 部署步骤

下面，我们来看一下，如何部署实例工程实例。

2.1.1 第一步：

安装jdk1.5、安装tomcat5.5、mysql5.0。

当然数据库产品我们可以选择任何其它的产品，如：oracle、sqlserver等（目前的关系型数据库的面向对象的接口已实现此三种数据库，如果需要其它的数据库，可以根据HomeDear提供的关系型数据库的面向对象的接口编程，进行现实。）实例程序默认的是mysql数据库，如果需要把实例工程改成其它数据库也是可以的。

2.1.2 第二步：

建立一个空的数据库：test。然后，在mysql中执行sample-mysql.sql脚本，这个脚本主要是建立mysql所需要的基础存储过程，主要是用于分页，还有测试用的表以及存储过程。(同时，向数据库中执行相关的数据库脚本也可以在sql.html文件中找到相应的内容。主要包括三种数据库的脚本。每种数据库都包括三个部分1、用于系统分页的基础存储过程 2、单表、一对一的表、一（多）对多的表 3、业务存储过程。)，在测试的时候需要注意，如果有乱码出现，请修改你的mysql的数据库的配置改成默认的gb2312字符集，修改方法：

my.ini文件中的“default-character-set”改成gb2312，注意有两处噢。

在建表的时候的最后写上：DEFAULT CHARSET=gb2312

在建立存储过程的时候加入参数的字符指定，如下所示：

CREATE DEFINER=`root`@`localhost` PROCEDURE `sp_lendingNoback`(in ifback varchar(10)  character set'gb2312'

,in userid int)

BEGIN

-- 。。。。。

END $$

2.1.1 第三步：

将sample.war文件部署到tomcat中。

2.1.2 第四步：

当sample.war文件被tomcat释放后，查看sample\WEB-INF\classes\com\homedear\config目录下的config.properties文件，这里有几个属性需要注意：

debug=true，则说明是调试环境，这样当程序出错的时候可以报出更详细的错误。

alias=test2，这个是数据库连接池的别名，可以有多个，如果有多个的时候中间用“,”隔开。需要注意的是这里的别名必须与sample\WEB-INF\classes\com\homedear\prool目录下的proxool.xml文件的别名（即proxool.xml文件中的alias属性值）一致。

config.properties的下部是“域名的相关设置”需要将域名即路径根据实际情况进行修改，比如你的tomcat安装在了C盘那么就需要作相关的修改了。

其它的关于config.properties的属性在下面有详细说明。除了config.properties之外还有关注一下sample\WEB-INF\classes\com\homedear\prool目录下的proxool.xml文件，最主要的是proxool.xml文件中的alias属性值必须与config.properties文件中的alias值一致。再有就是proxool.xml是使用的一个开源的数据库的连接池proxool。其配置也很简单，在sample实例中给出了mysql、oracle、sqlserver三种数据库的实现，如果需要同时操作多个数据库，其形式就如把sample实例中给出的proxool.xml文件中的注释全去掉的形式。如果需要了解更多的配置说明请参考proxool连接池的相关文档。

2.2 HomeDear配置文件

2.2.1 Web.xml文件

这个文件下的所有内容均可以不修改，但以下这三部分是必须的，且不用修改。当然，我们可以加入web.xml下的其它所有标签。如工程名、默认欢迎页等等。

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.4">

<!—加入了homedear的自定义标签-->

  <taglib>

    <taglib-uri>/WEB-INF/hdr-html.tld</taglib-uri>

    <taglib-location>/WEB-INF/hdr-html.tld</taglib-location>

    <taglib-uri>/WEB-INF/hdr-hdr.tld</taglib-uri>

    <taglib-location>/WEB-INF/hdr-hdr.tld</taglib-location>   

</taglib>

 

 

 

 

 

 

 

<!—系统在启动时，会自动加载关系型数据库的面向对象接口所需要的相关信息，并加以缓存--> 

  <servlet>

    <servlet-name>HdrServletInit</servlet-name>

    <servlet-class>com.homedear.dis.HdrServletInit</servlet-class>

    <load-on-startup>1</load-on-startup>

  </servlet>

 

 

 

 

 

 

 

 

 

 <servlet>

        <servlet-name>DispatchServlet</servlet-name>

        <servlet-class>

            com.homedear.dis.DispatchServlet

        </servlet-class>

</servlet>

<！--定义本工程的URL中当遇到“/action/”的时候转到servlet执行-->

    <servlet-mapping>

        <servlet-name>DispatchServlet</servlet-name>

        <url-pattern>/action/*</url-pattern>

    </servlet-mapping>

</web-app> 

2.1.1 Config.properties文件

在项目，必须建立两个包：com.homedear.config和com.homedear.prool。其中config包下就是Config.properties文件。这个文件的内容如下 ：

属性名

属性值

说明

debug

false/true

当为true的时候系统会提供更为详细的错误说明信息，以便于程序的调试。

alias

是proxool.xml文件中的“alias”属性值。如果proxool.xml中有多个数据库的连接池的配置那么这里也可以有多个值，中间用“,”间隔

数据库的别名值。可以是多个，中间用“,”间隔

domain

http://localhost/sample/

工程的主域名

domainPic

http://localhost/sample/images/

图片的服务器域名

domainCss

http://localhost/sample/

样式与JS的服务器域名

projectRoot

D:\\Program Files\\Apache Software Foundation\\Tomcat 5.5\\webapps\\sample\\WEB-INF\\classes\\

工程的根目录

projectXmlRoot

D:\\Program Files\\Apache Software Foundation\\Tomcat 5.5\\webapps\\sample\\xml\\

工程中XML文件根目录（指受保护的）

reloginActionName

test.session.ReLoginAction

实现session续接时，需要用户重新输入用户名、密码，判断用户用户名密码是否正确的action类名

charset

GBK

工程所用字符集

fileSystem

windows、linux

文件系统

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2.1.1 proxool.xml配置文件

本项目引入了proxool数据库的连接池，其使用方法请参考proxool相关文档。需要说明的是proxool.xml文件中的“alias”属性值应与Config.properties文件的alias属性值一致。当然如果proxool.xml中有多个数据库的连接池的配置那么Config.properties文件的alias属性值也可以有多个值，中间用“,”间隔。

 

2.2 总结

通过本章的介绍我们以快速的方式，简单的了解了一下homedear框架的情况。读者可以打开sample工程的源程序看一下，他的编程是多么的简单。一个功能模块一般由五部分组成：表对象、action、logic、dao、jsp。用户可以相应的位置找到，如果不是很好弄清楚的话，在本文的下面有对目录结构的说明。