轉-Pentaho技術白皮書中文版（七）--How-To: 用 Pentaho SDK 進行開發

Pentaho BI Platform SDK 是一個包，其包含：

Ø         Pentaho BI Platform 源碼

Ø         一個 sample solution

Ø         一個 standalone Eclipse 項目實例

Ø         sample 數據

Ø         一個爲運行平臺專門定製的 JBoss 應用服務器

這個包的目的是使得開發人員有一組可放進 IDE 的文件，相對簡單的開始編譯和逐步運行 Pentaho 源碼。咱們已經以其餘各類格式發佈了這個包中的內容，但爲響應咱們社團的需求，將之放進了這個一站式開發人員工具包中。咱們的目標就是使得咱們的社團更容易的擴展平臺知足他們的需求，而沒必要花費很大的精力來入門。

這個 SDK (和相關文檔) 並不討論 Pentaho Design Suite，或是 Report Designer。咱們的目標是馬上爲那些項目提供額外的 how-to’s 幫助。

咱們選擇的 IDE 是 Eclipse。這篇文檔的餘下部分介紹了在 Eclipse 中設置 SDK 的指令，但項目結構在其餘環境中也應該正常運行。若是你有在另外一個 IDE 中爲 Pentaho 進行開發的相關信息，咱們很歡迎你提供給咱們，以添加進這個文檔中。

目標讀者

SDK 和這篇文檔主要用於軟件開發者。咱們假設讀者已經很熟悉 Eclipse 平臺和 Java 開發。

咱們將逐步介紹平臺的兩個不一樣的配置安裝：爲一個 J2EE 應用開發，以及爲一個不須要應用服務器的「stand-alone」 Java 應用開發。若是目標就是將平臺部署爲一個 J2EE 應用， 咱們假設讀者有 J2EE 和應用服務器的相關經驗。此處，咱們使用 JBoss 應用服務器進行演示。

然而不是很重要的一點是：若是讀者有一點 Apache Ant 的知識，將會更好。

其餘資源

除了這篇文檔，還有如下可用的下載，文檔和資源：

資源	如何獲取
Pentaho Web Site 產品信息	http://www.pentaho.org
Technical Whitepaper 這篇文檔描述了 Pentaho BI 平臺的體系結構，以及它爲什麼是惟一的。	一個 PDF 下載文件 http://sourceforge. net/project/showfiles.php?group_id=140317
Advanced Installation Guide 這篇文檔回答了平臺安裝中的問題，以及如何從源和部署信息構建平臺。	一個 PDF 下載文件 http://sourceforge. net/project/showfiles.php?group_id=140317
Creating Pentaho Solutions 這篇文檔對於如何構建 Pentaho solutions 提供了詳細信息。	一個 PDF 下載文件 http://sourceforge. net/project/showfiles.php?group_id=140317
Product Roadmap 咱們的 development roadmap 是公開可訪問的	http://www.pentaho.org/jira/roadmap.html
Developer Zone 這個網站提供了最新的信息， 論壇， F.A.Q.s (一些不是那麼常見的問題)，以及額外的設計文檔。	http://www.pentaho.org 點擊 ‘Developer Zone’

 

需求和推薦

如下是你遵守這個 how-to 進行操做須要使用的工具列表。建議你在這個練習的開始就下載全部必需的包，這樣你就可不間斷的執行安裝指令。

Ø         Eclipse 平臺 IDE。咱們的研發隊伍目前使用 3.1.X 下的各類版本。你可從如下網址下載 Eclipse IDE： http://www.eclipse.org/downloads/index.php

Ø         一個 Java SDK。Pentaho BI 平臺在 Java SDK 1.4 上構建和測試，可在 http://java.sun.com/j2se/corejava/index.jsp 下載各類平臺上的 JDK，注意你須要完整的 SDK，而不只僅是runtime (JRE)。

Ø         Pentaho SDK。你應該和這篇文檔一塊兒使用的包是 pentaho-sdk-{latest­date-time}.zip，可在此處下載： http://www.pentaho.org/download/latest.html

