Apache Axis2

メモ：Axis2でJSR181アノテーション

est2006 — Wed, 7 Nov 2007 20:58:45 +0900

Using JSR181 annotations with Axis2

Axis2でのJSR181アノテーションについて簡単に紹介されてます。
よい機能なのにドキュメンテーションがないということでJIRAにも登録したとのこと。

このブログを読んで初めて知ったのは、axis2.xmlに以下のようなエントリがあるということ。

Axis2のレポジトリの下にdirectoryで指定されているディレクトリ(この例では'pojo')を作成して、そこに @WebService や @WebMethod で注釈付けしてコンパイルしたクラスファイルを置くのである、とのこと。

早速試してみようとAxis2 1.3をダウンロードしてきました。
そのほかの環境はJDK5.0とTomcat5.0.28。

まずwebapps/axis2/WEB-INF/pojoディレクトリを作成。
次に以下のコードをコンパイルしてクラスファイルをpojoディレクトリにおいてTomcat起動。

// AnnoTestService.java
import javax.jws.WebService;
import javax.jws.WebMethod;

@WebService
public class AnnoTestService {
@WebMethod
public String sayHello(String yourName) {
return "Hello, " + yourName + ".";
}
}

ブラウザからサービス一覧を参照すると
AnnoTestServiceService.AnnoTestServicePort
というサービスが見えます。WSDLも参照できました。

このサービスをRESTで起動してみます。
http://localhost:8080/axis2/services/
AnnoTestServiceService.AnnoTestServicePort/
sayHello?yourName=est2006
確かに動作してます。
WEBサービスのレスポンスが返ってくるのを確認できました。

Hello, est2006.

今までサービスを作成するのにservices.xmlを用意し.aarにパッケージしてと手間が掛かってましたが、この方法だと本当にPOJOをコンパイルしてデプロイするだけです。

これは確かにきちんとドキュメンテーションされるべきかなと思いました。
Axis2ユーザー皆に伝えないともったいないと感じました。

駅すぱあとのWEBサービスをAxis2で

est2006 — Sat, 28 Jul 2007 2:24:49 +0900

RailGo Webサービスと Apache Axis2 を試す

Axis2のサンプルにもパブリックなWEBサービスを呼び出すものがありますが、
駅すぱあとのWEBサービスRailGoをAxis2で利用するサンプルをあげておられます。
Axis2は1.2を使っている模様。

RailGoは、.NETで構築されているようで、クライアントとしては.NETアプリか
Office2003を使うようにと但し書きがついてますが、Axis2から呼び出せてますね。

私はAxis2でサービスを用意して、それをいろんなクライアントから利用できるか？
という方向ばかり追求してきてましたが、この方はクライアントにAxis2を使っての、
Java以外のWEBサービスの利用を実証されてます。

呼び出すことに問題はないが、Axis2のjarの依存関係の多さに参っておられる様子。
確かに。。。
私は、Tomcatに丸ごとデプロイしてるので気にしたことがありませんでした。

参考にしていただいてるようなので、こちらからもリンク貼らせていただきます。

Axis2 1.3 RC中

est2006 — Thu, 19 Jul 2007 1:27:54 +0900

Axis2 1.3 のRCがリリースされてました。
が乗り遅れたので最新のSNAPSHOTをダウンロードしてきてみました。

●AARファイルの互換性

　Axis2 1.2 の頃に評価用に作成しておいた .aar をそのまま
　deployしてみましたが、特に問題なく動くようです。

●REST呼び出しの変更点

　1.2の時と違うのがREST呼び出しの時のURL。
　1.2の時は、
　　http://localhost:8080/axis2/rest/Version/getVersion
　てな感じでしたが、
　今のスナップショットでは、
　　http://localhost:8080/axis2/services/Version/getVersion
　となるようです。

●POJOサービスのレスポンスの違い

　1.2ではレスポンスのタグ全てにネームスペースが入っておりましたが、
　1.3ではPREFIXのみがセットされるようになったようです。
　これは項目の多いレスポンス等の時に、XML自体のサイズが小さくなってよいなと思います。

　また以下で赤で示したような「type=Bean名」という記述が追加になっています。

1.2でのレスポンス例

xyz
123
99999
123.456
4.0
789
true

xyzxyz
246
199998
246.912
8.0
789
true

1.3でのレスポンス例

xyz
123
99999
123.456
4.0
789
true

xyzxyz
246
199998
246.912
8.0
789
true

Axis2 1.2 リリース

est2006 — Sat, 28 Apr 2007 2:03:43 +0900

Axis2 1.2 がリリースされました。

メーリングリストでのリリースアナウンスで紹介されていたのは以下になります。

