Web サービスのエンドポイントのパブリッシュ

javax.xml.ws.Endpoint API を使用すると、Web サービスを WebLogic Server インスタンスにデプロイすることなく、実行時に Web サービスのエンドポイントを作成できます。

次の表に、Web サービスのエンドポイントをパブリッシュする手順をまとめます。

手順

説明

Web サービスのエンドポイントを作成する。

javax.xml.ws.Endpoint の create() メソッドを使用してエンドポイントを作成し、エンドポイントを関連付けるインプリメンタ (Web サービス実装) を指定します。また、必要に応じてバインディングタイプも指定します。何も指定しない場合、バインディングのデフォルトは SOAP1.1/HTTP になります。エンドポイントは、実行時の定義に従い、1 つの実装オブジェクトと 1 つの javax.xml.ws.Binding にのみ関連付けます。これらの値は変更できません。

たとえば次の例では、CallbackWS() 実装の Web サービスエンドポイントが作成されます。

Endpoint callbackImpl = Endpoint.create(new CallbackWS());

受信した要求を受け入れるため、Web サービスのエンドポイントをパブリッシュする。

javax.xml.ws.Endpoint の publish() メソッドを使用して、サーバコンテキストを指定するか、Web サービスエンドポイントのアドレスとインプリメンタ (必要に応じて) を指定します。

注意 :

エンドポイントに関連付けられているメタデータドキュメント (WSDL または XML スキーマ) を更新したい場合は、エンドポイントをパブリッシュする前に更新する必要があります。

たとえば次の例では、手順 1 でサーバコンテキストを使用して作成した Web サービスエンドポイントがパブリッシュされます。

Object sc
context.getMessageContext().get(MessageContext.SERVLET_CONTEXT);
callbackImpl.publish(sc)

;

Web サービスのエンドポイントを停止して、処理完了後に追加の要求が受け入れられないようにする。

javax.xml.ws.Endpoint の stop() メソッドを使用してエンドポイントを停止し、受信した要求の受け入れを停止します。いったん停止したエンドポイントをパブリッシュし直すことはできません。

次に例を示します。

callbackImpl.stop()

上の表に示した手順に加え、javax.xml.ws.Endpoint API のメソッドを使用して以下を定義することもできます。

詳細については、Javadoc の「javax.xml.ws.Endpoint」を参照してください。

JAX-WS を使用した WebLogic Web サービスの高度な機能のプログラミング

Web サービスのエンドポイントのパブリッシュ