[Java][Flex]BlazeDSでFlexとJavaを通信させる必要最低限の設定

タイトル通りBlazeDSでFlexとJavaを通信させる最小限の設定（だと思う）

～Java側の設定～
①まず、AdobeのBlazeDSのページからライブラリをダウンロード

②これを展開し、以下の4つをjavaのWEB-INF/libにつっこむ
・backport-util-concurrent.jar
・flex-messaging-common.jar
・flex-messaging-core.jar
・flex-messaging-remoting.jar

③Blaze用の設定ファイルをWEB-INF/flex/services-config.xmlに作成
メモ：flexっていうフォルダは自分で作る！！

説明のため、hogeパッケージのFooクラスにflexからアクセスする為のメソッドを起き、
名前を、hogehogeと名づけ、http://www.example.com/BlazeTest/
でアクセスすると仮定すると、(blazeTestはTomcatで設定)

内容は、
<?xml version="1.0" encoding="UTF-8"?> <services-config> <services> <!-- service要素には何でもいいからIDが要る模様 --> <service id="remoting-service" class="flex.messaging.services.RemotingService"> <adapters> <adapter-definition id="java-object" class="flex.messaging.services.remoting.adapters.JavaAdapter" default="true"/> </adapters> <default-channels> <channel ref="my-amf"/> </default-channels> <!-- destination要素のIDが mx:RemoteObjectの destination プロパティに対応する --> <destination id="hogehoge"> <properties> <!-- リモート呼び出ししたいメソッドを持つJava Beansのクラス名 --> <source>hoge.Foo</source> <!-- 注：この Beanはステートレスである --> </properties> </destination> <!-- リモート呼び出しを可能にしたい Beanの数だけ destination要素を記述する --> </service> </services> <channels> <channel-definition id="my-amf" class="mx.messaging.channels.AMFChannel"> <!-- ここで構成されたエンドポイントURLを mx:RemoteObjectの endpoint プロパティにセットする {}内は実行時に自動で置き換えられるのでこの記述のままで良い。 --> <endpoint url="http://{server.name}:{server.port}/{context.root}/messagebroker/amf" class="flex.messaging.endpoints.AMFEndpoint"/> </channel-definition> </channels> </services-config>

ここで重要なのは15行目と19行目だけ

15行目のは、flex側の設定で出てくる。
19行目のは、flexから呼ばれるJavaクラスを登録する。Java Beansって書いてあるけど、呼び出したいメソッドのJavaクラスのことだと思う。HttpServletを継承する必要はない。
引数、戻り値に使うJavaBeansはここで登録しなくてもいけた。


④実際に呼びだされるJavaクラスの作成。
先ほど登録したクラスを作成。
引数、戻り値がある場合は、flex側とjava側の両方に全く同じフィールドとそのgetter,setterメソッドしか持たないBeanクラスを作る必要がある。Java側はフツーのJavaBeansで良い。ちなみに戻り値に使うクラスはSerializableをimplementsしていなければならない。

説明のため、barメソッドを呼び出すとする
package hoge; public class Foo { public String bar() { 　　　　　・ 　　　　　・ 　　　　　・ } 　　　・ 　　　・ }


⑤④の設定ファイルを読み込むようにweb.xmlに追加
WEB-INF/web.xmlに以下の内容を追加する。
<listener> <listener-class>flex.messaging.HttpFlexSession</listener-class> </listener> <servlet> <servlet-name>MessageBrokerServlet</servlet-name> <servlet-class>flex.messaging.MessageBrokerServlet</servlet-class> <init-param> <param-name>services.configuration.file</param-name> <param-value>/WEB-INF/flex/services-config.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>MessageBrokerServlet</servlet-name> <url-pattern>/messagebroker/*</url-pattern> </servlet-mapping>



～Flex側での設定～
①mxmlにdestinationを指定
mxml内にremoteObjectを書く
<mx:RemoteObject id="srv" destination="hogehoge"　endpoint="http://www.example.com/blazeTest/messagebroker/amf" />
ここでlocalhost:8080は自分の環境に合わせて変更し、destinationはJava側で設定した↑の15行目の文字列が入る。

②通信開始を呼ぶメソッドを書く
ASのfunction内でもmxmlのclickとかchangeでもいいけど、そこで
srv.bar()と書けば通信してくれる。引数がある場合はもちろんここにいれる。
戻り値は、srv.bar.lastResultで取得できるが、この通信は非同期で行われるので、ASのfuncrion内でこのメソッドを呼んでも、通信が終わる前に次の行が処理されてしまうので注意。

受信が完了した時に、barResultというfunctionを呼んで処理をしたい場合は、①のRemoteObjectを以下のように変更する。
<mx:RemoteObject id="srv" destination="hogehoge"　endpoint="http://www.example.com/blazeTest/messagebroker/amf"> <mx:method name="bar" result="barResult(event.result)" /> </mx:RemoteObject>
nameには、java側の呼び出すメソッド名、resultには、受信後にflex側で呼び出すfunctionを指定してやる。

③Flex側でもBeansを作成
通信で扱う変数は、Beanに格納しなければならない。（ただし、戻り値のStringの場合は必要ない）
また、FlexとJava側で作成したBeansを関連関連付けるため、AS側のBeanクラスのpublic classの前の行に
[RemoteClass(alias="hoge.FooBeans")]などとJavaBeansのパッケージ名を含んでクラスを教えてあげなければならない。
戻り値に使う場合はもちろん[Bindable]も必要




たぶん、これでいくはず


＜参考＞
Adobe - Developer Center
Adobe BlazeDSを自分のWebアプリケーションに組み込む設定