◆Axis2 1.1 から Axis2 1.2 での主な変更点:
　-　WSDL 2.0 fully support (reading, writing, and codegen)
　-　POJO annotation (JSR 181)
　-　JAX-WS integration
　-　JAX-WS -annotation
　-　Un-wrapping (Response)
　-　ADB - support for union and list
　-　Maven2 support
　-　JSON support
　-　Binary serialization (Fast infoste)
　-　Codegen support for WSDL with Multiple services
　-　HTTP code generation (both WSDL 1.1 and 2.0)
　-　Custom deployer support
　-　Message formatters
　-　Message Builders
　-　EJB Provider support

◆Axis2 1.2 の既知の問題と制限:
　-　Xml-beans databinding does not support response uwwrapping
　-　ADB databinding does not support minOccurs and maxOccures
　　　attributes in sequence and choice elements

私はまだ評価できてないのですが、今回の目玉は
やはり　POJO annotation　でしょうね。
じっくり評価する時間が欲しいです。

ダウンロードはこちらから。

Axis2 1.2 RC2 リリース

est2006 — Wed, 4 Apr 2007 0:33:16 +0900

Axis2 1.2 RC2がリリースされました。
問題がなければ、正式リリースは4/6を予定しているようです。

今回は、前回のようにすぐBugFix版の1.2.1が出るようなことが
なければよいなと思ってます。

Axis2 1.2 RC1 リリース

est2006 — Tue, 27 Mar 2007 0:06:58 +0900

Axis2 1.2 の RC1 がリリースされました。
ダウンロードはこちらから。
正式版のリリースは2007/4/6を予定しているようです。

このリリースに含まれるのは以下の機能となります。
　- WSDL 2.0 fully support(Reading, writing and codegen)
　- POJO - annotation
　- JAX-WS - integration
　- JAX-WS - annotation
　- Un-wrapping (Response)
　- ADB - missing schema support
　- Maven2 support
　- JASON support
　- Binary serialization
　- Multiple services support in code gen
　- HTTP code generation (both WSDL 1.1 and 2.0)
　- Fix/update helper mode
　- Custom deployers support
　- Message formatters
　- Message Builders

報告されていたJIRAの課題も数多く解決しているとのことです。
以上メーリングリストより。

私もBinaryディストリビューションのaxis2-1.2-RC1.zipを
早速ダウンロードしてaxis2.warを作ってTomcat5.0.28に
デプロイしてみました。
まだValidateページをチェックしたのと、versionサービスを
チェックしたくらいですが、とりあえず評価を始められそうです。

Tomcat 6 にデプロイすると、サービス一覧を参照するときに
HTTP error 500 が出るらしいので要注意のようです。
この件はAXIS2-2393としてJIRAに登録済みのようです。

メモ：Axis2 and Spring

est2006 — Sat, 10 Mar 2007 1:46:39 +0900

Expose Your POJO-Based Domain Apps as Web Services

Axis2とSpringでのPOJOを組み合わせたWebサービス実現の記事です。
Axis2のメーリングリストでリンクが紹介されてました。

次期バージョン Axis2 1.2 のリリース予定

est2006 — Sat, 24 Feb 2007 21:49:16 +0900

Axis2 1.2のリリースですが、メーリングリストによると
3月末を目標に作業が進められているようです。
ただ残件が多くあるようで楽観はできないと思われます。

このリリースでの実現内容として、
JAX-WS と POJO Annotation のサポートがあげられています。

これは例えば、以下のようなクラスを作って
.classファイルをデプロイすることで Webサービスとする
ことになるようです。

@WebService
public class TestServiceClass {
@WebMethod
public String sayHello(String yourName) {
return "Hello, " + yourName + ".";
}
}

今はサービスにするために、services.xmlを作ったり、
.aarにまとめないといけなかったりと手間がかかりますが、
これでAxis2でのWebサービス構築が更にお手軽にできます。

このあたりはまた nightly builds で評価していきたいところです。

メモ：Java Web サービス記事

est2006 — Thu, 15 Feb 2007 0:56:31 +0900

Java Webサービス第1回: Java Webサービス、来るべき一年

この記事の英文オリジナルはこちらになってます。
更に英文では、Part2のDigging into Axis2: AXIOMもあります。
著者はAxis2コミッターのお一人です。

もう1年前の記事なのですが、Axis2関連は情報も少ないので
リファレンスとしてメモしておきます。

メモ：SOAPってそうなんですか

est2006 — Fri, 9 Feb 2007 1:03:55 +0900

S はシンプルの S

英語のblogの記事を和訳しておられます。
原文へのリンクも上記のページにあります。

SOAPの標準であるとか相互運用性について等を調べていると
いろんな疑問にぶつかります。

