WebLogic Web サービスプログラマーズガイド

概要とロードマップ

マニュアルの内容と対象読者

このマニュアルの手引き

Web サービス開発者向けのサンプル

Avitek Medical Records アプリケーション (MedRec) とチュートリアル

WebLogic Server 配布キットの Web サービスサンプル

ダウンロード可能な他の Web サービスサンプル

WebLogic Web サービスのリリース固有情報

8.1 と 9.0 の WebLogic Web サービスの相違点

WebLogic Web サービスの機能の概要

ベータ版と GA の WebLogic Web サービスの相違点

WebLogic Web サービスについて

Web サービスとは

Web サービスを使用する理由

WebLogic Web サービスの構造

一般的な Web サービス開発タスクのロードマップ

WebLogic Web サービスでサポートされる標準

Web サービス仕様の BEA 実装

Web Services Metadata for the Java Platform (JSR-181)

エンタープライズ Web サービス 1.1

SOAP 1.1

SAAJ 1.2

WSDL 1.1

JAX-RPC 1.1

Web サービスセキュリティ (WS-Security) 1.0

UDDI 2.0

JAX-R 1.0

WS-Addressing 1.0

WS-Policy 1.0

WS-PolicyAttachment 1.0

WS-ReliableMessaging 1.0

WebLogic Web サービスでサポートされるその他の仕様

一般的な Web サービスの使用例とサンプル

簡単な HelloWorld Web サービスの作成

ユーザ定義のデータ型を使用する Web サービスの作成

WSDL ファイルからの Web サービスの作成

スタンドアロンの JAX-RPC Java クライアントからの Web サービスの呼び出し

WebLogic Web サービスからの Web サービスの呼び出し

WebLogic Web サービスの反復的な開発

WebLogic Web サービスプログラミングモデルの概要

Java から開始する WebLogic Web サービスの反復的な開発 : 主な手順

WSDL ファイルから開始する WebLogic Web サービスの反復的な開発 : 主な手順

基本的な Ant build.xml ファイルの作成

jwsc WebLogic Web サービス Ant タスクの実行

wsdlc WebLogic Web サービス Ant タスクの実行

wsdlc で生成される途中まで作成済みの JWS 実装クラスファイルの更新

WebLogic Web サービスのデプロイとアンデプロイ

wldeploy Ant タスクを使用した Web サービスのデプロイ

Administration Console を使用した Web サービスのデプロイ

Web サービスの WSDL の参照

Web サービスのテスト

Web サービスの WebLogic 分割開発ディレクトリ環境への統合

JWS ファイルのプログラミング

JWS ファイルと JWS アノテーションの概要

JWS ファイルのプログラミング : Java の要件

JWS ファイルのプログラミング : 一般的な手順

JWS ファイルの例

JWS ファイルが Web サービスを実装することの指定

Web サービスと SOAP メッセージプロトコルのマッピングの指定

Web サービスのコンテキストパスとサービス URI の指定

JWS メソッドをパブリックオペレーションとして公開することの指定

オペレーションのパラメータと WSDL の部分のマッピングのカスタマイズ

オペレーションの戻り値と WSDL の部分のマッピングのカスタマイズ

JwsContext を使用した Web サービスの実行時情報へのアクセス

Web サービスコンテキストへのアクセスに関するガイドライン

JwsContext のメソッド

ステートレスセッション EJB を実装すべき場合

JWS ファイルで EJB を実装する場合のプログラミングのガイドライン

EJB を実装する JWS ファイルの例

ユーザ定義の Java データ型のプログラミング

例外の送出

JWS ファイルからの別の Web サービスの呼び出し

JWS プログラミングのベストプラクティス

高度な JWS プログラミング

Web サービスの信頼性のあるメッセージングの使用

Web サービスの信頼性のあるメッセージングをコンフィグレーションするための WS-Policy ファイルの使用

Web サービスの信頼性のあるメッセージングの使用 : 主な手順

