1.Apache Axis 2ユーザーガイド
原文:http://axis.apache.org/axis2/java/core/docs/userguide.html
以下の内容は私がapacheのウェブサイトから学ぶ笔记で、基本的にすべて翻訳してきたので、初めて翻訳を试みて、翻訳のよくないこと、読者にどうぞお许しください.
Apache Axis 2ユーザーガイド
このガイドは、Apache Axis 2を使用する初心者に学習を開始する環境を提供し、Axis 2を使用してWebサービスを作成および開発する方法と、WSDLを使用してクライアントとサーバを同時に生成する方法など、高度な話題にも関連しています.
Axis 2紹介
この章ではAxisとその構造を紹介し、最新のAxis 2ダウンロードにもこれらのディレクトリの説明があります.
目次:紹介Axis 2 ------Axis 2とは何ですか? ------底は何ですか? ------Axis 2はSOAP情報をどのように処理しますか? ------Axis 2リリース ------Axis 2標準バイナリリリース ------Axis 2.warディレクトリレベル ------Axis 2ドキュメント説明 ------Axis 2およびクライアント クライアントコード のインストールとテストサービス紹介 ------情報交換テンプレート クライアント を作成する------クライアント生成方法 を選択する.------クライアント を生成する.------Axisデータバインド(ADB) サービス作成 ------利用可能なオプションで適切な(バージョン?) を取得------Scratchからのサービス作成 ------簡単なjavaオブジェクトを配置する ------WSDLからAxis 2サービスの導入と実行 を作成例 より多くの学習 Axis 2とは?
Apache Axis 2プロジェクトはjavaをベースにクライアントとサーバ側のネットワークサービスのバランスを実現しています.Apache Axis 1.0の利点を使用して、Apache Axis 2は完全なオブジェクトモデルとモジュールアーキテクチャを提供し、機能の追加と新しいネットワークサービス仕様と推奨をより容易にサポートします.
Axis 2では、以下のタスクを簡単に実行できます. SOAP情報 を送信する. SOAP情報 を受け付ける処理する.簡単なjavaクラスによってネットワークサービス を作成する WSDLを使用して、クライアントおよびサーバ側のインプリメンテーションクラス を作成するサービスを容易に入手できるWSDL 添付ファイル付きSOAP情報 を送信受信する. REST-basedネットワークサービス を作成または使用 WS-security、WS-RealiableMessaging、WS-Addressing、WS-Coordination、およびWS-Automic Transactionの利点を有するサービス を作成または使用する新しい要求/需要が現れる時、Axis 2の模型の構造を使って彼らの を簡単に支持します
さらに多くの特徴がありますが、このユーザーガイドは、リスト上の最初の5つのタスクをどのように完了するかを示すことに注目しています.
底は何ですか.
Axis 2とそれが何であるかをよりよく理解するためには、ネットワークサービス情報のライフサイクルをよく理解する必要があります.典型的には、このように見えます.
送信プログラムは、ヘッダとパッケージを含むソースSOAP情報を作成します.(SOAPの詳細については、「サービスの紹介」を参照してください.)WS*の推奨を使用するようにシステムが要求している場合、WS-AddressingまたはWS-securityのように、情報は送信機から離れる前に追加の処理が行われている可能性があります.情報が準備されると、HTTP、JMSなど、特定の方法で輸送されます.
Axis 2はSOAP情報をどのように処理しますか?
Axis 2は、データ送信時に送信機および受信者の処理を制御することができる.Axis 2の見通しから見ると、構造はこうです.
各終了箇所には、情報を処理するためのアプリケーション設計(送信または受信)があります.真ん中には、Axis 2があります.正確には、Axis 2があります.ネットワークサービスの価値は、送信者と受信者(またはクライアントとサーバ側)が同じプラットフォームを必要とせず、同じアプリケーションを実行することが少ないことです.Axis 2が両端で動作していると仮定すると、処理はこのように見えます.送信機はSOAP情報を作成する. Axis「コントローラ」は、WS-security暗号化 に情報を入力するなど、情報上必要な操作を実行する.送信機送信情報 受信終了時に、リスナーモニタ情報 受信側では、リスナーが任意の処理者に情報を送信する .情報が処理されて「事前配布」とマークされると、配布器によって処理され、配布器は類似のアプリケーションで送信されます.
Axis 2では、それらの動作が「クリップ」に断片化され、「事前配布」、「配布」、「情報処理」などの事前定義されたクリップを使用してAxis 2に構築されます.各セグメントは、プロセッサの集合です.Axis 2では、どの処理者がどのフラグメントを取得できるか、どの処理者がフラグメントを実行できるかを制御できます.自分のクリップとプロセッサを追加することもできます.
処理者は「モジュール」から来ており、実行中のAxis 2システムに添付できます.これらのモジュール、例えばRampart、WS-securityの実装を提供し、Sandesha、WS-ReliableMessagingの実装を提供し、Axis 2において主な拡張可能なメカニズムである.
Axis 2リリース
Axis 2はすでにいくつかのバージョン(distributions)を発表していますが、どのバージョンを使用するかは、それを使用して何をするかに基づいています.
Axis 2標準バイナリリリース
サーバーとアプリケーションを開発する場合は、Axis 2標準バイナリリリースを使用する必要があります.このリリースには、必要なすべての*.jarファイルと、開発を簡素化するための複数のスクリプトが含まれています.以下の構造があります.
コードリスト1:Axis 2標準バイナリリリース
バイナリディレクトリ構造には、いくつかの有用なスクリプトが含まれています.Axis 2.bat(またはaxis 2.sh)が含まれています.Axis 2 jarファイルをすべて手動で環境変数に追加する必要がなく、javaコマンド、java 2 wsdl.bat(.sh)、wsdl 2 java.bat(.sh)を簡単に実行できます.WSDLからjavaコード(逆も同じです)、axis 2 server.bat(および.sh)を簡単に生成できます.簡単なWebサーバでは、Axis 2の能力を構築して自分のアプリケーションに情報を送信し、受け入れることができます.
所望のように、libディレクトリには必要なjarファイルがすべて含まれています.サービスとmodulesはresponsitoryディレクトリに追加されます.Axis 2にはWS-Addressingを実現する標準モジュール(module)がある.また、Rampartなどの他の必要なモジュールをrepository/modulesディレクトリに追加することができます.
confディレクトリにはaxis 2.xmlが含まれており、グローバルなデプロイメント記述器です.
最後にsamplesディレクトリには、Axis 2に関連するすべてのインスタンスコードが含まれます.これらの例と彼らの説明リストを見ることができます.(samples and their descriptions.)
axis 2.warリリース版ディレクトリレベル
axis 2.warはWARリリース版(WAR(Web Archive)Distribution)で使用可能です.Axis 2のサーバ側ではJ 2 EEアプリケーションとして使用できますが、以下の構成もあります.
コードリスト2:Axis 2のサーバ側
上部からaxis 2-webは、Axis 2管理アプリケーションを構成する(Axis 2 administrationアプリケーション)jspページのセットです.これにより、サービスの追加やモジュールの有効化、無効化など、必要なアクションを実行できます.WEB-INFディレクトリは、実際のAxis 2アプリケーション、*.jarファイル、任意のモジュール、さらにはサーバ自体を導入することを意味します.
classesディレクトリには、log 4 j.propertiesなどの任意のAxis 2自身が必要とするclassファイルまたはpropertyファイルがあります.実際にシステムで処理できるサービスは、servicesディレクトリの下でaxisと同じようにアーカイブされているか、*.aarファイルです.このファイルには、サービスに関連する多くのクラスが含まれており、services.xmlファイルと同様に、情報送信者や情報受信者の定義など、多くの追加の要件を制御します.
これらのファイルの中で最も重要なのはaxis 2.xmlであり、アプリケーションが受信情報をどのように処理するかを制御します.情報受信者と送信者を定義し、送信者とどのモジュールが有効かを定義します.また、クリップのコマンドと、各クリップを処理するプロセッサも定義されます.
Webアプリケーション(Webアプリケーション)を使用すると、すべての情報を制御できますが、Axis 2アプリケーションを再起動すると、変更が失われ、サービスがaxis 2.xmlファイルで定義された状態に戻ります.
Axis 2はまた、ソースリリース(source distribution)の3番目のリリースを提供し、このwarファイルを自分で生成することができます.
Axis 2ドキュメントディレクトリ構造
ドキュメントの説明には、xdcosおよびjavadocsを含むすべてのAxis 2ドキュメントが含まれます.以下の犬がいます.
コードリスト3:Axis 2ドキュメント分布
JAvadocsディレクトリには、Axis 2 APIに関するすべての標準APIファイル(API documentation)と、このドキュメントのような他のドキュメント(xdocsディレクトリ)が含まれています.
Axis 2とクライアント
Axis 2がネットワークアプリケーション(Webアプリケーション)の一部としてどのように機能するかを説明します.単独のクライアントはJ 2 EEアプリケーションの一部ではありませんか?この場合、1つの送信者は、Axis 2のデフォルトの属性を使用することができ、言い換えれば、特別な処理者などは存在しない.しかし、クライアントに自分のaxis 2.xmlのコピーと動作をロードするように伝えるオプションもあります.
次の章では、クライアントコードのインストールとテスト(Installing and Testing Client Code)を参照してください.
PS:やっと翻訳が终わって、多くのところがうまくいかないので、时間が许される时、私はまた修正して改善します.
以下の内容は私がapacheのウェブサイトから学ぶ笔记で、基本的にすべて翻訳してきたので、初めて翻訳を试みて、翻訳のよくないこと、読者にどうぞお许しください.
Apache Axis 2ユーザーガイド
このガイドは、Apache Axis 2を使用する初心者に学習を開始する環境を提供し、Axis 2を使用してWebサービスを作成および開発する方法と、WSDLを使用してクライアントとサーバを同時に生成する方法など、高度な話題にも関連しています.
Axis 2紹介
この章ではAxisとその構造を紹介し、最新のAxis 2ダウンロードにもこれらのディレクトリの説明があります.
目次:
Apache Axis 2プロジェクトはjavaをベースにクライアントとサーバ側のネットワークサービスのバランスを実現しています.Apache Axis 1.0の利点を使用して、Apache Axis 2は完全なオブジェクトモデルとモジュールアーキテクチャを提供し、機能の追加と新しいネットワークサービス仕様と推奨をより容易にサポートします.
Axis 2では、以下のタスクを簡単に実行できます.
さらに多くの特徴がありますが、このユーザーガイドは、リスト上の最初の5つのタスクをどのように完了するかを示すことに注目しています.
底は何ですか.
Axis 2とそれが何であるかをよりよく理解するためには、ネットワークサービス情報のライフサイクルをよく理解する必要があります.典型的には、このように見えます.
送信プログラムは、ヘッダとパッケージを含むソースSOAP情報を作成します.(SOAPの詳細については、「サービスの紹介」を参照してください.)WS*の推奨を使用するようにシステムが要求している場合、WS-AddressingまたはWS-securityのように、情報は送信機から離れる前に追加の処理が行われている可能性があります.情報が準備されると、HTTP、JMSなど、特定の方法で輸送されます.
Axis 2はSOAP情報をどのように処理しますか?
Axis 2は、データ送信時に送信機および受信者の処理を制御することができる.Axis 2の見通しから見ると、構造はこうです.
各終了箇所には、情報を処理するためのアプリケーション設計(送信または受信)があります.真ん中には、Axis 2があります.正確には、Axis 2があります.ネットワークサービスの価値は、送信者と受信者(またはクライアントとサーバ側)が同じプラットフォームを必要とせず、同じアプリケーションを実行することが少ないことです.Axis 2が両端で動作していると仮定すると、処理はこのように見えます.
Axis 2では、それらの動作が「クリップ」に断片化され、「事前配布」、「配布」、「情報処理」などの事前定義されたクリップを使用してAxis 2に構築されます.各セグメントは、プロセッサの集合です.Axis 2では、どの処理者がどのフラグメントを取得できるか、どの処理者がフラグメントを実行できるかを制御できます.自分のクリップとプロセッサを追加することもできます.
処理者は「モジュール」から来ており、実行中のAxis 2システムに添付できます.これらのモジュール、例えばRampart、WS-securityの実装を提供し、Sandesha、WS-ReliableMessagingの実装を提供し、Axis 2において主な拡張可能なメカニズムである.
Axis 2リリース
Axis 2はすでにいくつかのバージョン(distributions)を発表していますが、どのバージョンを使用するかは、それを使用して何をするかに基づいています.
Axis 2標準バイナリリリース
サーバーとアプリケーションを開発する場合は、Axis 2標準バイナリリリースを使用する必要があります.このリリースには、必要なすべての*.jarファイルと、開発を簡素化するための複数のスクリプトが含まれています.以下の構造があります.
コードリスト1:Axis 2標準バイナリリリース
bin
axis2.bat
axis2.sh
axis2server.bat
axis2server.sh
java2wsdl.bat
java2wsdl.sh
wsdl2java.bat
wsdl2java.sh
setenv.sh
lib
activation-1.1.jar
...
XmlSchema.jar
repository
modules
modules.list
addressing-1.1.mar
..
services
services.list
version.aar
..
samples
...
webapp
...
conf
axis2.xml
LICENSE.txt
README.txt
NOTICE.txt
INSTALL.txt
release-notes.html
バイナリディレクトリ構造には、いくつかの有用なスクリプトが含まれています.Axis 2.bat(またはaxis 2.sh)が含まれています.Axis 2 jarファイルをすべて手動で環境変数に追加する必要がなく、javaコマンド、java 2 wsdl.bat(.sh)、wsdl 2 java.bat(.sh)を簡単に実行できます.WSDLからjavaコード(逆も同じです)、axis 2 server.bat(および.sh)を簡単に生成できます.簡単なWebサーバでは、Axis 2の能力を構築して自分のアプリケーションに情報を送信し、受け入れることができます.
所望のように、libディレクトリには必要なjarファイルがすべて含まれています.サービスとmodulesはresponsitoryディレクトリに追加されます.Axis 2にはWS-Addressingを実現する標準モジュール(module)がある.また、Rampartなどの他の必要なモジュールをrepository/modulesディレクトリに追加することができます.
confディレクトリにはaxis 2.xmlが含まれており、グローバルなデプロイメント記述器です.
最後にsamplesディレクトリには、Axis 2に関連するすべてのインスタンスコードが含まれます.これらの例と彼らの説明リストを見ることができます.(samples and their descriptions.)
axis 2.warリリース版ディレクトリレベル
axis 2.warはWARリリース版(WAR(Web Archive)Distribution)で使用可能です.Axis 2のサーバ側ではJ 2 EEアプリケーションとして使用できますが、以下の構成もあります.
コードリスト2:Axis 2のサーバ側
axis2-web
META-INF
WEB-INF
classes
conf
axis2.xml
lib
activation.jar
...
xmlSchema.jar
modules
modules.list
addressing.mar
...
soapmonitor.mar
services
services.list
aservice.aar
...
version.aar
web.xml
上部からaxis 2-webは、Axis 2管理アプリケーションを構成する(Axis 2 administrationアプリケーション)jspページのセットです.これにより、サービスの追加やモジュールの有効化、無効化など、必要なアクションを実行できます.WEB-INFディレクトリは、実際のAxis 2アプリケーション、*.jarファイル、任意のモジュール、さらにはサーバ自体を導入することを意味します.
classesディレクトリには、log 4 j.propertiesなどの任意のAxis 2自身が必要とするclassファイルまたはpropertyファイルがあります.実際にシステムで処理できるサービスは、servicesディレクトリの下でaxisと同じようにアーカイブされているか、*.aarファイルです.このファイルには、サービスに関連する多くのクラスが含まれており、services.xmlファイルと同様に、情報送信者や情報受信者の定義など、多くの追加の要件を制御します.
これらのファイルの中で最も重要なのはaxis 2.xmlであり、アプリケーションが受信情報をどのように処理するかを制御します.情報受信者と送信者を定義し、送信者とどのモジュールが有効かを定義します.また、クリップのコマンドと、各クリップを処理するプロセッサも定義されます.
Webアプリケーション(Webアプリケーション)を使用すると、すべての情報を制御できますが、Axis 2アプリケーションを再起動すると、変更が失われ、サービスがaxis 2.xmlファイルで定義された状態に戻ります.
Axis 2はまた、ソースリリース(source distribution)の3番目のリリースを提供し、このwarファイルを自分で生成することができます.
Axis 2ドキュメントディレクトリ構造
ドキュメントの説明には、xdcosおよびjavadocsを含むすべてのAxis 2ドキュメントが含まれます.以下の犬がいます.
コードリスト3:Axis 2ドキュメント分布
docs
javadocs
xdocs
LICENSE.txt
README.txt
release-notes.html
JAvadocsディレクトリには、Axis 2 APIに関するすべての標準APIファイル(API documentation)と、このドキュメントのような他のドキュメント(xdocsディレクトリ)が含まれています.
Axis 2とクライアント
Axis 2がネットワークアプリケーション(Webアプリケーション)の一部としてどのように機能するかを説明します.単独のクライアントはJ 2 EEアプリケーションの一部ではありませんか?この場合、1つの送信者は、Axis 2のデフォルトの属性を使用することができ、言い換えれば、特別な処理者などは存在しない.しかし、クライアントに自分のaxis 2.xmlのコピーと動作をロードするように伝えるオプションもあります.
次の章では、クライアントコードのインストールとテスト(Installing and Testing Client Code)を参照してください.
PS:やっと翻訳が终わって、多くのところがうまくいかないので、时間が许される时、私はまた修正して改善します.