訳：日本アイ・ビー・エム(株) ソフトウェア事業部 米持 幸寿

このドキュメントは、Apache SOAP 2.0レベルのものを日本語訳したもので、 最新版のものとは異なる可能性があります。また、ウェブ上で見る場合、一部 のリンクが切れている可能性があります。Apache SOAPのディレクトリの該当 ファイルと置き換えることで、オリジナルのページにリンクさせることができ ます。

Apache-SOAP Version 2.0: 導入手順

2000年　8月

Apache-SOAPは、クライアント、またはサーバーとして導入することができます。この資料は、双方の導入手順を示し、導入にまつわるよくあるトラブルを解決するための「トラブルシューティング」の章を設けてあります。

共通の手順

すでにApache-SOAPのバイナリ配布ファイルがダウンロードされており、ディレクトリー/fooに解凍されているものとして話を進めます。その場合、配布ファイルから解凍されたファイルはディレクトリー /foo/soap-2_0/ に解凍されます。

Win32環境で作業する場合は、"/" を "\" と読み替えて読み進めてください。

XML Parser: Apache-SOAP は、 Apache Xerces (Java) version 1.1.2 またはそれ以降のバージョンを必要とします。これらのバージョンは、名前空間をサポートする DOM level 2 を提供します。もし、すでに別のXMLパーサー（または、org.w3c.dom.*インターフェイスをもっているであろうJARファイル）をお持ちなら、Xerces の xerces.jar ファイルをクラスパスの始めにおくことが重要です。そうしないと Apache-SOAP は動きません。

特にTomcatに最初から含まれているSunのXML Parser（jakarta-tomcat\lib\xml.jar）のことを言っています。Tomcatではデフォルトでクラスパスにxerces.jarよりも前にxml.jarを含めるので、実行時にエラー（古いDOMのパッケージを使うためにDOM Level2のメソッドが見つからない）が発生します。

他のパーサーを使えるようにすることもできるのでしょうけれど、現在のバージョンではそれをうまいこと実現できていませんし、これ以上の説明はここではいたしません。

Classpath: /foo/soap-2_0/lib/soap.jar をクラスパスに追加してください。サンプルを動作させるのであれば、 /foo/soap-2_0 も必要です。

クライアント側の手順

共通の手順が終われば、準備完了です。

サーバー側の手順

Apache-SOAP をサーバー側に導入するには、サーブレットとＪＳＰをサポートするウェブ・アプリケーション・サーバーが必要です。

RPCルーターと管理クライアントの導入: それぞれのサーバー毎の導入手順です。

お使いのサーバーが一覧にありませんか？例としてTomcatの手順を見てみてください。どうすればいいかわかるはずです。もし分からないようなら、 Apache-SOAP ユーザーズリストに問い合わせてみましょう。もうすでにだれかがやってみたかもしれません。リストにはこちらから登録できます。: http://xml.apache.org/soap/mail.html.

導入時の問題の解決方法

Problem Comments
「getAttributeNS is not found」
という例外になった		 クラスパスが正しくありません。 - 古いパーサーか　org.w3c.dom.*クラス　を含んでいる別のJARファイルが Xerces 1.1.2 以上の xerces.jar よりも先に参照されています。
x y
x2 y2
x3 y3