JBoss SOA Web Service - Math Sample

於 JBoss SOA 開發及部署 Sample Web Service - MathWS，為下一篇 RiftSaw Sample 做準備，MathWS Sample 很單純的只做 ＋、－、Ｘ、／ 的運算。

準備執行環境

只單純部署 MathWS 不需要 MySQL ，但因 JBoss SOA 的環境已有其他設定，因此將 MySQL 列入，不同的環境可考慮將 MySQL 排除。 JBoss Web Services 只是列出版本 SOA Server 已包含在內。

• Eclipse Java EE IDE 3.6.1(Helios)+
• JBoss Tools Plugin 3.2+
• JBoss SOA Server 5.0.2.GA+
• JBoss Web Services 3.1.2.SP3_CP01+
• MySQL Server 5.1

JBoss RiftSaw Getting Started Guide

RiftSaw 是 JBoss open source 的 BPEL 產品，也就是 WS-BPEL 2.0 Engine，其核心是採用 Apache ODE 並與 JBoss ESB(Enterprise Service Bus) 整合，可運行在 JBoss AS/SOA 平台。

關於 Apache ODE 及 BPEL 可參考 Apache 官網及 WS-BPEL 2.0 OASIS 的說明，也可參考另一篇 Create BPEL process with Eclipse BPEL designer and Apache ODE 。

BPEL Process Designer 除了使用 Eclipse IDE 外，也可使用 JBoss Developer Studio(JBoss Tools) ， 另外也提供不同於 Apache ODE 的 BPEL Console 。

準備執行環境

Eclipse、JBoss SOA、MySQL 的安裝不在此說明，測試環境是使用 JBoss SOA 也就是 JBoss ESB 的運行平台，因此不需另外安裝 JBoss ESB，JBoss EAP(Enterprise Application Platform)即不具有 ESB 的環境，另外有使用到 BPEL 整合ESB的功能(ex.'samples/esb' examples)才需安裝 ESB。

• Eclipse Java EE IDE 3.6.1(Helios)+
• Eclipse BPEL Visual Designer 0.5.0
• JBoss SOA Server 5.0.2.GA+
• JBoss ESB Server 4.10+
• JBoss RiftSaw 2.3.0+
• MySQL Server 5.1
• Apache Ant 1.8.2+

Create BPEL process with Eclipse BPEL designer and Apache ODE

BPEL(Business Process Execution Language) 是一種 XML-based 的語言，用於定義數個負責企業商業流程的 Web Service 交互作用，也就是可以透過 BPEL 將二個以上的 Web Service 以 process flow 的方式讓 Web Service 可以協同工作。

BPEL 也是 based on Web Service 也就是比照 Web Service 的操作方式，透過 wsdl 產出 Web Service client 來呼叫 BPEL 。

而 Apache ODE (Orchestration Director Engine)則是 BPEL Engine 用於執行 BPEL Process ；另外 Eclipse IDE 有提供 BPEL designer plugin ，可以用視覺化的方式建置 BPEL Process File ，再透過 IDE 佈署及執行於 Apache ODE 。

準備執行環境

Eclipse IDE 及 Tomcat 7 的安裝不在此說明。

• Eclipse Java EE IDE 3.6.1(Helios)+
• Eclipse BPEL Visual Designer 0.5.0
• Apache Tomcat 7.0.2+
• Apache ODE 1.3.5

Configure JBoss Messaging Bridge

JBoss Messaging Bridge 可以將 messages 從一台 JBoss Server 傳送到另一台 JBoss Server，也就是將 messages 傳送至甲地(Source Destination)而由乙地(Target Destination)接收 messages，Queue跟Topic 二種模式都支援。
以下的測試主要是參考 How to Configure JBoss Messaging Bridge in JBoss AS 5 ? 。

準備執行環境

因測試需要二台 JBoss Server 以新增 JBoss Nodes的方式來建立測試環境，新增 JBoss Nodes可以參考另一篇文章：JBoss EAP 5 Multi Apps Services。
JBoss Messaging 1.4.6.GA 只是列出版本號碼，不需另外安裝，JBoss EAP 5.0 即包含 JBoss Messaging 。

• JDK (Java Development Kit) version 1.6+
• JBoss Enterprise Application Platform 5.0
• JBoss Messaging 1.4.6.GA

JBoss EAP 5 Multi Apps Services

說明 JBoss EAP 5.0 新增 Nodes，新增的 JBoss Nodes 執行於不同的 JVM。

準備執行環境

主要為JBoss EAP 5.0，預設 Server 已配置這裡不再贅述

• JDK (Java Development Kit) version 1.6
• JBoss Enterprise Application Platform 5.0

JBoss 5.0 DefaultDS Configuration using MySql

說明 JBoss AS 5.0 配置 MySQL DataSource。

準備執行環境

預設JBoss AS 5.0 及 MySQL Server 5.1 已配置這裡不再贅述

• JDK (Java Development Kit) version 1.6
• JBoss Enterprise Application Platform 5.0
• MySQL Server 5.1

