任意形式のXMLリクエスト・レスポンスの送受信

０． 準備① すでにEclipse、WTP、Axis2の設定は完了していること。
「Eclipse + Axis2連携手順 及び簡易サービス作成手順 」参照
１． サーバ側プロジェクトの作成① ファイル -> 新規 -> プロジェクト -> Web -> 動的Webプロジェクト を選択する
② 構成の変更からプロジェクト・フィアセットを開き、以下の項目のみを有効にする
Axis2 Webアプリケーション
Java
動的Webモジュール
③ 任意のプロジェクト名を入力
④ 完了を押下
２． サーバ側プロジェクト初期設定① Eclipseのワークスペース \ 作成したプロジェクト\ WebContent \ WEB-INF \ lib ディレクトリに
Axis2を展開したディレクトリ\lib ディレクトリ配下のjarファイルをコピーする
② プロジェクトをリフレッシュ
③ Web.xmlを書き換える
org.apache.axis2.transport.http.AxisAdminServlet
↓
org.apache.axis2.webapp.AxisAdminServlet
３． サービスの作成① 以下のクラスを作成する

public class test {
    public OMElement echo( OMElement request ){ return request; }
}

echoメソッドは送信されてきたメッセージを、そのまま返却するものである
４． Webサービスの登録① 作成したクラスを右クリック -> Webサービス -> Webサービスの作成を実行
② デフォルトの設定で十分なので、なにも設定せずそのまま完了ボタンを押下
この作業でWSDLが作成される。
５． クライアントプロジェクトの作成① ファイル -> 新規 -> プロジェクト -> JAVA -> JAVAプロジェクト を選択
② 任意のプロジェクト名を入力
③ 完了を押下
６． クライアントプロジェクト初期設定① 作成したプロジェクトのプロパティを開く
② JAVAのビルド・パスを表示
③ 外部JARの追加を押下
④ Axis2を展開したディレクトリ \ lib 配下のJarをすべて追加
７． クライアントを作成① 以下のクラスを作成する
＃ 適宜編集してください

public class Client {
    static public void main (String[] args ) {
        {
        // エンドポイントURL
        // ～/services/以降がクラス名
        String endpointStr = "http://localhost:8080/サーバ側プロジェクト名/services/test/";
        ServiceClient sender = null;
        Options options = new Options();
        try {
            sender = new ServiceClient
        } catch(AxisFault e ){
            e.printStackTrace();
           return;
        }

        // オプションの設定
        // エンドポイントの設定
        options.setTo(new EndpointReference( endpointStr ) );

        // プロトコルの設定
        options.setTransportInProtocol( Constants.TRANSPORT_HTTP);

        // オプションを反映する
        sender.setOptions( options );//送信メッセージの作成
        OMFactory fac = OMAbstractFactory.getOMFactory( );

        // ネームスペースの生成
        OMNamespace omNs = fac.createOMNamespace("http://作成したサービスのパッケージ" , "Request" );

        // 要素の作成
        OMElement request =
            fac.createOMElement(
                "echo", // 実行するメソッド
                omNs);
        OMElement msg = fac.createOMElement("Msg", omNs);
        // テキストの追加
        msg.setText ( "Hello, World !!!" );

        // 要素の追加
        request.addChild( msg );
        try{
            // リクエストの送信、レスポンスの受信
            OMElement response = sender.sendReceive( request );

            // レスポンスをコンソールに表示
            System.out.println( "レスポンス : " + response.toString() );
        }catch(AxisFault e ){
            e.printStackTrace();
           return;
        }
    }
}

８． 通信の確認① サーバを起動する。
② クライアントを実行する。
③ コンソール上に以下の表示があれば完了です
＃ 以下の文は適宜改行しています。
本来は一行で表示されます。
レスポンス :
<echoresponse xmlns:ns="http://サービスパッケージ名">
<return>
<msg xmlns:request="http://サービスパッケージ名">
Hello, World !!!
</msg>
</return>
</echoresponse>

Apache Axis2 + Eclipse + WTP 導入手順

０． 準備

・ Eclipse 3.5
・ WTP
( http://mergedoc.sourceforge.jp/pleiades-redirect/3.4/pleiades_java.zip.html )
・ Axis2 1.5 Standard Binary Distribution
( http://ftp.kddilabs.jp/infosystems/apache/ws/axis2/1_5/axis2-1.5-bin.zip )
・ Tomcat6.0
( http://ftp.riken.jp/net/apache/tomcat/tomcat-6/v6.0.20/bin/apache-tomcat-6.0.20.exe )

上記ファイルをダウンロードする。

１． Eclipse 設定

① ウィンドウ -> 設定 -> Webサービス -> Axis2設定
[ Axis2 ランタイム ]タブの[ Axis2 ランタイム・ロケーション ]に
Axis2を展開したディレクトリを設定する。
② ウィンドウ -> 設定 -> Webサービス -> サーバとランタイム
[ Web サーバ・ランタイム ] を [ Apache Axis2 ]に設定する

２． プロジェクトの作成

① ファイル -> 新規 -> プロジェクト -> Web -> 動的Webプロジェクト を選択する
② 構成の変更からプロジェクト・フィアセットを開き、以下の項目のみを有効にする
Axis2 Webアプリケーション
Java
動的Webモジュール
③ 任意のプロジェクト名を入力
④ 完了を押下

３． プロジェクト初期設定

① Eclipseのワークスペース \ 作成したプロジェクト\ WebContent \ WEB-INF \ lib ディレクトリに
Axis2を展開したディレクトリ\lib ディレクトリ配下のjarファイルをコピーする。
② プロジェクトをリフレッシュ

③ Web.xmlを書き換える

org.apache.axis2.transport.http.AxisAdminServlet
↓
org.apache.axis2.webapp.AxisAdminServlet

４． サービスの作成

① 以下のクラスを作成する。

public class test{
        public String Hello () {
            return "Hello!";
        }
        public String Hello2 ( String name ) {
            return "Hello, " + name + "!";
        }
        public String[] Hellos () {
            String[]    helloArray  =   {   "Hello!"    ,
                                            "Hello!!"   ,
                                            "Hello!!!"
                                            };
            return    helloArray;
        }
    }

５． Webサービスの登録

① 作成したクラスを右クリック -> Webサービス -> Webサービスの作成を実行
② デフォルトの設定で十分なので、なにも設定せずそのまま完了ボタンを押下。

６． 通信の確認

① 以下のURLに接続する。
・http://localhost:8080/ プロジェクト名/services/test/Hello
[[期待応答]]

<ns:HelloResponse xmlns:ns="http://ws.apache.org/axis2">
        <ns:return>Hello!</ns:return>
    </ns:HelloResponse>

・http://localhost:8080/ プロジェクト名/services/test/Hello2?name=Bob
[[期待応答]]

<ns:Hello2Response xmlns:ns="http://ws.apache.org/axis2">
        <ns:return>Hello, Bob!</ns:return>
    </ns:Hello2Response>

・http://localhost:8080/ プロジェクト名/services/test/Hellos
[[期待応答]]

<ns:HellosResponse xmlns:ns="http://ws.apache.org/axis2">
        <ns:return>Hello!</ns:return>
        <ns:return>Hello!!</ns:return>
        <ns:return>Hello!!!</ns:return>
    </ns:HellosResponse>

＊期待応答はすべてRESTの応答である