WebServices - AxisAxis インストール方法目次
はじめにこのドキュメントでは Apache Axis のインストール方法を解説します。Java コードの書き方を既に知っていて、XML を恐れない人を?qū)澫螭趣筏皮い蓼?。また、既にアプリケーションサーバかサーブレットエンジンを持っていて、その操作と配備に慣れている人を?qū)澫螭趣筏皮い蓼埂￥猡伐ⅴ抓辚暴`ションサーバが必要であれば、Jakarta Tomcat [英語] をお勧めします。[ もし Tomcat をインストールするのであれば、最新の 4.1.x 版で、かつ、Java 1.4 対応の LE 版ではなく(LE 版は XML パーサである Xerces を省略するので)、完全版を取得してください ]。その他のサーブレットエンジンも、バージョン 2.2 以上のサーブレット API を?qū)g裝しているのであれば対応しています。Axis クライアントと Axis サーバは Java 1.3 以降を必要としていることに注意してください。 Axis に関する詳しい情報はユーザガイドをご覧下さい。 事前知識Java 、サーバサイド Java 、SOAPに初めて觸れる人たちの多くは、Axis の様々な問題に直面しています。 Axis クライアントと Axis サーバのコードを書いていけば SOAP について學(xué)ぶことはできますが、配列とは何か、といった Java の基本概念、サーブレットがどのようにして動くのか、といったアプリケーションサーバの基本概念、そして HTTP プロトコルの基本を?qū)Wぶにはふさわしい時機(jī)ではありません。 Web サービスのコードを書くのに必要な事前知識は以下の通りです :
Axis と SOAP はこれらの詳細(xì)に依存しています。もしこれらを知らないのであれば、Axis (あるいはその他のWebサービスミドルウェア)は學(xué)ぶには危険な場所です。遅かれ早かれこれらの詳細(xì)を知る必要性がでてきます。Axis よりも學(xué)びやすい場所があります。 もし Java を全く知らないのであれば、Axis に取り組めるほどの十分な基礎(chǔ)を身に付けるために、Sun のウェブサイトにある The Java Tutorial のようなところか、Thinking in Java [英語] のような古典から始めるのをお勧めします。簡単なWebアプリケーションを作ってみるのも良いかもしれません。これにより HTTP がどのようにして動いているのか、 Java アプリケーションサーバがどのようにして HTTP と統(tǒng)合しているのかといった知識を身につけることができます。この點(diǎn)については Mastering the World Wide Web [英語] にある講義ノートが(Axis は講義28でのみ紹介されているにも関わらず)參考になるでしょう。 Axis と SOAP を効果的に使うには上記で挙げたもの以上に學(xué)ぶべきことがあることに注意しましょう。その他の大きな領(lǐng)域としては "インターネット規(guī)模の分散アプリケーションを作る方法" があります?，F(xiàn)在のところ誰もその方法を知らないので、実際に自分でやってみて知識を得る必要があります。 ステップ 0: 概念Apache Axis はオープンソースの SOAP サーバとSOAP クライアントです。SOAP はインターネットを通した、任意の言語で書かれたシステム間の相互アプリケーション通信のための機(jī)構(gòu)です。SOAP は一般的に HTTP 上でメッセージを交換します : クライアントが SOAP リクエストを POST で送り、HTTP サクセスコードと SOAP レスポンス、あるいは HTTP エラーコードのいずれかを受け取ります。オープンソースとは、ソースを得ることができるが問題に直面したときに助けてくれる正式なサポート機(jī)関がないことを意味します。 SOAP メッセージは XML メッセージです。これらのメッセージにより SOAP システム間で構(gòu)造化情報を交換します。メッセージはエンベロープの中の1つ以上の SOAP 要素から構(gòu)成されています。SOAP 要素とはヘッダとSOAP 本體です。これら要素中のデータを表現(xiàn)するのに SOAP は2つの文法を持っています。1つ目は5節(jié)で扱う XML RPC システムの明快な派生物です。2つ目は新しい(そして一般的に優(yōu)れている)システムである XML スキーマです。Axis は Java オブジェクトをネットワークに送るときと結(jié)果を受け取るときに、Java オブジェクトを SOAP データに変換する機(jī)構(gòu)を持っています。何か問題が起きると、サーバは SOAP フォルトを送り、Axis はそれを Java の例外に変換します。 SOAP は異なるシステムを連攜させることを目的としています。同じチームによって書かれた Java プログラムを密に連攜させるための機(jī)構(gòu)ではありません。SOAP は Java プログラム同士を連攜させることができますが、RMI や Corba ほど密には連攜できません。RMI なら喜んで直列化していた Java オブジェクトを送ろうとすると、Axis は失敗し、あなたは失望するでしょう。意図的にこのようにしています : もし Axis が RMI を真似て Java オブジェクトをバイトストリームに直列化したら、あらゆるところにおいて Java の特定バージョンに依存することになります。 Axis は、 Java サービスをプログラミングする上で標(biāo)準(zhǔn)的な方法の一つである JAX-RPC API を?qū)g裝しています。Sun のウェブサイトにある仕様書やチュートリアルを見れば API を理解できます。JAX-RPC API に従ってコードを書けば、Sun や BEA の実裝のような、JAX-RPC API の他の実裝と連攜できます。さらに、Axis は JAX-RPC API をさまざまに拡張する拡張性を提供します。これにより、よりよいプログラムを書くことができますが、Axis の実裝とだけしか連攜できません。しかし Axis は無料でかつソースを取得できるので、問題にはならないでしょう。 Axis は JAR ファイル axis.jar にコンパイルされていて、JAR ファイル jaxrpc.jar と saaj.jar に宣言されている JAX-RPC API を?qū)g裝しています。axis.jar はロギング、WSDL プロセッシング、イントロスペクションのための多様なヘルパーライブラリを必要としています。これらの全てのファイルはWebアプリケーション axis.war にパッケージ化し、サーブレットコンテナに配備することができます。Axis にはいくつかのSOAP サービスのサンプルがついてきます。新しくコンパイルしたクラスを Axis の webapp に追加して登録すれば、自分用の SOAP サービスを追加することができます。 その前に、Axis をインストールして動かさなくてはいけません。 ステップ 1: webapp を準(zhǔn)備するここでは、ウェブサーバが localhost のポート 8080 で起動していていることを仮定します。もしお使いのサーバが違うポートで起動しているのであれば、このドキュメントの 8080 をあなたのポート番號に読み替えてください。 お使いのアプリケーションサーバのどのディレクトリにWebアプリケーション("webapps")を配備すればいいのか、調(diào)べておく必要があります。このディレクトリに、ダウンロードした xml-axis の中の webapps/axis ディレクトリをコピーします。このディレクトリに好きな名前を付けることができますが、その名前が、クライアントがアクセスするサービスの URL の基礎(chǔ)となることに注意してください。このドキュメントの殘りの部分ではデフォルトの webapp 名を "axis" と仮定しますので、もし必要であれば適切に読み替えてください。 ステップ 2: ライブラリの設(shè)定Axis のディレクトリ中に WEB-INF というサブディレクトリがあります。このディレクトリにはいくつかの基本的な設(shè)定情報が入っていますが、あなたが配備したい依存関係やWebサービスを入れる際にも使います。 Axis は XML パーサを探し出せる必要があります。もしアプリケーションサーバか Java ランタイムが、ウェブアプリケーションから XML パーサを見えないようにしているのであれば、XML パーサをダウンロードしてウェブアプリケーションに追加する必要があります。Java 1.4 は Crimson パーサを含んでいるのでこの段階を省略することができますが、Axis チームは Xerces を使うことをお勧めします。 XML パーサを追加するには、JAXP 1.1 XML 準(zhǔn)拠のお好みのパーサを手に入れてください。他のパーサでもほとんど動きますが、xml-xerces distribution [英語] にある Xerces のjar 一式 をお勧めします。お使いの JRE やアプリケーションサーバに獨(dú)自の特定要件がない限り、パーサのライブラリを axis/WEB-INF/lib に入れてください。このドキュメントの例では Xerces を使います。このドキュメントでは Axis からパーサが見えるように AXISCLASSPATH に xml-apis.jar と xercesImpl.jar を追加しています (下をご覧下さい) もし Xerces や DOM に関する ClassNotFound エラーが出るのであれば、XML パーサがインストールされていないか CLASSPATH (あるいは AXISCLASSPATH) が正しく設(shè)定されていません。 Tomcat 4.x と Java 1.4Java 1.4 で java.* と javax.* から始まるパッケージのロード方法のルールが変わりました。具體的に言うと、それらのパッケージは endorsed ディレクトリからのみロードされます。 jaxrpc.jar と saaj.jar は javax パッケージを含んでいるので、それらはロードされません。もし happyaxis.jsp (下をご覧下さい) から該當(dāng)するパッケージが見えない場合、それらを axis/WEB-INF/lib から CATALINA_HOME/common/lib にコピーし、Tomcat を再起動してください。 WebLogic 8.1WebLogic 8.1 には webservices.jar が含まれていますが、これは Axis の saaj.jar と衝突し、Axis 1.2 をそのまま使うことができなくなります。この衝突が起こる理由は、WebLogic が Java Web Services Developer Pack [英語] Version 1.0 の javax.xml.soap.* パッケージにある古い定義を利用する一方、Axis は J2EE 1.4 の新しい改訂版を利用するからです。 しかしながら、Axis 基盤のWebサービスを Weblogic 8.1 で実行することを可能にする2つの設(shè)定変更があります。
WebLogic のクラスローダの仕組みの詳細(xì)については、WebLogic Server Application Classloading [英語] をご覧下さい。 ステップ 3: ウェブサーバの起動方法ウェブサーバの起動方法は製品ごとに異なります。たいていの場合、単純にスタートアップアイコンをダブルクリックするか、コマンドラインからコマンドを起動するだけです。 ステップ 4: インストールを確認(rèn)するWebアプリケーションと依存関係をインストールしたら、サーバがWebアプリケーションを起動しているか確認(rèn)しましょう。 スタートページを探すwebapp のスタートページを見てみましょう。たいていの場合、http://127.0.0.1:8080/axis/ ですが、もちろんポート番號によって変わります。 これで Apache-Axis のスタートページが見えるはずです。もしスタートページが見えないのであれば、webapp が実際にはインストールされていない、あるいはアプリケーションサーバが起動していません。 happyaxis によって Axis を確認(rèn)するリンク Validate the local installation‘s configuration をたどってください。 もし必須ライブラリのうち一つでも足りなければ、Axis は動きません。 いくつかのサービスを見てみるスタートページで View the list of deployed Web services を選んでください。ここでは、サーブレットで表示しないように設(shè)定されていない限り、登録されたWebサービスを全て表示します。このページにある、配備されたそれぞれのWebサービスの (wsdl) をクリックすることで、そのWebサービスが立ち上がっていて動いているか確認(rèn)することができます。 Axis がサポートしている ‘インスタント‘ JWS Webサービスは、ここへ表示されないことに注意してください。このトピックに関してはインストールガイドで詳しく取り扱っています。 SOAP エンドポイントをテストするそろそろサービスをテストしてもいい頃でしょう。SOAP 1.1 はエンドポイントに XML リクエストを出す際に HTTP POST を使いますが、Axis はテストに便利な生の HTTP GET アクセス機(jī)構(gòu)もサポートしています。まずは getVersion メソッドを呼んでバージョンエンドポイントから Axis のバージョンを取得してみましょう : http://localhost:8080/axis/services/Version?method=getVersion 次のようなものを返すでしょう : <?xml version="1.0" encoding="UTF-8" ?> <soapenv:Envelope xmlns:soapenv="http://schemas./soap/envelope/" xmlns:xsd="http://www./2001/XMLSchema" xmlns:xsi="http://www./2001/XMLSchema-instance"> <soapenv:Body> <getVersionResponse soapenv:encodingStyle="http://schemas./soap/encoding/"> <getVersionReturn xsi:type="xsd:string"> Apache Axis version: 1.1 Built on Apr 04, 2003 (01:30:37 PST) </getVersionReturn> </getVersionResponse> </soapenv:Body> </soapenv:Envelope> もちろん Axis のバージョンとビルド日時はあなたの結(jié)果とは異なっているでしょう。 JWS エンドポイントのテストそれでは JWS Webサービスをテストしてみましょう。Axis の JWS Webサービスは Axis の webapp の WEB-INF ツリーに入れた、拡張子 .jws の java ファイルです。URL でその .jws ファイルを要求すると、そのファイルはコンパイルされ、そして実行されます。JWS ページについてはユーザガイドで詳しく取り上げています。 JWS サービスをテストするには、用意されている例、 EchoHeaders.jws (これについては axis/ ディレクトリをご覧下さい) に対してリクエストを投げます。 ブラウザで http://localhost:8080/axis/EchoHeaders.jws?method=list にアクセスしてください。 以下のような、アプリケーションヘッダの XML リストが返って來るでしょう。 <?xml version="1.0" encoding="UTF-8" ?> <soapenv:Envelope xmlns:soapenv="http://schemas./soap/envelope/" xmlns:xsd="http://www./2001/XMLSchema" xmlns:xsi="http://www./2001/XMLSchema-instance"> <soapenv:Body> <listResponse soapenv:encodingStyle="http://schemas./soap/encoding/"> <listReturn xsi:type="soapenc:Array" soapenc:arrayType="xsd:string[6]" xmlns:soapenc="http://schemas./soap/encoding/"> <item>accept:image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, */*</item> <item>accept-language:en-us</item> <item>accept-encoding:gzip, deflate</item> <item>user-agent:Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)</item> <item>host:localhost:8080</item> <item>connection:Keep-Alive</item> </listReturn> </listResponse> </soapenv:Body> </soapenv:Envelope> 繰り返しになりますが、正確な戻り値はこれとは異なるでしょうし、正しいホスト名、ポート番號、webapp 名の URL に直す必要があります。 ステップ 5: 新しいWebサービスのインストールこれまでの過程で Axis をインストールし、動かしてきました。次は自分のWebサービスを追加します。 ここでのプロセスを要約すると、(1) 新しいサービスのクラスとライブラリを Axis WAR ディレクトリツリーに入れる、そして (2) それらの新しいファイルを Axis エンジンに認(rèn)識させる、ということになります。(2) は、Admin ウェブサービスを介して XML デプロイメントディスクリプタを新しいサービスにサブミットすることにより行われます。通常これは AdminClient プログラム、あるいは Ant タスク <axis-admin> により行われます。これら両方とも同じことを行います : Axis SOAP クライアントを起動して、それ自體 SOAP サービスである Axis administration サービスと通信します。Axis administration サービスはある1點(diǎn)について特別な SOAP サービスでもあります。それは、(リモートアクセスではなく)ローカル呼び出しのみに制限されていて、また、あなたのサービスを誰でも管理できるようにさせないためにパスワードで制限されています。クライアントが知っているデフォルトのパスワードがあり、もしそれを変更したら新しいパスワードをクライアントに渡さなければなりません。 最初のステップとして、あなたが書いたコードをサーバに追加します。
將你寫的代碼加入服務(wù)中。 WEB-INF ディレクトリの中の "classes" ディレクトリ (つまり axis/WEB-INF/classes ) を探して (あるいは作って) ください。このディレクトリにインストールしたい コンパイル済みの Java クラス を、Java パッケージのディレクトリ構(gòu)造を壊さないように注意しながらコピーしてください。
找到WEB-INF目錄中的“classes”目錄（即axis/WEB-INF/classes ）。將希望安裝的已編譯的java類文件、打包的java目錄結(jié)構(gòu)，小心別損壞，拷貝到這里。 もしインストールしたいサービスがすでに JAR ファイルにパッケージ化されているのなら、単に WEB-INF/lib ディレクトリに入れるだけです。依存しているサードパーティ製のライブラリがあれば、同じディレクトリに入れてください。
如果希望安裝的服務(wù)已經(jīng)打包成jar文件的話，只要將它們放到WEB-INF/lib目錄下即可。如果有依賴的第三方類庫的話，也放在相同的目錄下。 Axis の webapp に新しいクラスやライブラリを追加したら webapp を再起動してください。これはアプリケーションサーバを再起動するか、あるいは特定の webapp を再起動するサーバ特有の仕組みを利用することによって行います。
如有新的類或庫追加到Axis的webapp中的話，要重新啟動webapp。 注意 : もしあなたのWebサービスが xml-axis の提供する簡単な認(rèn)証ハンドラを利用している(これは製品版利用を目的としているというよりは、ハンドラの書き方の説明であるため実際はお勧めしません)のであれば 、対応する users.lst ファイルを WEB-INF ディレクトリにコピーする必要があります。
注意：如果你的web服務(wù)使用了xml-axis 所提供的簡單的認(rèn)證管理的話（不推薦），需要將隨對應(yīng)的users.lst文件拷貝到WEB-INF目錄下。 ステップ 6: Webサービスを配備
第六步：配置web服務(wù)
これまで設(shè)定した様々なクラスや JAR が新しいWebサービスを?qū)g行します。殘っている作業(yè)は、このWebサービスを公開する方法を Axis に伝えることです。このサービスが何か、どのメソッドを公開するのか、そして SOAP エンドポイントとしてのその他の側(cè)面を XML で表現(xiàn)するWebサービスデプロイメントディスクリプタ (WSDD) を、Axis は受け取ります。
至此設(shè)置的各種類文件，jar文件來執(zhí)行新的web服務(wù)。剩下的工作就是將此web服務(wù)所公開的方法傳給Axis。此服務(wù)公開了什么、哪些方法、作為soap端點(diǎn)用xml將另一個側(cè)面表現(xiàn)出來， これらの WSDD ファイルについてはユーザガイドとリファレンスガイドで扱います。ここでは Axis サンプルにある株価サービスの WSDD ファイルを使います。
關(guān)于這些WSDD文件在用戶向?qū)Ш褪褂弥改现兄v到。這里使用Axis樣例中的股票服務(wù)的WSDD文件。 クラスパスの設(shè)定
classpath的設(shè)置 これらのサンプルを動かすために、axis.jar、commons-discovery.jar、commons-logging.jar、jaxrpc.jar、saaj.jar、log4j-1.2.8.jar (あるいはお好みのロギング実裝)、そして XML パーサの jar ファイル (例えば xerces.jar) が Java から見えてないといけません。これらのサンプルでは、これらのファイルを AXISCLASSPATH に追加し、サンプル実行時に AXISCLASSPATH を指定しています。また、xml-apis.jar と xercesImpl.jar ファイルを AXIS_LIB ディレクトリにコピーしました。代わりに、XML パーサの jar ファイルを AXISCLASSPATH 変數(shù)に追加するか、これら全てのファイルを CLASSPATH 変數(shù)に追加してもかまいません。
為了運(yùn)行這些例子，必須要能從java中看到axis.jar、commons-discovery.jar、commons-logging.jar、jaxrpc.jar、saaj.jar、log4j-1.2.8.jar (或者喜歡的logging)、還有 XML解析器的 jar文件(如 xerces.jar) 。在這些例子中將這些文件追加到AXISCLASSPATH 中，在運(yùn)行例子時，就會指定AXISCLASSPATH 。再有要將xml-apis.jar和 xercesImpl.jar文件拷貝到 AXIS_LIB 目錄下。取而代之的是可以將xml解析器的jar文件追加到 AXISCLASSPATH 變量中，或者將這些所有的文件都追加到CLASSPATH 變量中也沒關(guān)系。 Windows では、今まで説明したことは次のようにすればよいでしょう。このドキュメントでは Axis を C:\axis にインストールしたと仮定します。この情報を WinNT/2000/XP で恒久的に格納するには、"マイコンピュータ" を右クリックして "プロパティ" を選択します。"詳細(xì)" タブをクリックして新しい環(huán)境変數(shù)を作成します。変數(shù)文字列をワードパッドで作成してから該當(dāng)するテキストフィールドにコピーした方が良いでしょう。
在windows中，前面的說明可以做如下配置。此文檔中，假定將Axis安裝在C:\axis 。為了能夠?qū)⑿畔⒂谰玫谋４嬖赪inNT/2000/XP 中，使用右鍵點(diǎn)擊“我的電腦”，選擇“屬性”。點(diǎn)擊“高級”，創(chuàng)建新的環(huán)境變量。將變量字符創(chuàng)用記事本編輯好在拷貝比較好。 set AXIS_HOME=c:\axis set AXIS_LIB=%AXIS_HOME%\lib set AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar; %AXIS_LIB%\commons-logging.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar; %AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar Unix を使っている方も同じようなことをします。これ以降では、Axis を /usr/axis にインストールしていて、bash シェルを利用していることを想定しています。もし違うシェルを使っている場合は、違いについてシェルのドキュメントをご覧下さい。変數(shù)をシェルに行き渡らせるためには、シェルのスタートアップ(ドット)ファイルに変數(shù)を追加する必要があります。もう一度シェルドキュメントをご覧下さい。
使用Unix系統(tǒng)也是同樣。 set AXIS_HOME=/usr/axis set AXIS_LIB=$AXIS_HOME/lib set AXISCLASSPATH=$AXIS_LIB/axis.jar:$AXIS_LIB/commons-discovery.jar: $AXIS_LIB/commons-logging.jar:$AXIS_LIB/jaxrpc.jar:$AXIS_LIB/saaj.jar: $AXIS_LIB/log4j-1.2.8.jar:$AXIS_LIB/xml-apis.jar:$AXIS_LIB/xercesImpl.jar export AXIS_HOME; export AXIS_LIB; export AXISCLASSPATH Axis のクライアントコードを利用するには、Java を呼ぶ際に AXISCLASSPATH を選びます。お使いのプラットフォームにより java -cp %AXISCLASSPATH% ... と入力するか、あるいは java -cp "$AXISCLASSPATH" ... と入力します。CLASSPATH にスペースを含まないのであればクオートを省略してもかまいません。 AXISCLASSPATH 変數(shù)を CLASSPATH 変數(shù)に追加してもよいでしょう。これによってこのガイドにある例題を起動する際に AXISCLASSPATH を追加する必要がなくなります。このドキュメントでは CLASSPATH 変數(shù)に追加しなかったことを想定しています。 デプロイメントディスクリプタを探すaxis/samples/stock の中を見て deploy.wsdd ファイルを探してください。これが Axis に伝えたいデプロイメントディスクリプタです。デプロイメントディスクリプタは Axis 特有の XML ファイルであり、Webサービスの配備(アンデプロイ)方法、Axis 自身の設(shè)定方法を Axis に伝えます。Axis Administration Webサービスにより、 AdminClient プログラムと、対応する Ant タスクが解釈のために新しい WSDD ファイルをサブミットすることができます。Axis ‘エンジン‘ はその設(shè)定を更新し、その狀態(tài)を保存します。 Axis はデフォルトではその狀態(tài)をグローバル設(shè)定ファイルである axis/WEB-INF/server-config.wsdd に保存します。ときどき、そのようなファイルがありませんという警告メッセージを見かけるかもしれませんが、心配する必要はありません。Axis に何かを配備した後、Axis は server-config.wsdd ファイルを自動生成するからです。webapp の中を確認(rèn)してこのファイルの中身を見てもかまいませんし、さらには、同じ設(shè)定を行いたい他のシステムにコピーすることもできます。Axis は、展開済みのWebアプリケーションと WEB-INF ディレクトリへ狀態(tài)を保存するために WEB-INF ディレクトリの書き込み許可を必要とします。 Admin クライアントの実行samples/stock ディレクトリで以下のコマンドを?qū)g行してください。もしこのディレクトリにいなければ、"java.io.FileNotFoundException: deploy.wsdd (システムは指定されたファイルを見つけることができませんでした。)" 例外が発生します。
もし java クライアントエラー (ClassNotFoundException) が発生したら、AXISCLASSPATH (または CLASSPATH) 変數(shù)を正しく設(shè)定していない、クラス名を間違えた、あるいはその他の基本的なミスをしたことが考えられます。そのような問題を突き止めるのは 基本的な Java 開発スキルです。もしこれらのやり方を知らないのであれば、今すぐ勉強(qiáng)しましょう。 注意 : localhost をあなたのホスト名、8080 をあなたのWebサーバが使っているポート番號に置き換えてください。もしWebアプリケーションを "axis" 以外に置き換えたのであれば、それに従って URL を変えてください。 もし AxisFault のリストを受け取ったら、クライアントは動いていますが、配備が失敗しています。ここからは TCP のソケット API と、Webサービスの配備に必要な HTTP の基本についての知識を必要とします。もし接続拒否といったソケットエラーを受け取ったら、相手のコンピュータがあなたと通信していないので、原因を探して直してください。もし HTTP エラーコードを受け取ったら、そのエラーの意味を知り、問題を解決してください。これらのスキルはWebサービスを利用する上で基本的なことです。 ユーザガイド は AdminClient について詳細(xì)に取り扱っています。また、Ant ビルドスクリプトにおいて Axis の利用を自動化する Ant タスク [英語] もあります。 ステップ 7: テストこのステップはオプションですが、非常にお勧めです。説明上、すでに株価サンプルをインストールして配備していることを仮定しています。
注意 : 前回と同様に、localhost をあなたのホスト名、8080 をあなたのWebサーバが使っているポート番號に置き換えてください。もしWebアプリケーションを "axis" 以外に置き換えたのであれば、それに従って URL を変えてください。 高度なインストール : 自分の Webapp に Axis を追加するもしあなたがWebアプリケーションの配備の経験が豊かで、特に、既存の、あるいは複雑な webapp にWebサービスを追加したいのであれば、Axis を起動する別のアプローチを取ることができます。Axis の webapp にあなたのクラスを追加する代わりに、あなたのアプリケーションに Axis を追加することができます。 中心となる概念は次の通りです。
このプロセスは PDF ファイル [英語] でダウンロードできる Java Development with Ant [英語] の15章で取り扱っています。 もし動かなかったらAxis はインストールするには複雑なシステムです。なぜなら、あなたのアプリケーションサーバに內(nèi)在する機(jī)能に依存していて、極めて複雑な設(shè)定があり、そして全ての分散アプリケーションのようにネットワークに依存するからです。 これまで多くの人がそれぞれの問題を axis-user メーリングリストに投稿し、Axis 開発者だけでなく Axis ユーザも、可能であれば最大限の助けをしてきました。ただ、自分の問題をメーリングリストにあせって投稿する前に、一言注意があります。 Axis はフリーです。つまりお金が支払われているサポート人員はいません。コミュニティから得られる助けは全てボランティアであり、彼らの心からの親切心から來るものです。彼らは、以前助けが欲しかった同じハードルを越える助けをしたい他のユーザかもしれないし、開発者自身かもしれない。しかしそれは皆ボランティアであり、あまり期待しないでください。
これを読んで Axis ユーザメーリングリストの參加を思いとどまりましたか。そうでないことを望みます。このメーリングリストは Axis を使う人のものであるため、あなたのプロジェクトが進(jìn)むにつれて仲間となるでしょう。私達(dá)はあなたに、このメーリングリストがサーバサイド Java 開発の初心者のための年中無休のサポートラインではなく、この領(lǐng)域についてある程度自分でできる必要があるということを知っておいてほしかったのです。これは銀の弾丸ではありません。しかしメーリングリストを効果的に使う方法を知っておくことが、Axis のよりよい開発の手助けとなるでしょう。 まとめAxis は単に自分の webapp に追加できる SOAPの実裝であり、自分のWebサービスをホストできる webapp です。Axis のインストールは、特に Java 1.4 の厳しい要求が與えられると、少し手間がかかります。順にテストし、happyaxis と同梱のテストサービスを使うといった秩序だったプロセスに従えば、Axis で始めるのが簡単であることがわかります。 付録: SOAP モニタを有効にするSOAP モニタにより、ウェブブラウザ(Java plug-in 1.3 以上を用いる)を介して SOAP リクエストとレスポンスを監(jiān)視することができます。利用方法の詳細(xì)な解説についてはユーザガイドのSOAP モニタを利用するをご覧下さい。 SOAP モニタはデフォルトでは無効です。有効にする基本的なステップは、SOAP モニタ Java アプレットをコンパイルし、SOAP モニタWebサービスをデプロイし、各監(jiān)視Webサービスに対してリクエストとレスポンスのフロー定義を追加します。以下に詳細(xì)を記します。
|
|
|