送り先 WebLogic Server インスタンスのコンフィグレーション

ソース WebLogic Server インスタンスのコンフィグレーション

Web サービスの信頼性のあるメッセージングの WS-Policy ファイルの作成

信頼性のある JWS ファイルに関するプログラミングのガイドライン

信頼性のある Web サービスを呼び出す JWS ファイルに関するプログラミングのガイドライン

信頼性のある Web サービスのクライアント用 build.xm ファイルの更新

非同期の要求と応答を使用した Web サービスの呼び出し

非同期の要求と応答の使用 : 主な手順

非同期の JWS ファイルの記述

非同期の要求と応答を使用する場合の build.xml ファイルの更新

会話形式の Web サービスの作成

会話形式の Web サービスの作成 : 主な手順

会話形式の JWS ファイルに関するプログラミングのガイドライン

会話形式の Web サービスを呼び出す JWS ファイルに関するプログラミングのガイドライン

会話形式の Web サービスのクライアント用 build.xm ファイルの更新

会話形式の Web サービスを呼び出すためのスタンドアロン Java クライアントの更新

バッファ付き Web サービスの作成

バッファ付き Web サービスの作成 : 主な手順

バッファ付き Web サービスをホストする WebLogic Server のコンフィグレーション

バッファ付き JWS ファイルに関するプログラミングのガイドライン

バッファ付き Web サービスを呼び出す JWS ファイルのプログラミング

バッファ付き Web サービスのクライアント用 build.xm ファイルの更新

非同期機能の併用

信頼性のある会話形式の Web サービスを実装する JWS ファイルの例

信頼性のある会話形式の Web サービスを非同期で呼び出すクライアント Web サービスの例

信頼性のあるメッセージングまたは非同期の要求応答とプロキシサーバの使用

JMS 転送の使用

JMS 転送の使用 : 主な手順

@WLJmsTransport JWS アノテーションの使用

jwsc Ant タスクの <WLJmsTransport> 子要素の使用

JMS 転送を使用した WebLogic Web サービスの呼び出し

SOAP メッセージハンドラの作成と使用

主な手順

SOAP メッセージハンドラおよびハンドラチェーンの設計

GenericHandler クラスの作成

JWS ファイルでのハンドラのコンフィグレーション

ハンドラチェーンコンフィグレーションファイルの作成

Web サービスのコンパイルと再ビルド

データ型とデータバインディング

データ型とデータバインディングの概要

サポートされる組み込みデータ型

組み込みデータ型の XML-to-Java マッピング

組み込みデータ型の Java-to-XML マッピング

サポートされるユーザ定義のデータ型

サポートされるユーザ定義の XML データ型

サポートされるユーザ定義の Java データ型

Web サービスの呼び出し

Web サービスの呼び出しの概要

クライアントアプリケーションの種類

JAX-RPC

clientgen Ant タスク

Web サービスを呼び出すクライアントの例

スタンドアロンクライアントからの Web サービスの呼び出し : 主な手順

クライアントのアーティファクトを生成するための clientgen Ant タスクの使用

Web サービスに関する情報の取得

Java クライアントアプリケーションコードの記述

クライアントアプリケーションのコンパイルと実行

スタンドアロン Java クライアントのサンプル Ant ビルドファイル

別の Web サービスからの Web サービスの呼び出し

Web サービスクライアントのサンプル build.xml ファイル

Web サービスを呼び出すサンプル JWS ファイル

クライアントサイド SOAP メッセージハンドラの作成と使用

クライアントサイド SOAP メッセージハンドラの使用 : 主な手順

クライアントサイドハンドラクラスの例

クライアントサイド SOAP ハンドラのコンフィグレーションファイルの作成

クライアントサイドハンドラのコンフィグレーションファイル用 XML スキーマ

クライアントサイド SOAP ハンドラのコンフィグレーションファイルの clientgen への指定

