web 应用部署
本章节将按步骤顺序介绍web应用目录和相关文件的配置。
第一步 创建新应用
[如果是和已有应用集成，此步骤可略过]
一个典型的web应用的目录结构如下：
一般来说，创建一个新应用，就是在资源管理器里，创建上面的目录结构，该目录建好后，一个新的空应用就搭建起来了。当然，润乾报表的web目录本身就是上述的标准目录结构，如果不是和已有应用集成，可以直接把润乾报表的web目录作为一个标准应用去发布。
第二步 拷贝 web 应用目录
从官网下载润乾报表安装包，按照提示安装润乾报表。
润乾报表的web应用目录可以从[安装根目录]\ report\web\webapps下获取，即demo目录。
下面列出润乾报表web发布目录中所有文件的目录结构及用途，拷贝时，根据需要进行选择。一般来说web发布目录中文件放在什么目录，那么拷贝到您的应用中时也对应的放到相应目录下。
特别需要注意的：所有文件中只有web.xml文件不能拷贝，而是打开润乾报表的web.xml文件，把其中的内容拷贝到您的web.xml文件中。其内容在web.xml中的顺序，要遵从相关应用服务器的规定。
如果不是和已有应用集成，而是新建应用，那么直接拷贝web.xml也无妨。
润乾报表web发布目录的目录结构如下：
|
web发布目录 |
||
|
raqsoft |
必须的目录，目录名不可以调整。子目录详细介绍参考web应用目录小节 |
|
|
jre-6u45-windows-i586.exe |
jre的安装包，客户端打印时如果检测到没有安装java环境，会自动下载此包，适合windows操作系统 |
|
|
raqsoftReportApplet.jar |
打印的applet包 |
|
|
raqsoft.cer |
applet打印签名证书 |
|
|
WEB-INF |
必须的目录，放置应用配置文件和jar |
|
|
web.xml |
配置servlet |
|
|
classes |
类文件 |
|
|
raqsoftConfig.xml |
报表的配置文件 |
|
|
raqsoftInput.tld |
填报报表相关tag标签 |
|
|
raqsoftReport.tld |
报表tag标签 |
|
|
raqsoftReportLog.properties |
配置润乾报表的日志文件路径、日志输出信息级别 |
|
|
reportFiles |
demo例子目录 |
|
|
lib |
WEB应用所需引用的jar包。各个jar的详细介绍参考web应用目录小节 |
|
第三步 配置指南
在文件raqsoftConfig.xml中配置数据源、报表存放位置和授权等信息。该文件位于[安装根目录]\report\web\webapps\demo\WEB-INF 下。
1，以Tomcat为例，如果应用服务器里已经配置了demo数据库的连接池，那么在<JNDIList>节点里就可以直接使用<JNDI>配置数据源了：
//指定与报表中所使用数据源名称一致的JNDI数据源名称
<JNDIList>
<JNDI name="demo">
<property name="type" value="13"/>
<property name="batchSize" value="1000"/>
<property name="lookup" value="java:comp/env/demo"/>
</JNDI>
</JNDIList>
如果不使用数据库连接池，也可以在<DBList>节点里使用<DB>配置数据源。raqsoftConfig.xml缺省已设置了demo数据源：
<DB name="demo">
<property name="url" value="jdbc:hsqldb:hsql://127.0.0.1/demo" />
<property name="driver" value="org.hsqldb.jdbcDriver" />
<property name="type" value="13" />
<property name="user" value="sa" />
<property name="password" />
<property name="batchSize" value="1000" />
<property name="autoConnect" value="false" />
<property name="useSchema" value="false" />
<property name="addTilde" value="false" />
<property name="caseSentence" value="false" />
</DB>
注：润乾报表web应用中，demo例子用的是hsql数据库，该数据库的驱动hsqldb-2.7.3-jdk8.jar可以从[润乾报表安装目录]\common\jdbc下获取，数据库驱动jar要放置在web应用服务能加载到的目录下。通过 [安装根目录]/report/bin中的startDataBase.bat启动hsql数据库。
2，<license> </license>
在<Report>节点里使用<license>指定报表授权，可为相对路径，相对路径前面不需要加反斜杠"/"。
比如:<license>E:\Mylicensetrial_zh.xml</license>
3，<home></home>
在<Report>节点里使用<home>指定报表文件在应用中的存放位置，其值可相对于web应用根目录，raqsoftConfig.xml缺省已设置了相对路径WEB-INF/reportFiles；也可是绝对路径，分隔符用"/"；还可以是类路径。需要从类路径下查找报表文件时，可以将reportFiles目录放到WEB-INF/classes下，或者把reportFiles目录打成jar包(jar里不能有中文否则tomcat启动不了)放到lib下，然后将home直接配置成reportFiles。
比如：设置成相对路径<home>WEB-INF/reportFiles</home>
更多raqsoftconfig.xml里的配置，可以参考raqsoftConfig.xml详细说明，按需配置。