javax.xml.ws
クラス Endpoint

java.lang.Object
  javax.xml.ws.Endpoint

public abstract class Endpoint
extends Object

Web サービス端点。

端点は、このクラスに定義された static メソッドを使用して作成されます。端点は常に 1 つの Binding と 1 つの implementor に結合され、端点の作成時にこの両方が設定されます。

端点は、発行または未発行のいずれかの状態を取ります。publish メソッドは、端点の発行を開始するために使用できます。発行が開始されると、着信要求の受け入れが開始されます。逆に、stop メソッドを使用すると、着信要求の受け入れを中止し、端点を停止させることができます。停止後、端点を再び発行することはできません。

着信要求をディスパッチするために使用されるスレッドをより強力に制御するため、Executor が端点に設定されることもあります。たとえば、ThreadPoolExecutor を作成し、端点にそれを登録することによって、特定のパラメータを持つスレッドプールを有効にすることができます。

包含する Binding を使用して、ハンドラチェーンを設定することができます。

端点は、それにバインドされているメタデータ文書 (WSDL、XMLSchema 文書など) のリストを含むことがあります。発行時に、JAX-WS 実装は、implementor に存在する注釈に基づいて新規生成するのではなく、メタデータのできるだけ多くを再利用しようとします。

導入されたバージョン:

JAX-WS 2.0

関連項目:

Binding, BindingType, SOAPBinding, Executor

フィールドの概要

static String	WSDL_PORT 標準プロパティー:WSDL ポートの名前。
static String	WSDL_SERVICE 標準プロパティー:WSDL サービスの名前。

コンストラクタの概要

Endpoint()

メソッドの概要

static Endpoint	create(Object implementor) 指定された implementor オブジェクトを持つ端点を作成します。
static Endpoint	create(String bindingId, Object implementor) 指定されたバインディング型と implementor オブジェクトを使用して端点を作成します。
abstract Binding	getBinding() この端点のバインディングを返します。
abstract Executor	getExecutor() この Endpoint インスタンスの Executor を返します。
abstract Object	getImplementor() この端点の実装オブジェクトを返します。
abstract List<Source>	getMetadata() サービスのメタデータ文書リストを返します。
abstract Map<String,Object>	getProperties() この Endpoint インスタンスのプロパティーバッグを返します。
abstract boolean	isPublished() 端点が発行されている状態の場合、true を返します。
abstract void	publish(Object serverContext) 指定されたサーバーコンテキストでこの端点を発行します。
abstract void	publish(String address) 指定されたアドレスでこの端点を発行します。
static Endpoint	publish(String address, Object implementor) 指定されたアドレスで、指定された implementor オブジェクトの端点を作成および発行します。
abstract void	setExecutor(Executor executor) この Endpoint インスタンスの executor を設定します。
abstract void	setMetadata(List<Source> metadata) この端点のメタデータを設定します。
abstract void	setProperties(Map<String,Object> properties) この Endpoint インスタンスのプロパティーバッグを設定します。
abstract void	stop() 発行中のこの端点を停止します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

WSDL_SERVICE

public static final String WSDL_SERVICE

標準プロパティー:WSDL サービスの名前。

型:javax.xml.namespace.QName

関連項目:

定数フィールド値

WSDL_PORT

public static final String WSDL_PORT

標準プロパティー:WSDL ポートの名前。

型:javax.xml.namespace.QName

関連項目:

定数フィールド値

コンストラクタの詳細

Endpoint

public Endpoint()

メソッドの詳細

create

public static Endpoint create(Object implementor)

指定された implementor オブジェクトを持つ端点を作成します。BindingType 注釈を介して指定されたバインディングがある場合、それを使用しなければならず、そうでない場合、デフォルトの SOAP 1.1 / HTTP バインディングを使用しなければなりません。

新しく作成された端点は、javax.xml.ws.Endpoint#publish(String) および javax.xml.ws.Endpoint#publish(Object) メソッドのいずれかを呼び出すことによって発行できます。

パラメータ:

implementor - 端点の implementor

戻り値:

新しく作成された端点

create

public static Endpoint create(String bindingId,
                              Object implementor)

指定されたバインディング型と implementor オブジェクトを使用して端点を作成します。

新しく作成された端点は、javax.xml.ws.Endpoint#publish(String) および javax.xml.ws.Endpoint#publish(Object) メソッドのいずれかを呼び出すことによって発行できます。

パラメータ:

bindingId - 使用するバインディングを指定する URI。bindingID が null で、BindingType 注釈を介してバインディングが指定されていない 場合、デフォルトの SOAP 1.1 / HTTP バインディングを使用する必要がある