Remote Debug for Opera

如標題，Opera 這部份的功能與 Chrome 比較接近，但測試環境的準備比 Chrome 更方便，已經不需要類似 JDK、SDK 這些 Tools 了，請看以下的說明。

準備執行環境

二種裝置的環境分別如下，還需具備Wi-Fi環境：

PC

• Opera 12.02+

Mobile

• Opera for Mobile 12.1+

Get Random Word in the JCaptcha

這裡的JCaptcha指的是整合在Jasig CAS，相關設定可參考另一篇 JCaptcha integration with CAS 這裡的測試也會延續這一篇的設定。因有追查在某些裝置上驗證碼會無效的需求，需要 log 產生在登入頁的驗證碼及 User 輸入的驗證碼，以查出問題之所在，查詢 JCaptcha API 後發現沒有 interface 可取得已產出的驗證碼，同樣求神問卜後找到這一篇使用 JCaptcha 開發圖形和聲音驗證碼，因同時使用圖形及聲音驗證所以需要驗證碼一致，透過 override API 的方式來取得產出的驗證碼，主要是參考這一篇文章將取得驗證碼整合至 Jasig CAS 及 JCaptcha 以達到目的。

使用 JCaptcha 開發圖形和聲音驗證碼有提供 SourceCode ，會直接下載來整合進 Jasig CAS 和 JCaptcha，如果只是修改 package 則不再列出，build cas-server-core 也請參考另一篇的說明。

準備執行環境

Maven是為 build JCaptcha integration with CAS 做準備

• JDK (Java Development Kit) version 1.6+
• Apache Maven 2.2.1+
• Apache Tomcat 6+
• JA-SIG CAS 3.4.2.1+
• JCaptcha 1.0

下載 Sample

• 下載 SourceCode並解壓縮。

JCaptcha integration with CAS

說明Jasig CAS登入頁增加圖形驗證碼的功能，圖形驗證碼採用JCaptcha來實做，這部份參與的不多只有做一些小修改，因此大部份是同事的努力，這邊只是單純的詳實記錄下來，如同事有blogger也會提供相關連結以利參考。

CAS Server的相關設定請參考文章末的參考連結，這裡只著重在Jasig CAS跟JCaptcha的整合。

準備執行環境

Maven是為 build JCaptcha integration with CAS 做準備

• JDK (Java Development Kit) version 1.6+
• Apache Maven 2.2.1+
• Apache Tomcat 6+
• JA-SIG CAS 3.4.2.1+
• JCaptcha 1.0

下載JA-SIG CAS Server

• 下載CAS Server版本為3.4.2.1，並將下載檔案cas-server-3.4.3-release.zip解壓縮。

Remote Debug for Firefox

測試完 Remote Debug for Chrome 後接下來換成 Firefox，除了 Browser 換成 Firefox 外其餘環境皆與 Chrome 類似，因此重複的步驟將會帶過不再詳細說明，Firefox 測試後跟 Chrome 比較之下，Firefox 的 Remote Debug 功能主要是用設置中斷點的方式來追，沒有類似 Firebug 或 HttpFox 的功能，只能期待下一個版本有相關的功能。

準備執行環境

二種裝置的環境分別如下：

PC

• JDK (Java Development Kit) version 1.6+
• Android SDK r16+
• Mozilla Firefox 15+

Mobile

• Android 4.0+
• Firefox for Android 15+

Remote Debug for Chrome

需求為希望可以在手機上進行類似 FireFox Plugin HttpFox 的功能，求神問卜(Google大神)後找到Chrome有這部份的功能，接下來針對 Remote Debug for Chrome 進行說明。

準備執行環境

二種裝置的環境分別如下：

PC

• JDK (Java Development Kit) version 1.6+
• Android SDK r16+
• Google Chrome 22+

Mobile

• Android 4.0+
• Chrome for Android M18.1+

JA-SIG CAS Proxy Authentication Configuration

說明Jasig CAS Proxy的配置，及CAS Proxy Authentication的運作，CAS Server的相關設定這裡不做說明，只著重在Jasig CAS Proxy Configuration。

準備執行環境

只須配置CAS Client所以只要以下環境即可

• JDK (Java Development Kit) version 1.6+
• Apache Tomcat 6+
• JA-SIG CAS 3.4.2.1+

How can XDocReport (to PDF) supply the Chinese character

延續上一篇 XDocReport API 將 Word 套表轉換成 Word 或 PDF的說明，這裡將著重在轉 PDF  時中文的呈現，官網有針對此議題的討論 Issue 81:how can xdocreport supply the Chinese character.，但截至目前沒獲得解決，文章會針對 API 的修改及修改後的測試做說明，但不建議採用此修改建置系統，因時間有限修改是用 hard code 的方式沒有完整的 Interface，要採用還是以官網的版本為主。

官網有提供說明 XWPFDocument 2 PDF 時，採用 OS 的字型及編碼，但中文還是無法顯示。Sample 還是採用上一篇的 DocxProjectWithVelocity2PDF.java 執行步驟將不再重覆。此文章的標題是直接把 Issue 81 的標題拿來用。