Ø         若是你想運行練習「Debugging in JBoss Application Server」，你需確保你的計算機上的 8080 端口沒被另外一個應用佔用。這是 SDK 中 JBoss 應用服務器使用的默認端口。雖然你也可改變 SDK 使用的端口，但你沒必要在這一點上使得問題複雜化。若是端口 8080 被佔用了，咱們建議當你運行 SDK 的應用服務器時，臨時關閉使用 8080 端口的應用。

Eclipse 入門

那麼讓咱們開始。

目前你須要已經安裝了 Eclipse。若是你尚未下載 Eclipse，從上述的 URL 中下載。若是你已經安裝了 Eclipse，想使用你當前的安裝和 workspace，那麼你可跳過這一步，直接進入下一節，JBoss IDE 入門。

一旦你下載了 Eclipse，簡單的將內容從包中解壓到你的計算機上你喜歡的位置上。你應該看到一個相似下圖的目錄結構：

圖 1. Eclipse 項目結構

爲啓動 Eclipse，執行 eclipse.exe 程序(或你的 *nix 平臺上相似的可執行程序)。

你將被提示選擇一個目錄，做爲你的 workspace。Eclipse workspace 是你的計算機上定義的一個文件夾，你的全部 Eclipse 項目文件，源代碼和首選項均存放在那裏。在 Eclipse 中的對話框中指定你想用做你的 workspace 的文件夾。

圖 2. 選擇一個 Eclipse workspace 文件夾

JBoss IDE 入門

若是你想運行練習「Debugging in JBoss Application Server」，那麼你需爲 Eclipse 安裝 JBoss IDE 插件。Eclipse 的 JBoss IDE 插件是一個工具，其容許你逐步調試做爲一個 JBoss 應用服務器中的web 應用的一部分運行的 Java 類。

安裝 JBoss IDE 插件的指令可在這裏找到： http://docs.jboss.com/jbosside/install/build/en/html/installation.html。如安裝指令所述，這個插件是經過 Eclipse Update Manager 獲取到的。Eclipse Update Manager 容許你直接從 Eclipse 平臺安裝和更新 Eclipse 插件。

圖 3. Eclipse Update Manager

一旦你成功安裝了 JBoss IDE 插件，請進入下一節。咱們將描述爲調試練習「Debugging in JBoss Application Server」，如何配置插件。

Pentaho BI Platform SDK

unpack Pentaho SDK into your Eclipse workspace folder now.

SDK 包包含了全部的文件和項目設置，使得你可在 Eclipse 中運行。文件被打包，這樣你可將他們直接解壓縮到你的 Eclipse workspace。

使用你最喜歡的 archive 工具(如 7-Zip，WinZip)，將 Pentaho SDK 解壓進你的 Eclipse workspace 文件夾。

如下是一旦你解壓了SDK，你應該在你的 workspace 文件夾中看到的內容的截圖：

圖 4. Eclipse workspace 文件夾中的 Pentaho SDK 文件

pentaho 文件夾

pentaho 文件夾有 Pentaho BI 平臺的源碼，資源和項目設置。這是你將瀏覽和逐步瞭解平臺代碼和體系結構的項目。

pentaho-standalone 文件夾

pentaho-standalone 文件夾有一個簡單的 solution，平臺庫和依賴，不使用 J2EE 應用服務器，獨立運行平臺的 Java 應用的代碼。

pentaho-data 文件夾

pentaho-data 文件夾有 HSQLDB 文件，其爲咱們的 demo solutions 組成了默認數據庫，以及啓動和關閉數據庫的腳本。

pentaho-solutions 文件夾

pentaho-solutions 文件夾包含全部 xml 文件，xaction 文件和組成 Pentaho demo solutions 的其餘資源。

pentaho-preconfiguredinstall 文件夾

preconfigured-install 文件夾中有一個完整的 JBoss 應用服務器，爲運行 Pentaho BI 平臺代碼進行了調整和配置。

