Tomcat嵌入式部署FineReport工程

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

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

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

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

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

1

環境配置。

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

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

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 下面。

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。

6

啟動 Tomcat 伺服器。

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

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

7

檢測是否部署成功。

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

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

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

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

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。

5

效果查看。

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