クライアントサイドセキュリティ WS-Policy ファイルの使用

クライアントサイドセキュリティ WS-Policy ファイルの使用 : 主な手順

WS-Policy ファイルをロードするメソッドを生成するための clientgen の更新

WS-Policy ファイルをロードするためのクライアントアプリケーションの更新

セキュリティのコンフィグレーション

Web サービスセキュリティの概要

どのタイプのセキュリティをコンフィグレーションすべきか

メッセージレベルのセキュリティ (デジタル署名と暗号化) のコンフィグレーション

主な使い方

メッセージレベルのセキュリティコンフィグレーションに対する WS-Policy ファイルの使い方の概要

簡単なメッセージレベルのセキュリティのコンフィグレーション : 主な手順

用意されている SSL ペア以外のキーペアの使用

SOAP メッセージの有効期限の設定

カスタム WS-Policy ファイルの作成と使用

Administration Console を使用した実行時の WS-Policy ファイルの関連付け

Security Assertion Markup Language (SAML) トークンの ID としての使用

X.509 証明書トークンの ID としての使用

プレーンテキストではなくパスワードダイジェストの SOAP メッセージでの使用

WebLogic Server インスタンスで実行中のクライアントからのメッセージ保護された Web サービスの呼び出し

Web サービスとデフォルト以外のセキュリティコンフィグレーションとの関連付け

転送レベルのセキュリティのコンフィグレーション

クライアントアプリケーションでの双方向 SSL のコンフィグレーション

その他の Web サービス SSL の例

アクセス制御セキュリティのコンフィグレーション : 主な手順

@SecurityRoles および @SecurityIdentity アノテーションでの JWS ファイルの更新

JAX-RPC プロパティを使用して自身を認証するためのクライアントアプリケーションの更新

Web サービスの管理

WebLogic Web サービスの管理タスクの概要

WebLogic Web サービスを管理するツール

Administration Console の使用

Administration Console の起動

Administration Console での Web サービスの表示

Web サービスのセキュリティコンフィグレーションの作成

WebLogic Scripting Tool の使用

WebLogic Ant タスクの使用

Java Management Extensions (JMX) の使用

J2EE Deployment API の使用

UDDI を使用した Web サービスのパブリッシュと検索

UDDI の概要

UDDI と Web サービス

UDDI とビジネスレジストリ

UDDI のデータ構造

WebLogic Server の UDDI 機能

UDDI 2.0 サーバ

UDDI 2.0 サーバのコンフィグレーション

uddi.properties ファイルのプロパティ

UDDI ディレクトリエクスプローラ

UDDI クライアント API

プラガブル tModel

XML 要素と許容値

プラガブル tModel の XML スキーマ

プラガブル tModel のサンプル XML

8.1 Web サービスの 9.0 へのアップグレード

アップグレードの概要

8.1 Java クラス実装の WebLogic Web サービスの 9.0 へのアップグレード : 主な手順

8.1 Java ファイルと対応する 9.0 JWS ファイルの例

8.1 と更新された 9.0 の Ant ビルドファイルの例 (Java クラス実装の Web サービス)

8.1 EJB 実装の WebLogic Web サービスの 9.0 へのアップグレード : 主な手順

8.1 EJB ファイルと対応する 9.0 JWS ファイルの例

8.1 と更新された 9.0 の Ant ビルドファイルの例 (8.1 EJB 実装の Web サービス)

servicegen 属性と JWS アノテーションまたは jwsc 属性のマッピング

Ant タスクリファレンス

WebLogic Web サービス Ant タスクの概要

Web サービス Ant タスクのリスト

Web サービス Ant タスクの使用

WebLogic Ant タスクのクラスパスの設定

WSDL および XML スキーマファイルの操作時におけるオペレーティングシステムの大文字/小文字の区別の違い

clientgen

jwsc

wsdlc

JWS アノテーションリファレンス

JWS アノテーションタグの概要

標準 JSR-181 の JWS アノテーションリファレンス