如上述，pentaho 文件夾包含 Pentaho BI 平臺的源碼。其餘 3 個文件夾(除了 pentaho-standalone 文件夾) 是運行平臺必需的支撐文件夾。這裏的思路是使得做爲開發人員的你能查看咱們如何構建咱們的 demo 應用，其應該爲你提供足夠的知識，而後爲你本身的 solutions 修改這些文件，或在你本身的框架中使用平臺 SDK(例如，Struts，JFaces，HTML，Java 應用等)。

在 Eclipse 中設置 SDK

既然你的計算機上已經有了源碼，你須要告訴 Eclipse：在 Eclipse 透視圖中有你想看到的定義好的項目。

Pentaho 平臺被安裝爲5個單獨的 Eclipse 項目。你沒必要將 5 個文件夾均設置爲 Eclipse 項目，但如能看到 Eclipse 視圖和透視圖中的全部文件，確實有用。咱們將預排全部項目的設置。

導入 Pentaho 項目

Pentaho，pentaho-data，pentaho-standalone，pentaho-solutions 和 pentaho-preconfiguredinstall 文件夾中均有 .project 文件，這些是 Eclipse 用來將這些文件夾配置爲項目所用的文件。這些文件夾可做爲項目導入進 Eclipse。

1.         啓動 Eclipse，打開 Java 透視圖

2.         從 File 菜單，選擇 ‘Import...’ 選項

3.         從 Import 對話框，選擇 ‘Existing Projects Into Workspace’ 選項

4.         將出現一個 Import Projects 提示對話框，其詢問你想從那個目錄導入文件。選擇 ‘Select Root Directory’ 選項，並指定你的 workspace 文件夾做爲根目錄。

圖 5. Eclipse 中的 Import Project 對話框

5.你將看到已經爲導入選擇了 Pentaho 文件夾。選擇窗口底部的 Finish 按鈕。

如今你將在 Eclipse中看到全部的 Pentaho 項目。

圖 6. Eclipse 中的 Pentaho 項目

Eclipse 有幾種不一樣類型的項目。Pentaho 利用了兩種不一樣的 Eclipse 項目：simple 項目和 Java 項目。

pentaho-data，pentaho-solutions 和 pentaho-preconfiguredinstall 項目都是 Eclipse simple 項目。這意味着那些項目有大部分基本的 Eclipse 項目配置和能力，其和文件瀏覽同樣。

pentaho 項目是一個 Eclipse Java 項目。這個項目是不一樣的，由於如前所述，這是惟一一個包含了須要編譯的源碼的項目。由於將之定義爲一個 Java 項目，pentaho 項目有和 Java 相關的配置選項和功能。

你會當即注意到(若是你激活了「Build Automatically」)在導入時，就編譯了 pentaho 項目。可能會有幾個警告，但沒有編譯錯誤。耐心點，這可能須要持續一分鐘，取決於你的計算機的速度。pentahostandalone 項目也是一個 Java 項目。它不會自動編譯，由於在項目運行前，有一些必需的設置步驟。詳細信息參考下一節。

若是項目沒有在導入時進行自動編譯，如今使用 Project 菜單手動編譯。從左邊的視圖中選擇 pentaho 項目，而後從 Project 菜單，選擇 ‘Build Project’ 選項。

若是你此時碰到了編譯錯誤，咱們可提供幫助！將 Eclipse 報出的編譯錯誤提交到咱們的論壇，位於http://www.pentaho.org/discussion。論壇裏的不少成員和 Pentaho 開發人員均可以提供幫助！

學習工具：在 Standalone 平臺項目中調試

Standalone 項目，pentaho-standalone，包含在 Pentaho BI 平臺 SDK 中以提供一個實例應用，其利用沒有 J2EE 應用服務器的平臺的能力。項目包含一個 Java 應用，其運行兩個 action sequences，將每一個的結果寫進一個文件。

在這個學習工具中，咱們將通過如下步驟：

1.         設置 standalone 項目；

2.         解釋使得 standalone 配置運行起來的代碼和資源；