implementor - 端点の implementor

戻り値:

新しく作成された端点

getBinding

public abstract Binding getBinding()

この端点のバインディングを返します。

戻り値:

この端点のバインディング

getImplementor

public abstract Object getImplementor()

この端点の実装オブジェクトを返します。

戻り値:

この端点の implementor

publish

public abstract void publish(String address)

指定されたアドレスでこの端点を発行します。必要なサーバーインフラストラクチャーは、JAX-WS 実装により、デフォルト設定を使用して作成および設定されます。サーバー設定をより強力に制御するには、javax.xml.ws.Endpoint#publish(Object) メソッドを代わりに使用してください。

パラメータ:

address - 使用するアドレスを指定する URI。このアドレスは、 端点作成時に指定したバインディングに対応 していなくてはならない

例外:

IllegalArgumentException - 指定したアドレス URI を端点のバインディングとともに 使用できない場合

IllegalStateException - 端点が既に発行されている、または、既に停止されている場合

publish

public static Endpoint publish(String address,
                               Object implementor)

指定されたアドレスで、指定された implementor オブジェクトの端点を作成および発行します。

必要なサーバーインフラストラクチャーは、JAX-WS 実装により、デフォルト設定を使用して作成および設定されます。 サーバー設定をより強力に制御するには、javax.xml.ws.Endpoint#create(String,Object) および javax.xml.ws.Endpoint#publish(Object) メソッドを代わりに使用してください。

パラメータ:

address - 使用するアドレス、および、トランスポートまたはプロトコルを 指定する URI。http: URI が、使用されている SOAP 1.1/HTTP バインディング に帰着する必要がある。実装がその他の URI スキーマをサポート することも可能である

implementor - 端点の implementor

戻り値:

新しく作成された端点

publish

public abstract void publish(Object serverContext)

指定されたサーバーコンテキストでこの端点を発行します。サーバーコンテキストは、サーバーインフラストラクチャーおよび特定のトランスポートのアドレッシング情報をカプセル化します。このメソッドの呼び出しを成功させるには、それに引数として渡されるサーバーコンテキストが端点のバインディングと互換性がなくてはなりません。

パラメータ:

serverContext - 端点を発行するために使用される サーバーコンテキストを表すオブジェクト

例外:

IllegalArgumentException - 指定されたサーバーコンテキストが実装によって サポートされていない、または、端点の バインディングとともに使用できないことが 判明した場合

IllegalStateException - 端点が既に発行されている、または、既に停止されている場合

stop

public abstract void stop()

発行中のこの端点を停止します。 端点が発行されていない場合、このメソッドは何もしません。

isPublished

public abstract boolean isPublished()

端点が発行されている状態の場合、true を返します。

戻り値:

端点が発行されている状態の場合、true

getMetadata

public abstract List<Source> getMetadata()

サービスのメタデータ文書リストを返します。

戻り値:

List<javax.xml.transform.Source> サービスのメタデータ文書のリスト

setMetadata

public abstract void setMetadata(List<Source> metadata)

この端点のメタデータを設定します。

パラメータ:

metadata - 端点のメタデータ情報を含む XML 文書ソース (WSDL または XML Schema 文書など) のリスト

例外:

IllegalStateException - 端点が 既に発行されている場合

getExecutor

public abstract Executor getExecutor()

この Endpoint インスタンスの Executor を返します。 Executor は、着信要求を implementor オブジェクトにディスパッチするために使用されます。

戻り値:

要求をディスパッチするために使用される java.util.concurrent.Executor

関連項目:

Executor

setExecutor

public abstract void setExecutor(Executor executor)

この Endpoint インスタンスの executor を設定します。 Executor は、着信要求を implementor オブジェクトにディスパッチするために使用されます。 この Endpoint が publish(Object) メソッドを使用して発行され、指定したサーバーコンテキストがそれ自身のスレッド処理動作を定義している場合、Executor は無視されることがあります。

パラメータ:

executor - 要求をディスパッチするために使用される java.util.concurrent.Executor

例外:

SecurityException - セキュリティー上の理由により、インスタンスが Executor を設定することをサポートしていない場合 (たとえば、 必要なアクセス権が不足している場合)

関連項目:

Executor

getProperties

public abstract Map<String,Object> getProperties()

この Endpoint インスタンスのプロパティーバッグを返します。

戻り値:

Map<String,Object>。このインスタンスに 関連付けられているプロパティーバッグ

setProperties

public abstract void setProperties(Map<String,Object> properties)

この Endpoint インスタンスのプロパティーバッグを設定します。

パラメータ:

properties - このインスタンスに関連付けられている プロパティーバッグ