javax.jws.WebService

javax.jws.WebMethod

javax.jws.Oneway

javax.jws.WebParam

javax.jws.WebResult

javax.jws.HandlerChain

javax.jws.soap.SOAPBinding

javax.jws.soap.SOAPMessageHandler

javax.jws.soap.InitParam

javax.jws.soap.SOAPMessageHandlers

WebLogic 固有の JWS アノテーションリファレンス

weblogic.jws.AsyncFailure

weblogic.jws.AsyncResponse

weblogic.jws.BufferQueue

weblogic.jws.Context

weblogic.jws.Conversation

weblogic.jws.Conversational

weblogic.jws.MessageBuffer

weblogic.jws.Policies

weblogic.jws.Policy

weblogic.jws.ReliabilityBuffer

weblogic.jws.ServiceClient

weblogic.jws.Transactional

weblogic.jws.WLHttpTransport

weblogic.jws.WLHttpsTransport

weblogic.jws.WLJmsTransport

weblogic.jws.WSDL

weblogic.jws.security.SecurityRoles

weblogic.jws.security.SecurityIdentity

weblogic.jws.security.WssConfiguration

Web サービスの信頼性のあるメッセージングのポリシーアサーションに関するリファレンス

Web サービスの信頼性のあるメッセージングのアサーションを含む WS-Policy ファイルの概要

グラフィカルな表現

Web サービスの信頼性のあるメッセージングのアサーションを含む WS-Policy ファイルの例

要素の説明

beapolicy:Expires

beapolicy:QOS

wsrm:AcknowledgementInterval

wsrm:BaseRetransmissionInterval

wsrm:ExponentialBackoff

wsrm:InactivityTimeout

wsrm:RMAssertion

セキュリティポリシーアサーションのリファレンス

セキュリティアサーションを含む WS-Policy ファイルの概要

グラフィカルな表現

セキュリティ要素のあるポリシーファイルの例

要素の説明

CanonicalizationAlgorithm

Claims

Confidentiality

ConfirmationMethod

DigestAlgorithm

EncryptionAlgorithm

Identity

Integrity

KeyInfo

KeyWrappingAlgorithm

MessageAge

MessageParts

SecurityToken

SignatureAlgorithm

SupportedTokens

Target

Transform

UsePassword

WebLogic Web サービスデプロイメント記述子要素のリファレンス

weblogic-webservices.xml の概要

グラフィカルな表現

XML スキーマ

weblogic-webservices.xml デプロイメント記述子ファイルの例

要素の説明

deployment-listener-list

deployment-listener

exposed

login-config

mbean-name

port-component

port-component-name

service-endpoint-address

transport-guarantee

weblogic-webservices

webservice-contextpath

webservice-description

webservice-description-name

webservice-security

webservice-serviceuri

wsdl

wsdl-publish-file

J2EE Web サービスの手動による作成

J2EE Web サービスの作成の概要

EJB 実装の J2EE Web サービスの作成 : 主な手順

ステートレスセッション EJB の簡単な例

サンプルの EJB デプロイメント記述子

ejb-jar.xml

weblogic-ejb-jar.xml

EJB からのサービスエンドポイントインタフェースの作成

ejb-jar.xml デプロイメント記述子の Web サービス情報による更新

EJB 実装の Web サービス用 WSDL ファイルの作成

EJB 実装の Web サービス用デプロイメント記述子ファイルの記述

すべてのアーティファクトの JAR ファイルへのパッケージ化

Java クラス実装の J2EE Web サービスの作成 : 主な手順

Java クラスのプログラミング

サンプルの web.xml デプロイメント記述子

Java クラスからのサービスエンドポイントインタフェースの作成

Java クラス実装の Web サービス用 WSDL ファイルの作成

Java クラス実装の Web サービス用デプロイメント記述子ファイルの記述

すべてのアーティファクトの WAR ファイルへのパッケージ化