3.         最後，在 sample 代碼中設置一個斷點，演示 standalone 應用的調試。

Standalone 項目設置

Standalone 項目依賴於 pentaho 項目。爲開始使用 Standalone 項目，你必須首先運行一個 Ant target，sample-setup，它將爲咱們的實例生成適當的庫。

爲設置 Standalone 項目：

1.         從 Eclipse 中的 Java 透視圖，選擇 build.xml 文件，其位於 pentaho­standalone 項目的根目錄。對於這個，我喜歡使用 Navigator 視圖(默認不可見)，但有另幾個使文件選擇變得容易的視圖– 使用你最喜歡的那個。

2.         右擊 build.xml 文件，選擇 ‘Run As...’ 選項，而後選擇 ‘Ant Build...’ 選項。

3.         會出現一個 Ant Build 提示對話框。取消選擇任何預先選擇的 targets，僅選擇sample-setup target。

圖 7. Ant Build 對話框.

4.         選擇對話框底部的 ‘Run’ 按鈕。你將在 Eclipse 中的 Console 視圖看到腳本的 activity 日誌。一旦完成 target，你將看到消息「Build SUCCESSFUL」。

5.         在 Eclipse Navigator 視圖中，選擇 pentaho-standalone 項目的根文件夾。右擊文件夾，選擇 ‘Refresh’選項。這將刷新子文件夾，這樣你可看見做爲構建項目的結果添加的文件。

6.         下一步，讓咱們移除對 pentaho 項目的依賴性。右擊 pentaho-standalone 項目，點擊屬性，出現 pentaho-standalone 的 Properties 對話框。

7.         在對話框的左邊，選擇 Java Build Path，選擇 Projects 標籤頁，點擊 remove 按鈕。注意這樣就從列表中刪除了 pentaho。

8.         下一步點擊 Libraries 標籤頁，點擊 Add Jars 按鈕，出現 Jar Selection 對話框。

9.         選擇 pentaho-standalone，確保將每一個 jar 添加進 lib 目錄。

項目如今應該準備好逐步調試了，但讓咱們首先解釋組成項目的文件。

Standalone 項目的代碼和資源

你該看到相似於下圖所示的 pentaho-standalone 項目的文件結構。咱們以最少許必需的資源(文件和源碼)構建了 standalone 項目，所以你可瞭解運行 standalone 平臺的最低要求。

圖 8. stand-alone 項目文件結構

lib 目錄

lib 目錄有運行 pentaho-standalone Java 應用所必需的全部依賴庫。

庫被放進了不一樣的子目錄，以澄清爲什麼包含每一個庫。Components 目錄下的庫主要用於組件功能。core 目錄下是運行平臺所必需的庫。datasource 目錄下是 HSQLDB driver 庫，固然 pentaho-<version>.jar 是平臺自身。

resource/solution 目錄

resource/solution 目錄下是咱們的實例的 solution 文件。這些文件很相似於咱們的 demo 中包含的那些。在咱們的 solution 中有兩個 action sequences，‘Hello World’ 和 ‘Simple Report’。若是你瀏覽 resource/solution 目錄，你將看到 action sequences 的文件。

源文件

src 目錄下是以 standalone Java 應用執行平臺的源碼。

org.pentaho.app.SimpleCase.java 類是運行平臺，以及最後運行 solution 的一個主類。這個類初始化平臺，運行一個很簡單的 ‘Hello World’ action sequence，而後運行一個很簡單的 JFreeReport action sequence。爲了簡化，兩個 action sequences 均生成寫進文件中的結果。