そんなもやもやに明かりをともしてくれます。

メモ：Axis2ベンチマーク(2007/1時点) その２

est2006 — Thu, 8 Feb 2007 1:49:43 +0900

もうひとつのベンチマーク

同じく、Apache Axis2 1.1.1 と Codehaus XFire 1.2.4 を使って、
Java実装でのWebサービスのパフォーマンステストをしています。

データバインディングは、XFire/JiBX、Axis2/JiBX、Axis2/ADBを評価しており、
今回はJiBXベースならどうなんだという比較になっています。

XFire/JAXBとAxis2/ADBを比較したテスト結果に対して、
「公平を期してXFireにも最速のデータバインディングを適用するというなら、
　Axis2/ADBに対してXFire/JiBXでテストすべきだ。」
という物言いがついたようで、それへの回答というのがこのテストの動機のようです。

結果は、良い勝負をしていると言えると私は思います。

メモ：Axis2ベンチマーク(2007/1時点)

est2006 — Fri, 2 Feb 2007 23:13:09 +0900

Web Services are Not Slow

Apache Axis2 1.1.1 と Codehaus XFire 1.2.4 を使って、
Java実装でのWebサービスのパフォーマンステストをしています。

データバインディング手法をADB、JAXBと変えてAxis2とXFireを比較したとのこと。

結果としては、Axis2/ADB > XFire/JAXB > Axis2/JAXB であったようです。
Axis2/ADBのパフォーマンスが良かった点と、Axis2/JAXBのパフォーマンスが
XFire/JAXBに及ばなかった点がグラフを交えて報告されています。

評価環境はサーバーが、Xeon 3.2Ghz x4CPU 2GBメモリのFedora Core 5に、
JDK 1.5.0_10-b03とTomcat5.5.20をのせたもの。
クライアントはWindows2003 Server EE 上で Apache Bench を利用したとのこと。

Axis2 1.1.1 リリース

est2006 — Wed, 10 Jan 2007 23:42:37 +0900

メンテナンスリリース版の1.1.1が正式リリースされました。
パフォーマンス改善とバグフィックスがなされているとのこと。

メーリングリストでは次のようにアナウンスされてました。

WS-Security/Secure-Conversation (Apache Rampart), WS-Trust (Apache Rahas), WS-Reliable Messaging (Apache Sandesha2)
をサポートするmoduleは既に利用可能です。

WS-Eventing (Apache Savan), WS-Transactions (Apache Kandula2)
をサポートするmoduleはAxis2 1.1.1のリリースのすぐ後に利用できる
ようになるでしょう。

これはもう次の1.2リリースを指しての事だと思われます。
JSR 181/183アノテーションのサポートも1.2で入るようですので、
Axis2は次の1.2でまた大きな機能追加がなされてくることになりそうです。

Axis2 1.1.1-RC1

est2006 — Sat, 23 Dec 2006 1:26:14 +0900

Axis2のメンテナンスリリースの1.1.1のRC1が出されました。

ダウンロードは http://people.apache.org/~thilina/axis2/1.1.1-RC1/ から。

1.1のリリースが11月13日でしたが、それ以降のBugを修正してのリリースです。
開発者メーリングリストでは、リリースをもう少し早いサイクル（３～４ヶ月に1リリース）で
やりましょう、という意見もやり取りされてるようです。
まだBugの多い現時点ではこれくらいのペースでリリース版が出るのがよいと思われます。

私はaxis2-1.1.1-RC1.zipをダウンロードしてきて、INSTALL.txtに従って
ant create.war で war を作成してから、Tomcat5にデプロイして試してみてます。

とりあえず問題なく動作してます。

Axis2 1.1 リリース

est2006 — Wed, 15 Nov 2006 0:05:09 +0900

Axis2 1.1 の正式リリースが11/13になされました。

公式のHPも模様替えされてます。
今年の5月に1.0がリリースされてからですから、
6ヶ月かかっての1.1ということでプロジェクトチームも
さぞや苦労したことだと思います。

私はいつものように war をダウンロードして、
軽く一通り動作確認してみましたが問題なさそうです。
・Validateページ
・Adminページ
・Servicesページ
・VersionサービスのWSDL表示とRESTで呼び出し
・SOAPMonitorの動作確認
・JavaBeansを返すPOJO WEBサービスの確認

WSDL2JAVAとかコマンドツール系のソースコード生成と実行を試してみて
ないんですが、それらは今後ということで。

1.1リリースに向けてドキュメンテーションもかなり
メンテナンス及び追加されたようなのでこちらも参考にできそうです。
面白そうなのは、
- POJO Guide
- Spring Guide
あたりですかね。

Axis2チームの皆様、お疲れ様でした。引き続き頑張ってください。