WEB基础平台——从皕杰产品包中拆分皕杰报表工具的方法

从集成演示环境拆分皕杰报表工具的方法

皕杰产品合集（产品下载包）中包含了皕杰报表和皕杰基础平台两部分，在DEMO演示环境中，皕杰平台充当了皕杰报表的门户，可以在平台上部署报表并设置报表的访问权限，可以建立组织机构、用户及后台作业任务等操作。但是并不是说报表就离不开平台了，皕杰报表的显著特征就是能从集成环境中轻松地拆分出来，独立部署或嵌入到java项目中。

那么怎么拆分呢？以tomcat下部署为例，说的简单一点就是把与报表相关的jar和文件夹拿出来放到一个新的tomcat的相关目录下，再配置好数据库连接池和数据源就ok了。具体步骤如下：

1、准备工作：

下载并安装JDK1.8，tomcat9.0。下载并解压皕杰报表6.1。

2、创建一个项目report

在apache-tomcat\webapps下创建一个文件夹名为report。

3、拷贝demo用的jsp和css等

打开文件夹BIOS Server\webapps\iface，将report、report_res文件夹复制到apache-tomcat\webapps\report文件夹下。

4、创建WEB-INF文件夹

在文件夹apache-tomcat\webapps\report下，新建一个文件夹名为WEB-INF（必须为大写）。

5、创建数据、系统、应用和资源文件夹

打开文件夹apache-tomcat\webapps\report\WEB-INF，新建4个文件夹，分别名为data、lib、reports、resources。

6、拷贝demo用内置数据库

打开文件夹BIOS Server\webapps\iface\WEB-INF\data，将文件夹内的bijet.mv.db复制到apache-tomcat\webapps\report\WEB-INF\data文件夹下。

7、拷贝demo用报表模板文件brt

打开文件夹BIOS Server\webapps\iface\WEB-INF\reports，将文件夹内所有文件复制到apache-tomcat\webapps\report\WEB-INF\reports文件夹下。

8、拷贝报表系统文件

打开文件夹BIOS Server\webapps\iface\WEB-INF\lib，将文件夹中部分jar包复制到apache-tomcat\webapps\report\WEB-INF\lib下，jar包如下图所示：

9、配置servlet

在文件夹apache-tomcat\webapps\report\WEB-INF下，新建xml文件，名为web.xml。内容如下：

  <?xml version="1.0" encoding="UTF-8"?>
  <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee" 
  xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
  http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
      id="WebApp_ID" version="2.5">
      <servlet>
          <servlet-name>reportServlet</servlet-name>
          <servlet-class>bios.report.engine.output.ReportEmitter</servlet-class>
          <init-param>
              <param-name>reportConf</param-name>
              <param-value>/WEB-INF/resources/report_config.xml</param-value>
          </init-param>
          <load-on-startup>1</load-on-startup>
      </servlet>
      <servlet>
          <servlet-name>collecterServlet</servlet-name>
          <servlet-class>bios.report.engine.output.ReportCollecter</servlet-class>
      </servlet>
      <servlet>
          <servlet-name>accessorServlet</servlet-name>
          <servlet-class>bios.report.engine.output.ReportAccessor</servlet-class>
      </servlet>
      <servlet>
          <servlet-name>fillinServlet</servlet-name>
          <servlet-class>bios.report.engine.output.ReportFillin</servlet-class>
      </servlet>
      <servlet-mapping>
          <servlet-name>reportServlet</servlet-name>
          <url-pattern>/ReportEmitter</url-pattern>
      </servlet-mapping>
      <servlet-mapping>
          <servlet-name>collecterServlet</servlet-name>
          <url-pattern>/ReportQuerier</url-pattern>
      </servlet-mapping>
      <servlet-mapping>
          <servlet-name>accessorServlet</servlet-name>
          <url-pattern>/ReportHelper</url-pattern>
      </servlet-mapping>
      <servlet-mapping>
          <servlet-name>fillinServlet</servlet-name>
          <url-pattern>/ReportFeeder</url-pattern>
      </servlet-mapping>
  </web-app>

10、拷贝配置文件

打开文件夹BIOS Server\webapps\iface\WEB-INF\resources，将文件夹内的custom_colors.properties、custom_functions.properties、print_config.xml、report_config.xml四个文件复制到apache-tomcat\webapps\report\WEB-INF\resources文件夹下。

11、拷贝数据库驱动

打开文件夹BIOS Server\webapps\iface\WEB-INF\lib，将文件夹内的h2-1.4.188.jar（H2数据库的jdbc驱动）复制到apache-tomcat\lib文件夹下。

12、配置URL编码

开文件夹apache-tomcat\conf下server.xml,找到如下内容:

  <Connector port="8080" protocol="HTTP/1.1" 
      connectionTimeout="20000"
      redirectPort="8443" />

在这个节点里加上URIEncoding="UTF-8"

  <Connector port="8080" protocol="HTTP/1.1" 
      URIEncoding="UTF-8"
      connectionTimeout="20000"
      redirectPort="8443" />

13、配置数据库连接池

在server.xml找到节点如下图所示：

