public abstract class Endpoint extends Object
端点は、このクラスに定義されたstaticメソッドを使用して作成されます。 端点は常に1つのBinding
と1つのimplementorに結合され、端点の作成時にこの両方が設定されます。
端点は、発行または未発行のいずれかの状態をとります。 publish
メソッドは、端点の発行を開始するために使用できます。発行が開始されると、着信要求の受入れが開始されます。 逆に、stop
メソッドを使用すると、着信要求の受入れを中止し、端点を停止させることができます。 停止後、端点を再び発行することはできません。
着信要求をディスパッチするために使用されるスレッドをより強力に制御するため、Executor
が端点に設定されることもあります。 たとえば、ThreadPoolExecutor
を作成し、端点にそれを登録することによって、特定のパラメータを持つスレッド・プールを有効にすることができます。
包含するBinding
を使用して、ハンドラ・チェーンを設定することができます。
端点は、それにバインドされているメタデータ文書(WSDL、XMLSchema文書など)のリストを含むことがあります。 発行時に、JAX-WS実装は、implementorに存在する注釈に基づいて新規生成するのではなく、メタデータのできるだけ多くを再利用しようとします。
Binding
, BindingType
, SOAPBinding
, Executor
修飾子と型 | フィールド | 説明 |
---|---|---|
static String |
WSDL_PORT |
標準プロパティ: WSDLポートの名前。
|
static String |
WSDL_SERVICE |
標準プロパティ: WSDLサービスの名前。
|
コンストラクタ | 説明 |
---|---|
Endpoint() |
修飾子と型 | メソッド | 説明 |
---|---|---|
static Endpoint |
create(Object implementor) |
指定されたimplementorオブジェクトを持つ端点を作成します。
|
static Endpoint |
create(Object implementor, WebServiceFeature... features) |
指定されたimplementorオブジェクトおよびWebサービス機能を持つ端点を作成します。
|
static Endpoint |
create(String bindingId, Object implementor) |
指定されたバインディング型とimplementorオブジェクトを使用して端点を作成します。
|
static Endpoint |
create(String bindingId, Object implementor, WebServiceFeature... features) |
指定されたバインディング・タイプ、実装オブジェクト、およびWebサービス機能を持つ端点を作成します。
|
abstract Binding |
getBinding() |
この端点のバインディングを返します。
|
abstract <T extends EndpointReference> |
getEndpointReference(Class<T> clazz, Element... referenceParameters) |
この
Endpoint インスタンスに関連付けられたEndpointReference を返します。 |
abstract EndpointReference |
getEndpointReference(Element... referenceParameters) |
この
Endpoint インスタンスに関連付けられたEndpointReference を返します。 |
abstract Executor |
getExecutor() |
この
Endpoint インスタンスのexecutorを返します。 |
abstract Object |
getImplementor() |
この端点の実装オブジェクトを返します。
|
abstract List<Source> |
getMetadata() |
サービスのメタデータ文書リストを返します。
|
abstract Map<String,Object> |
getProperties() |
この
Endpoint インスタンスのプロパティ・バッグを返します。 |
abstract boolean |
isPublished() |
端点が発行されている状態の場合、trueを返します。
|
void |
publish(HttpContext serverContext) |
指定されたサーバー・コンテキストでこの端点を発行します。
|
abstract void |
publish(Object serverContext) |
指定されたサーバー・コンテキストでこの端点を発行します。
|
abstract void |
publish(String address) |
指定されたアドレスでこの端点を発行します。
|
static Endpoint |
publish(String address, Object implementor) |
指定されたアドレスで、指定されたimplementorオブジェクトの端点を作成および発行します。
|
static Endpoint |
publish(String address, Object implementor, WebServiceFeature... features) |
指定されたアドレスで、指定されたimplementorオブジェクトの端点を作成および発行します。
|
void |
setEndpointContext(EndpointContext ctxt) |
EndpointContext を設定することによって、JAX-WSランタイムはアプリケーション内のほかの端点のアドレスを認識します。 |
abstract void |
setExecutor(Executor executor) |
この
Endpoint インスタンスのexecutorを設定します。 |
abstract void |
setMetadata(List<Source> metadata) |
この端点のメタデータを設定します。
|
abstract void |
setProperties(Map<String,Object> properties) |
この
Endpoint インスタンスのプロパティ・バッグを設定します。 |
abstract void |
stop() |
発行中のこの端点を停止します。
|
public static final String WSDL_SERVICE
型: javax.xml.namespace.QName
public static Endpoint create(Object implementor)
新しく作成された端点は、publish(String)
およびpublish(Object)
メソッドのいずれかを呼び出すことによって発行できます。
implementor
- 端点の実装者。public static Endpoint create(Object implementor, WebServiceFeature... features)
新しく作成された端点は、publish(String)
およびpublish(Object)
メソッドのいずれかを呼び出すことによって発行できます。
implementor
- 端点の実装者。features
- 端点に構成するWebServiceFeatureのリスト。 features
パラメータに含まれていないサポートされる機能には、デフォルト値が設定される。 public static Endpoint create(String bindingId, Object implementor)
新しく作成された端点は、publish(String)
およびpublish(Object)
メソッドのいずれかを呼び出すことによって発行できます。
bindingId
- 使用するバインディングを指定するURI。 bindingIDがnull
で、BindingType注釈を介してバインディングが指定されていない場合は、デフォルトのSOAP 1.1 /HTTPバインディングを使用する必要がある。 implementor
- 端点の実装者。public static Endpoint create(String bindingId, Object implementor, WebServiceFeature... features)
新しく作成された端点は、publish(String)
およびpublish(Object)
メソッドのいずれかを呼び出すことによって発行できます。
bindingId
- 使用するバインディングを指定するURI。 bindingIDがnull
で、BindingType注釈を介してバインディングが指定されていない場合は、デフォルトのSOAP 1.1 /HTTPバインディングを使用する必要がある。 implementor
- 端点の実装者。features
- 端点に構成するWebServiceFeatureのリスト。 features
パラメータに含まれていないサポートされる機能には、デフォルト値が設定される。 public abstract Binding getBinding()
public abstract Object getImplementor()
public abstract void publish(String address)
publish(Object)
メソッドを代わりに使用してください。 address
- 使用するアドレスを指定するURI。 このアドレスは、端点作成時に指定したバインディングに対応していなくてはならない。 IllegalArgumentException
- 指定したアドレスURIを端点のバインディングとともに使用できない場合。IllegalStateException
- 端点がすでに発行されている、または、すでに停止されている場合。SecurityException
- java.lang.SecurityManger
が使用されている場合で、アプリケーションにWebServicePermission("publishEndpoint")
アクセス権がないとき。public static Endpoint publish(String address, Object implementor)
必要なサーバー・インフラストラクチャは、JAX-WS実装により、デフォルト設定を使用して作成および構成されます。 サーバー構成をより詳細に制御するには、create(String,Object)
メソッドおよびpublish(Object)
メソッドを代わりに使用してください。
address
- 使用するアドレス、および、トランスポートまたはプロトコルを指定するURI。 http: URIが、使用されているSOAP 1.1/HTTPバインディングに帰着する必要がある。 実装がその他のURIスキームをサポートすることも可能である。 implementor
- 端点の実装者。SecurityException
- java.lang.SecurityManger
が使用されている場合で、アプリケーションにWebServicePermission("publishEndpoint")
アクセス権がないとき。public static Endpoint publish(String address, Object implementor, WebServiceFeature... features)
必要なサーバー・インフラストラクチャは、JAX-WS実装により、デフォルト設定を使用して作成および構成されます。 サーバー構成をより詳細に制御するには、create(String,Object)
メソッドおよびpublish(Object)
メソッドを代わりに使用してください。
address
- 使用するアドレス、および、トランスポートまたはプロトコルを指定するURI。 http: URIが、使用されているSOAP 1.1/HTTPバインディングに帰着する必要がある。 実装がその他のURIスキームをサポートすることも可能である。 implementor
- 端点の実装者。features
- 端点に構成するWebServiceFeatureのリスト。 features
パラメータに含まれていないサポートされる機能には、デフォルト値が設定される。 SecurityException
- java.lang.SecurityManger
が使用されている場合で、アプリケーションにWebServicePermission("publishEndpoint")
アクセス権がないとき。public abstract void publish(Object serverContext)
serverContext
- 端点を発行するために使用されるサーバー・コンテキストを表すオブジェクト。IllegalArgumentException
- 指定されたサーバー・コンテキストが実装によってサポートされていない、または、端点のバインディングとともに使用できないことが判明した場合。IllegalStateException
- 端点がすでに発行されている、または、すでに停止されている場合。SecurityException
- java.lang.SecurityManger
が使用されている場合で、アプリケーションにWebServicePermission("publishEndpoint")
アクセス権がないとき。public void publish(HttpContext serverContext)
これは、コンテナ開発者が端点を移植性の高い方法で発行するためのものであり、エンド開発者向けのものではありません。
serverContext
- 端点を発行するために使用されるサーバー・コンテキストを表すオブジェクト。IllegalArgumentException
- 指定されたサーバー・コンテキストが実装によってサポートされていない、または、端点のバインディングとともに使用できないことが判明した場合。IllegalStateException
- 端点がすでに発行されている、または、すでに停止されている場合。SecurityException
- java.lang.SecurityManger
が使用されている場合で、アプリケーションにWebServicePermission("publishEndpoint")
アクセス権がないとき。public abstract void stop()
public abstract boolean isPublished()
true
。public abstract List<Source> getMetadata()
List<javax.xml.transform.Source>
- サービスのメタデータ文書リストpublic abstract void setMetadata(List<Source> metadata)
metadata
- 端点のメタデータ情報を含むXML文書ソース(WSDLまたはXMLスキーマ文書など)のリストIllegalStateException
- 端点がすでに発行されている場合。public abstract Executor getExecutor()
Endpoint
インスタンスのexecutorを返します。 executorは、着信要求をimplementorオブジェクトにディスパッチするために使用されます。 java.util.concurrent.Executor
。Executor
public abstract void setExecutor(Executor executor)
Endpoint
インスタンスのexecutorを設定します。 executorは、着信要求をimplementorオブジェクトにディスパッチするために使用されます。 このEndpoint
がpublish(Object)
メソッドを使用して発行され、指定したサーバー・コンテキストがそれ自身のスレッド処理動作を定義している場合、executorは無視されることがあります。 executor
- 要求をディスパッチするために使用されるjava.util.concurrent.Executor
。SecurityException
- セキュリティ上の理由により、インスタンスがexecutorを設定することをサポートしていない場合(たとえば、必要なアクセス権が不足している場合)。Executor
public abstract Map<String,Object> getProperties()
Endpoint
インスタンスのプロパティ・バッグを返します。public abstract void setProperties(Map<String,Object> properties)
Endpoint
インスタンスのプロパティ・バッグを設定します。properties
- このインスタンスに関連付けられているプロパティ・バッグ。public abstract EndpointReference getEndpointReference(Element... referenceParameters)
Endpoint
インスタンスに関連付けられたEndpointReference
を返します。
このbindingProvider
のバインディングがSOAP1.1/HTTPまたはSOAP1.2/HTTPの場合は、W3CEndpointReference
を返す必要があります。
referenceParameters
- 返されるEndpointReference
インスタンスに関連付けられる参照パラメータ。Endpoint
インスタンスのEndpointReference。 返されるEndpointReference
がW3CEndpointReference
型の場合は、指定されたreferenceParameters
を含む必要がある。 WebServiceException
- EndpointReference
の作成でエラーが発生した場合、またはEndpoint
が発行されている状態でない場合。UnsupportedOperationException
- このBindingProvider
がXML/HTTPバインディングを使用している場合。W3CEndpointReference
public abstract <T extends EndpointReference> T getEndpointReference(Class<T> clazz, Element... referenceParameters)
Endpoint
インスタンスに関連付けられたEndpointReference
を返します。clazz
- 取得する必要のあるEndpointReferenceの型を指定する。referenceParameters
- 返されるEndpointReference
インスタンスに関連付けられる参照パラメータ。Endpoint
インスタンスのclazz
型のEndpointReference。 返されるEndpointReference
がW3CEndpointReference
型の場合は、指定されたreferenceParameters
を含む必要がある。 WebServiceException
- EndpointReference
の作成でエラーが発生した場合、Endpoint
が発行されている状態でない場合、またはEndpointReference
の型としてclazz
がサポートされていない場合。UnsupportedOperationException
- このBindingProvider
がXML/HTTPバインディングを使用している場合。public void setEndpointContext(EndpointContext ctxt)
EndpointContext
を設定することによって、JAX-WSランタイムはアプリケーション内のほかの端点のアドレスを認識します。 複数の端点がWSDLの異なるポートを共有する場合、WSDLにアクセスすると、複数のポート・アドレスにパッチが適用されます。
端点を発行する前に設定する必要があります。
ctxt
- 複数の端点で共有されるIllegalStateException
- 端点がすでに発行されている、または、すでに停止されている場合。 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。