WSO2 ESB - VFS transport範例練習遭遇問題及處理

"Transport"，是WSO2 ESB中一種很有用的功能，不同的transport類型，用來接收、傳送各種的訊息(message)。

目前，WSO2 ESB底層中的WSO2 Carbon，支援底下種類的transport：
	HTTP	HTTPS
	HTTP-NIO	HTTPS-NIO
	Mail	JMS
	VFS	TCP
	Local	UDP
	FIX

利用這些transport，搭配各種Transfrom mediators，就能將不同協定、標準、格式的應用程式，所傳來的各種訊息進行轉換、轉傳，達到ESB的功能。

範例參考網址：http://wso2.org/library/tutorials/2011/01/sftp-file-transer-wso2-esb

這個範例演示了一個簡單的動作，利用VSFTP，將一個XML檔從一個目錄取回ESB，再由ESB寫到另一個目錄。

版本及平台：
１、版本及平台，同“將WSO2 ESB 4.0.2佈署到JBoss 5.1GA"中的“範例環境及代號說明”
２、SFTP登入帳號/密碼：ftpuser / wso2
３、in, out, original目錄所在位置：/home/ftpuser/vsftp/

遭遇問題及注意事項：
１、雖然在Apache Commons上，
　　http://commons.apache.org/vfs/filesystems.html
　　有寫道SFTP的VFS語法為
　　sftp://[ username[: password]@] hostname[: port][ absolute-path]

　　不過，真正在測試時，似乎是“相對路徑”，而非“絕對路徑”。
　　所以，後來將範例內容改為：

<proxy xmlns="http://ws.apache.org/ns/synapse" name="SFTPVFSProxy" transports="vfs" statistics="disable" trace="enable" startOnLoad="true">
<target>
<inSequence>
<log level="full" />
<property name="File" expression="fn:concat('test-', get-property('transport', 'FILE_PATH'))" scope="default" />
<property name="transport.vfs.ReplyFileName" expression="fn:concat(fn:substring-after(get-property('MessageID'), 'urn:uuid:'), '.xml')" scope="transport" />
<property name="OUT_ONLY" value="true" />
<send>
<endpoint>
<address uri="vfs:sftp://ftpuser:wso2@192.168.10.1/vsftp/out" />
</endpoint>
</send>
</inSequence>
</target>
<parameter name="transport.PollInterval">15</parameter>
<parameter name="transport.vfs.FileURI">vfs:sftp://ftpuser:wso2@192.168.10.1/vsftp/in</parameter>
<parameter name="transport.vfs.MoveAfterProcess">vfs:sftp://ftpuser:wso2@192.168.10.1/vsftp/out</parameter>
<parameter name="transport.vfs.ActionAfterProces">MOVE</parameter>
<parameter name="transport.vfs.MoveAfterFailure">vfs:sftp://ftpuser:wso2@192.168.10.1/vsftp/original</parameter>
<parameter name="transport.vfs.FileNamePattern">.*.xml</parameter>
<parameter name="transport.vfs.ContentType">application/xml</parameter>
<parameter name="transport.vfs.ActionAfterFailure">MOVE</parameter>
<parameter name="serviceType">proxy</parameter>
</proxy>

　　可以注意到，在sftp的hostname後面，並非
　　/home/ftpuser/vsftp/in
　　/home/ftpuser/vsftp/out
　　/home/ftpuser/vsftp/original
　　而是，
　　/vsftp/in
　　/vsftp/out
　　/vsftp/original

　　另外，FileURI只給目錄位置，而沒有連同檔名一併標入，即
　　<parameter
　　name="transport.vfs.FileURI">vfs:sftp://ftpuser:wso2@192.168.10.1/vsftp/in
　　</parameter>
　　而非
　　<parameter
　　name="transport.vfs.FileURI">vfs:sftp://ftpuser:wso2@192.168.10.1/vsftp/in/test.xml
　　</parameter>
　　否則，ESB會將/vsftp/in/test.xml檔成一個目錄，如下錯誤：
　　