リバースAjax機能はAjax＋Javaをもっとやさしくする？：MyEclipseでAjax＋Javaをやさしく開発（4）（2/4 ページ）

» 2007年06月11日 00時00分公開

[水島和憲，エクリプス]

DWR 2.0の便利なアノテーション

　リバースAjaxの具体的な解説に入る前に便利なDWRのアノテーションについて紹介します。

dwr.xmlが不要!?

　前回まで、DWRを使用するにはdwr.xmlが必須であると説明してきました。dwr.xmlはリモートのオブジェクトを生成するCreatorやサーバとブラウザで受け渡しするBeanのConverterをXML形式で定義するファイルです。DWR 2.0では、アノテーションを使用することによってdwr.xmlを作成しなくても済みます。

アノテーションを使用するために

　アノテーションを使用するためには、まずweb.xmlに次のようにclassesパラメータを指定します。パラメータの値には、アノテーションを使用しているフルクラス名を指定します。複数ある場合は、カンマで区切ります。

    <init-param>

                <param-name>classes</param-name>

                <param-value>

                    com.sample.chat.JsChat,

                    com.sample.chat.JavaChat

                </param-value>

            </init-param>

@RemoteProxy、@RemoteMethodアノテーション

　ブラウザのJavaScriptからリモートでアクセスさせるクラスには、@RemoteProxyアノテーションを指定します。

　次の例のように、scope属性を指定することもできます。name属性を指定すれば、ブラウザで参照するJavaScriptのオブジェクト名を指定することができます。デフォルトでは、クラス名がそのままJavaScriptのオブジェクト名になります。

　公開するメソッドには、@RemoteMethodアノテーションを付記します。デフォルトは非公開であるため、ブラウザからこのアノテーションが指定されていないメソッドは呼び出せません。

@RemoteProxy(scope=ScriptScope.APPLICATION)

        public class JsChat {

            @RemoteMethod

            public void addMessage(String nm, String txt) {

        

            }

        }

@DataTransferObject、@RemotePropertyアノテーション

　今回のチャットでは利用しませんでしたが、Converterに対応するアノテーションもあります。@DataTransferObjectがそれです。

　次の例は、DWRのドキュメントに掲載されている例で、クラスFooに@DataTransferObjectアノテーションを指定するだけで、ブラウザとサーバ間で受け渡しができるようになります。ただし、公開するプロパティには、@RemotePropertyアノテーションを付記する必要があります。

@DataTransferObject

        public class Foo {

        

            @RemoteProperty

            private int foo;

            public int getFoo() {

                return foo;

            }

        

            @RemoteProperty

            public int getBar() {

                return foo * 42;

            }

        }