反饋已提交

網絡繁忙

Tomcat嵌入式部署FineReport工程

一、概述

  1. 嵌入式部署適用於使用者已有一套工程,需要直接將FR的模組嵌入到自己原有工程,方便共同維護的場景。

  2. 不同於獨立部署,嵌入式部署是將FR工程的部分檔案複製到已有Web應用中。

  3. 本節內容:在Windows和Linux環境下進行FR的嵌入式部署。

二、Windows下FineReport的嵌入式部署

  1. 使用者經常需要將 FineReport10.0 伺服器整合到已有的工程中使用,以便在工程裡直接呼叫 FineReport 伺服器的程式碼。

  2. 由報表安裝目錄結構章節可知,若希望將報表部署到已有的工程中時,需要按照下圖所示的目錄結構,將報表相關的檔案複製到相應目錄。

1.png

1
環境配置。
  1. 使用者部署應用需配置JDK和Tomcat環境,相關內容可見JDK的安裝和配置以Tomcat的安裝和配置

  2. 需要注意的是 Tomcat 伺服器版本和 JDK 版本之間存在對應關係,版本不對應會導致伺服器部署失敗。

  Tomcat 版本

 JDK 版本 

  9.0.x

  8 及以上

  8.5.x

  8 及以上

  8.0.x

  7 及以上

  7.0.x

  6 及以上

2
複制目錄。
  1. 為了簡便,可以直接將%FineReport_HOME%webapps/webroot/WEB-INF目錄下面的 assets、assist、classes、embed、lib、plugins、reportlets 七個資料夾複制到%Tomcat_HOME% webapps/examples/WEB-INF下。 

  2. 也可以選擇性的只複制必要性檔案至已有工程中,具體複製參照下文部分複製內容。

  3. 注:%FineReport_HOME%webapps/webroot/WEB-INF/classes資料夾下面可能會放置一些網路報表的 class 檔案,在和使用者工程整合時並無沖突。

3
部分複制-必須複制的檔案。
  1. JAR 包:lib 中以 fine 開頭的 JAR 包(包含了報表服務的所有功能),及 netty-all-xxx.Final.jar、visualvm-xxx.jar,必須複製至 WEB-INFlib 下。

  2. assets:新特性圖表 8.6.0 及以後版本存放圖表資源的目錄。

  3. assist:存放一些輔助工具,比如新圖表要使用 phantom 等。

  4. plugins:該資料夾包含了報表管理裡安裝的所有插件的 JAR 包和配置資訊,複製至 WEB-INF 下面。

  5. reportlets:該資料夾為 FineReport 伺服器規定的,不能修改,且必須為小寫,其下可以建立子目錄,所有報表範本 cpt 檔案必須儲存在 reportlets 資料夾下,且 reportlets 檔案必須放在 WEB-INF 下面。

 2.png

3.png


4
部分複製-選擇性複制的檔案。
  1. embed:儲存 HSQL,所有的配置資訊,推薦複製至 WEB-INF 下面,否則部署的為新工程。

  2. classes:該資料夾是應用伺服器規定的,主要作用是存放 .class檔案。若對 FineReport 進行了二次開發,如自定義函式、程式資料來源、程式網路報表等,也需要將編譯後的 class 類檔案複製到該資料夾下。

  3. 資料庫驅動包:若報表中使用了 JDBC 連線了資料庫,需要將對應的資料庫驅動包如Oracle資料庫的驅動ojdbc14.jar複製到WEB-INFlib下,其他資料庫驅動同樣。

5
 複製 tools.jar。
  1. 將%JAVA_HOME%/jdk/lib下的 tools.jar 複製到部署的伺服器中,詳情參考:伺服器部署需引入 tools.jar

9.png

6
啟動 Tomcat 伺服器。
  1. 根據自己的系統,執行%Tomcat_HOME%\bin下的 startup.bat 或 startup.sh 檔案,啟動 Tomcat 伺服器。

  2. 以 Windows 系統為例,雙擊 【startup.bat】,啟動 Tomcat 伺服器。

10.png

7
檢測是否部署成功。
  1. 可以透過瀏覽報表確定是否部署成功。

  2. 重新啟動工程,開啟瀏覽器,在位址列輸入http://localhost:8080/webroot/decision(http:/ip:伺服器埠號/專案所在目錄/decision)能成功進入下圖所示頁面,則表明 FineReport 應用整合 Web 應用成功。

  3. Tomcat的默認埠號維8080,可以根據實際情況進行修改。

11.png

三、Linux下FineReport的嵌入式部署

  1. 若使用者希望將報表整合到自己的應用中的話,可參照下圖目錄,將對應的報表檔案複製到相應目錄即可

12.png

1
環境配置
  1. 使用者部署應用需配置JDK和Tomcat環境,相關內容可見JDK的安裝和配置以及Tomcat的安裝和配置

2
報表工程上傳至webapps下
  1. 此處複製設置同windows 下設置,選擇部分複製或者全部複製,將需要複製的內容壓縮為WEB-INF.zip上傳。

  2. 上傳完成後,再解壓。

  3. 命令列輸入:unzip WEB-INF.zip。

  4. 注:不推薦直接上傳資料夾,防止檔案出現問題。

3
引入 JDK 中的 tools.jar 檔案
  1. 將%JAVA_HOME%\jdk\lib下的 tools.jar 複製到部署的伺服器中

  2. 複製到%TOMCAT_HOME%\lib下或者%TOMCAT_HOME%\webapps\工程名\WEB_INF\lib下。

  3. 程式碼:cp /usr/java/jdk1.8.0_131/lib/tools.jar /usr/tomcat/apache-tomcat-8.5.69/lib。

4
重啟 Tomcat 伺服器。
  1. 進入%TOMCAT_HOME%/bin目錄,先運行shutdown.sh,關閉 Tomcat 伺服器:./shutdown.sh。

  2. 查找是否還有 Tomcat 的進程,如果有 kill tomcat 進程:ps -ef |grep tomcat。

  3. 如果有 Tomcat 的進程,則 kill,pid 爲相應的進程号:kill -9 pid。

  4. 再運行 startup.sh :./startup.sh。

  5. 查看 Tomcat 日志:tail -f ../logs/catalina.out。

13.png

5
效果查看
  1. 啟動瀏覽器,在位址列輸入:http://ip:伺服器埠號/工程名/decision,能成功看到部署成功頁面,則表明  FineReport 應用部署 Tomcat 伺服器成功,如下圖所示。

14.png


附件列表


主題: 部署集成
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉

獲取幫助
線上支援
獲取專業技術支援,快速幫助您解決問題
工作日9:00-12:00,13:30-17:30在线
頁面反饋
針對當前網頁的建議、問題反饋
售前咨詢
業務咨詢
電話:0933-790886或 0989-092892
郵箱:taiwan@fanruan.com
頁面反饋
*問題分類
不能為空
問題描述
0/1000
不能為空

反馈已提交

网络繁忙