在host节点里添加如下内容

  <Context path="/report" docBase="report" reloadable="false">
    <Resource name="BIOS_DS" auth="Container" 
    type="javax.sql.DataSource"
          username="sa"
          password=""
          driverClassName="org.h2.Driver"
          url="jdbc:h2:../webapps/report/WEB-INF/data/bijet"
          maxActive="50"
          maxIdle="5"
          maxWait="3000" />
  </Context>

效果如下图所示：

14、配置数据源

打开文件夹apache-tomcat\webapps\report\WEB-INF\resources下的report_config.xml，在里添加如下内容：

  <dataSource>
    <Name>BIOS_DS <!-- 数据源名称，与设计器中一致 -->
    <JNDIPrefix>java:comp/env/</JNDIPrefix> <!-- JNDI查找前缀 -->
    <JNDIName>BIOS_DS</JNDIName> <!-- 数据源的JNDI资源名称 -->
    <DBType>H2</DBType> <!-- 数据库类型 -->
    <DBEncode>gbk</DBEncode> <!-- 数据库编码方式 -->
    <SQLDecode>false</SQLDecode> <!-- 是否进行Sql语句转码 -->
    <Default>true</Default> <!-- 是否为默认数据源 -->
  </dataSource>

如下图所示：

15、建立索引页和菜单

在文件夹apache-tomcat\webapps\report下新建三个文件，名称分别为index.jsp、welcome.html、left.jsp。

index.jsp的内容如下：

  <%@page language="java"  contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
  <%
    String root = request.getContextPath();
  %>
  <html>
    <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <title>皕杰报表演示中心</title>
    </head>
    <frameset rows="*" cols="203,*" framespacing="1" frameborder="0" border="0" bordercolor="#333366">
        <frame src="<%=root%>/left.jsp" name="leftFrame" noresize>
        <frame src="<%=root%>/welcome.html" name="mainFrame">
    </frameset>
    <noframes>
      <body>
      </body>
    </noframes>
  </html>

welcome.html的内容如下：

  <html>
  <head>
      <title>欢迎</title>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <link rel="stylesheet" type="text/css" href="css/style.css" />
  </head>
  <body background="img/bg3.jpg">
          <div class="block">
          <h4 class="block-title">欢迎来到报表测试中心!</h4>
          <div class="block-body">
              BIOS Report是新一代的基于java的报表平台软件，它具有以下特点：<br/><br/>
              <ul class="list">
                  <li>完全支持多数据源、多数据集，以及在同一张报表中使用不同类型的数据集</li><br/>
                  <li>基于excel的设计器，大幅度提升了报表的开发效率</li><br/>
                  <li>报表设计器基于优秀的eclipse平台，采用SWT技术，在效率上有明显的提升</li><br/>
                  <li>专门为复杂报表优化了报表引擎，使得在制作复杂报表的时候不但设计效率高，生成效率更优秀</li><br/>
                  <li>在报表的生成、输出过程中采用AJAX技术，有效的减少了报表服务器的负荷，同时也使得页面的展现更加平滑</li><br/>
                  <li>在web展现时，采用dhtml技术，使得生成后的报表仍可以动态调整</li><br/>
                  <li>完整的报表生命周期管理，从报表的设计、测试、发布、生成、归档都有一致的用户使用感受</li><br/>
                  <li>在报表设计上采用拖拉拽的技术及报表项目的概念，极大的提高了开发效率</li><br/>
                  <li>功能齐全的报表服务器，使得报表软件不在仅仅是设计器和报表引擎，报表的管理、订阅、发布、归档都纳入到报表中来，成为一个真正的报表平台</li><br/>
              </ul><br/><br/>
              <center>
                创新的理念，优秀的产品，贴心的服务，我们是拥有过硬技术的团队！
              </center>
          </div>
          </div>
  </body>
  </html>

left.jsp的内容如下：

  <%@page language="java"  contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
  <%
    String root = request.getContextPath();
  %>
  <html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
  <h3>皕杰报表菜单</h3>
  <ul>
    <li><a href="<%=root%>/ReportEmitter?rpt=Demo/01分组报表/01普通分组.brt" target="mainFrame">普通分组</a></li>
    <li><a href="<%=root%>/ReportQuerier?rpt=Demo/05查询表单/01查询表单示例.brt" target="mainFrame">查询表单示例</a></li>
  </ul>
  <body>
  </html>
  /ReportEmitter?rpt=Demo/01分组报表/01普通分组.brt是普通报表的访问连接。
  /ReportQuerier?rpt=Demo/05查询表单/01查询表单示例.brt是带有参数查询表单报表访问连接。
  apache-tomcat\webapps\report\WEB-INF\reports是报表的根目录，其它报表url的参数rpt的值，可以根据这个报表所在路径写。

16、添加索引页

打开文件夹apache-tomcat\webapps\report\WEB-INF下的web.xml，添加如下内容：

  <welcome-file-list>
      <welcome-file>/index.jsp</welcome-file>
  </welcome-file-list>

如图所示：

17、启动tomcat

打开文件夹apache-tomcat\bin，在文件夹下有startup.bat，双击启动。

18、通过浏览器访问

打开浏览器输入：http://localhost:8080/report

有产品有技术服务好可信赖

免费试用

仅需1分钟，即可体验新一代企业级Java报表工具，充分挖掘数据价值，引领企业增长！