public static void main(String[] args) { try { Init.initialize() ; SimpleCase sCase = new SimpleCase();sCase.simpleCase( args ); } catch (Exception e) {e.printStackTrace();} } ... public void simpleHelloWorldCase( String outputPath ) { try { File f = new File( outputPath + File.separator + "hello _world.txt" ); FileOutputStream outputStream = new FileOutputStream(f); HashMap parameters = new HashMap(); ISolutionEngine solutionEngine = SolutionHelper.execute( "Simple Case Example", "Hello World", "getting-started/HelloWorld.xaction", parameters, outputStream ); } catch (Exception e) {e.printStackTrace();}

org.pentaho.app.Init.java 類僅有一個有趣的方法–初始化平臺的方法：

public static boolean initialize() { try { // We need to be able to locate solution files. in this example, we are using the relative path in our project/package. File solutionRoot = new File( "resource/solution" ); // Create a standalone application context - our application toolbox if you will - passing the path to the solution files. IApplicationContext context = new StandaloneApplicationContext(solutionRoot.getAbsolutePath(), new File(".").getAbsolutePath() ); // Initialize the Pentaho system PentahoSystem.init( context ); return true; } catch (Throwable t) { t.printStackTrace();return false; } }

逐步運行 Sample 代碼

你應該很熟悉如何在 Eclipse 中逐步運行代碼，但咱們仍然在此提供了一個實例。當你在 Eclipse 中運行 SimpleCase 類以前，你必須首先啓動 demo 數據庫。

爲啓動數據庫：

1.         經過命令行或使用你最喜歡的文件瀏覽工具（在Eclipse 以外）瀏覽至 pentaho-data 文件夾。

2.         在 pentaho-data/demo-data 文件夾下，有 Windows OS 和 *nix 平臺的啓動和關閉腳本。執行適合於你的計算機的啓動腳本(.bat 文件用於 Windows，.sh 文件用於 *nix)。

如今設置一個斷點，並執行 SimpleCase main() 方法，這樣你可看到正在進行的開發過程。

1.         先切換到 Eclipse Debug 透視圖，若是你尚未的話。

2.         從 Eclipse 的不少文件瀏覽視圖中的一個(我使用 Navigator)，在 pentaho­standalone 項目中瀏覽到 src/org/pentaho/app/SimpleCase.java，並打開那個文件。

3.         在 SimpleCase.java 文件的 73 行設置一個斷點(從右鍵菜單)。(注意：當代碼改變時，這個行號也極可能改變。咱們設置斷點的代碼行就是包含 Init.initialize() 代碼的那行)。

4.         右擊你的文件瀏覽視圖中的 SimpleCase.java 文件。選擇 ‘Debug As...’ 選項，而後選擇 ‘Java Application’ 選項。這將以一個 Java 應用啓動類。

圖 9. 在 Eclipse 中設置一個斷點

5.         程序將在你的斷點處中止執行。在此處，你可在 Eclipse 中 step into，step over 或繼續執行。額外的調試信息請查看 Console 視圖。

學習工具：在 JBoss 應用服務器中調試

如今你準備使用 pentaho-preconfiguredinstall 項目（一個JBoss 應用服務器）部署和調試平臺。

這個學習工具包含如下練習：

1.       首先咱們將逐個介紹對你來講，將平臺 Java 代碼和 web 應用文件從 pentaho 項目部署進 pentaho-preconfiguredinstall 項目可用的工具。

2.       下一步就是在 JBoss IDE 中配置一個服務器。咱們將採用這個步驟，運行將平臺部署爲一個 web 應用的 JBoss 應用服務器。

3.       最後，在平臺 Java 代碼上設置一個斷點，運行 ‘Hello World’ sample solution，從那個斷點逐步運行代碼。

部署和更新 Platform Web 應用

pentaho 項目和 pentaho-preconfiguredinstall 項目用於開發目的。這些項目的意義是：提供簡單的方式得到編寫爲平臺的一部分的代碼(在 pentaho 項目中)，並將之做爲部署在 JBoss 服務器(pentaho-reconfiguredinstall 項目)上的 web 應用的一部分，放進正確的結構中。

在 pentaho 項目的 build.xml 文件中定義了兩個 Ant 任務，其調節這個開發過程：他們是 dev-setup 和 dev-update targets。

dev-setup Target

dev-setup target 是一個 Ant 腳本，其執行如下服務：

Ø         編譯 src 文件夾下的平臺源碼。

Ø         構建一個 JBoss 4.0.3-compliant war 文件。若是你不熟悉 war 文件，參考 Sun 的關於 J2EE 和 web 應用 archives 的文檔。

Ø         將 HSQLDB 庫文件複製進 pentaho-data 項目(之後詳細介紹)。

Ø         將平臺 war 文件部署進 pentaho-preconfiguredinstall 項目。

Ø         將 pentaho-style war 文件部署進 pentaho-preconfiguredinstall 項目。這個 war 文件包含 demo web 應用的全部 style 資源。

Ø         將 pentaho-portal-layout war 文件部署進 pentaho-preconfiguredinstall 項目。這個 war 文件包含 demo web 應用的 portal 部分的全部 portal layout 資源。

Ø         部署 JBoss 應用服務器必需的數據定義 xml 文件，以識別 pentaho-data 項目中的 HSQLDB 數據庫。

應該在你首次設置 Pentaho 項目時運行 dev-setup target。它用平臺 web 應用完整組裝 preconfigured-install。

爲運行 dev-setup target：

1.       從 Eclipse 的 Java 透視圖，選擇文件 build.xml，其位於 pentaho 項目的根目錄。對此，我喜歡使用 Navigator 視圖(默認不可見)，但有另幾個視圖使得文件選擇更容易 – 使用你最喜歡的那個。

2.       右擊 build.xml 文件，選擇 ‘Run As...’ 選項，而後選擇 ‘Ant Build...’ 選項。確保你選擇選項 with ellipses on end！‘Ant Build’ 選項構建 DEFAULT target，其可能不是 dev-setup target。

3.       將出現一個 Ant Build 提示對話框。取消選擇任何預選擇的 targets，並僅選擇 dev-setup target。

圖 10. Ant Build 對話框.

4.       選擇對話框底部的 ‘Run’ 按鈕。你應該在 Eclipse 的 Console 視圖看到腳本的 activity 日誌。一旦完成 target，你將看到消息 「Build SUCCESSFUL」。pentaho-preconfiguredinstall 項目如今已經被組裝了 Pentaho 平臺 web 應用。

dev-update Target

dev-update target 是一個腳本，其將更新 pentaho­preconfiguredinstall 項目中的平臺 web 應用中任何你修改過的文件。所以，例如，若是你添加或修改了 pentaho 項目中的任何 .java 文件，dev-update target 將爲你執行如下服務：

Ø         將任何新的或修改過的 java 類複製進 pentaho­preconfiguredinstall 項目中的適當目錄。

Ø         將任何新的或修改過的 jsps 複製進 pentaho-preconfiguredinstall 項目中的適當目錄。

Ø         將任何新的或修改過的 xml datasource 定義複製進 pentaho­preconfigured-install 項目中的適當目錄。

Ø         修改 pentaho web 應用中的 web.xml 文件，其致使 JBoss 服務器自動重載 web 應用，並當即得到修改。

當你修改了源碼，並想在 JBoss 應用服務器上測試這些修改時，運行這個 target。

你可利用以上爲 dev-setup target 列出的指令運行 dev-update target，但固然要選擇 dev-update target。

配置 JBoss IDE 服務器

既然你已經將 pentaho web 應用複製進 pentaho-preconfiguredinstall 項目，是時候啓動 JBoss 應用服務器，並確保一切正常運行了。

JBoss IDE 是一個很好的工具。它易於配置，一旦完成配置，你所需作的就是經過 IDE 啓動服務器，這樣你就能調試 Java 代碼。

爲在 JBoss IDE 中配置一個新的服務器：

1.       切換到 Eclipse Debug 透視圖

2.       從 Window 菜單，選擇 ‘Show View’ 選項，而後選擇 ‘Other...’ 選項。

3.       會出現一個具備指定 views 的提示對話框。選擇 ‘JBoss IDE’ 選項，而後選擇 ‘Server Navigator’ 視圖。

圖 11. 選擇 JBoss IDE Server Navigator 視圖

4.       選擇 OK 按鈕來完成。你應該看到 Server Navigator 視圖出如今 Eclipse Debug 透視圖的底部。

圖 12. Eclipse Debug 透視圖中的 Server Navigator 視圖

5.       右擊 Server Navigator 窗口 pane。選擇 ‘Configuration...’選項。

6.       將會出現一個 Configuration 提示對話框。在左邊的 pane 中，選擇 ‘JBoss 4.0.x’ 選項，而後選擇 left pane 下的 New 按鈕。你應該一個相似於下圖的對話框。

圖 13. JBoss Server 配置對話框

7.       輸入 ‘pentaho-server’ 做爲你的新配置的名字。

8.       選擇 ‘Browse...’ 按鈕，瀏覽至 pentaho-reconfiguredinstall 文件夾。將這個文件夾設置爲 JBoss 4.0.x Home 目錄。

9.       選擇 ‘default’ 做爲服務器配置。

10.   選擇 ‘Apply’ 按鈕保存這個配置。

11.   切換到對話框中的 ‘Source’ 標籤頁。

12.   從下一個對話框中選擇 ‘Add’ 按鈕，而後選擇 ‘Java Project’，從最後一個對話框中選擇‘pentaho’，選擇 OK。

圖 14. 將源碼鏈接到 JBoss Server 配置

13.   選擇 ‘Apply’ 按鈕保存這個配置。

14.   選擇 ‘Close’ 按鈕關閉對話框。

你如今應該看到 ‘pentaho-server’ 列在你的 Server Navigator 視圖中。經過右擊 Server Navigator 視圖中的 pentaho-server 條目，你可啓動和中止 pentaho-server。

注意!!! 在你啓動 pentaho-server 前，爲正確運行 demo，你必須首先啓動數據庫。啓動數據庫的指令請查看下一節。

逐步運行 ‘Hello World’

剩下的要作的就是啓動平臺，設置斷點，監測其運行。

最後一步要注意的是，當你在 Eclipse 中試圖啓動 pentaho-server 以前，你必須首先啓動 demo 數據庫。

爲啓動數據庫：

1.         經過命令行，或使用你喜歡的文件瀏覽工具（Eclipse以外）瀏覽至 pentaho-data 文件夾。

2.         在 pentaho-data/demo-data 文件夾下，有 Windows OS 和 *nix 平臺下的啓動和關閉腳本。執行適合你的計算機的啓動腳本(.bat 文件用於 Windows，.sh 文件用於 *nix)。

如今啓動 pentaho-server：

1.       從 Eclipse Debug 透視圖的 Server Navigator 視圖，右擊 pentaho-server 條目。

2.       選擇 ‘Start’ 選項。

在 Console 視圖中上下滾動，你將看到不少啓動消息和警告。只要啓動時最後一條消息是 「Pentaho BI Platform server is ready.」，那麼你就知道平臺已經啓動了，並運行成功。

如今設置一個斷點，並執行 ‘Hello World’ demo solution，這樣你可看到進行中的開發過程。

1.         切換到 Eclipse Debug 透視圖，若是你還沒在那裏的話。

2.         從 Eclipse 的衆多文件瀏覽視圖之一(我使用 Navigator)，在 pentaho 項目中瀏覽至server/pentaho/src/org/pentaho/core/runtime/RuntimeContext.java，並打開那個文件。

3.         在文件 RuntimeContext.java 的 878 行設置一個斷點(從右鍵菜單)(注意：由於代碼的改變，這個行號極可能已經改變了。咱們設置斷點的代碼行是包含 executeComponent() 代碼的那行)。

圖 15. 在 Eclipse 中設置一個斷點

4.         下一步，打開一個 web 瀏覽器窗口，瀏覽至http://localhost:8080/pentaho/ViewAction?&solution=samples&path=getting-started&action=HelloWorld.xaction.

5.         你在 Eclipse 中的斷點應該在組件執行結果從服務器發送回瀏覽器以前被點擊。此處，你可在 Eclipse 中 step into，step over 或繼續執行。額外的調試信息請查看 Console 視圖。