MS Word Converter to Word/PDF by XDocReport API Getting Started

說明如何使用 XDocReport API 將 Word 套表轉換成 Word 或 PDF，看完首頁的說明及操作線上Demo可大致了解 API 的功能，測試的過程中 Word -> Word 後套表格式及中文目前的測試都正常，但Word -> PDF 英文沒問題、格式有些不正確而中文無法顯示，修改 API 後中文可獲得部份解決，格式的部份沒有細究還是有問題，後續會再詳細說明。

Microsoft Office

Document	Template	Converter
Docx	Freemarker		docxandfreemarker-0.9.8-sample.zip
Docx	Velocity		docxandvelocity-0.9.8-sample.zip
Docx	Velocity	PDF/XHTML	docxandvelocity.converters-0.9.8-sample.zip
PPTX	Velocity		pptxandvelocity-0.9.8-sample.zip

Open/Libre Office

ODP	Velocity		odpandvelocity-0.9.8-sample.zip
ODT	Velocity		odtandvelocity-0.9.8-sample.zip
ODT	Velocity	PDF/XHTML	odtandvelocity.converters-0.9.8-sample.zip

從上表可以看到不單單處理Word，套表還可接受PPTX、ODP、ODT的格式。


Handle各個格式的套件如下：

• Microsoft Word - Apache POI - HWPF
• XHTML - Apache POI - XWPF
• PDF - Lowagie iText
• Template Replace - Apache Velocity、FreeMarker

以上資料都可從XDocReport官網中查詢取得。

CreateLDAPUser by OpenDS Command Line

CreateLDAPUser by OpenDS Command Line

Implement the RESTful CAS API

說明Jasig CAS如何實作RESTful CAS API，讓Application可透過程式向CAS Server取得認證，但這部份的認證不具備Single Sign On的功能，只是單純的帳號/密碼認證。

準備執行環境

除了Maven外其他為測試時會用到的環境

• JDK (Java Development Kit) version 1.6+
• Apache Maven 2.2.1+
• Apache Tomcat 6+
• JA-SIG CAS 3.4.2.1+

下載CAS integration RESTful Library

• cas-server-integration-restlet-3.4.3.jar可在cas-server-3.4.3-release.zip解壓縮後的路徑cas-server-3.4.3\cas-server-integration-restlet下由maven build(mvn clean package -Dmaven.test.skip=true)取得，另外此路徑cas-server-3.4.3\modules下也可取得這個檔案，此測試由maven build取得。

下載RESTful API 相關 Library，以下jar可由maven.restlet.org取得

• com.noelios.restlet.ext.servlet-1.1.10.jar
• com.noelios.restlet.ext.spring-1.1.10.jar
• com.noelios.restlet-1.1.10.jar
• org.restlet.ext.spring-1.1.10.jar
• org.restlet-1.1.10.jar

取得Code Generation Library，可能版本有衝突直接download的無法使用

• net.sf.cglib.jar可在Restlet Framework下載restlet-jse-2.0.10.zip後解壓縮可在此restlet-jse-2.0.10\lib\net.sf.cglib_2.2路徑取得

將上述取得的.jar檔放到Tomcat6\webapps\cas\WEB-INF\lib，.jar檔有試圖使用其他版本但目前測試結果就這些版本可配置成功。

JA-SIG CAS for multi-tenant LDAP

說明Jasig CAS使用多個BaseDN或是不同的organizationalUnit，CAS Server的相關設定請參考其他文章，這裡只著重在Jasig CAS跟LDAP的配置。

準備執行環境

以下為測試時會用到的環境，但針對測試步驟不會一一說明

• JDK (Java Development Kit) version 1.6+
• OpenDS-2.2.1
• Apache Tomcat 6+
• JA-SIG CAS 3.4.2.1+

Google Mail Contacts Retrieve by Java

說明如何透過 Google Data API 取得 Gmail 的通訊錄，因需求只在通訊錄所以將重點放在通訊錄，以API的規格看來可以操作Gmail的空間應該是不少。

準備執行環境

官網文件上說明需準備以下環境及.jar檔，Servlet只有二個sample會用到，Ant是為 build samples 做準備

• JDK (Java Development Kit) version 1.5+
• Apache Ant version 1.7+
• mail.jar in Sun's JavaMail API 1.4+
• activation.jar in Sun's JavaBeansActivationFramework. This is only required for media specific APIs including Document List Data API, Picasa Web Album API, and YouTube Data API.
• servlet.jar in Sun's Servlet API version 2.3+. This is required only if executing code samples in 'sample.authsub' or 'sample.gbase.recipe' packages.

下載Google Data Client Library

• 下載Google Data Client Library的client library (gdata-src.java-1.x.x.java.zip) 和 samples file (gdata-samples.java-1.x.x.java.zip)，下載的版本為1.45.0，將二個zip file解壓縮。