アノテーション型 WebService
@RetentionSE(RUNTIMESE) @TargetSE(TYPESE) public @interface WebService
Java クラスを Web サービスを実装するものとしてマークするか、Java インターフェースを Web サービスインターフェースを定義するものとしてマークします。- 導入:
- 1.6
オプション要素のサマリー
オプション要素 修飾子と型 オプションの要素 説明 StringSE
endpointInterface
サービスの抽象 Web サービス契約を定義するサービスエンドポイントインターフェースの完全な名前。StringSE
name
Web サービスの名前。StringSE
portName
Web サービスのポート名。StringSE
serviceName
Web サービスのサービス名。StringSE
targetNamespace
@WebService.targetNamespace アノテーションがサービスエンドポイントインターフェース上にある場合、wsdl:portType (および関連する XML 要素) の名前空間には targetNamespace が使用されます。StringSE
wsdlLocation
サービスを説明する事前定義された WSDL の場所。
要素の詳細
name
StringSE name
Web サービスの名前。WSDL 1.1 にマップされるときに wsdl:portType の名前として使用されます。
- 戻り値:
- Web サービスの名前
- デフォルト:
- ""
targetNamespace
StringSE targetNamespace
@WebService.targetNamespace アノテーションがサービスエンドポイントインターフェース上にある場合、wsdl:portType (および関連する XML 要素) の名前空間には targetNamespace が使用されます。@WebService.targetNamespace アノテーションが、サービスエンドポイントインターフェース (endpointInterface 属性経由) を参照しないサービス実装 Bean にある場合、wsdl:portType と wsdl:service (および関連する XML 要素) の両方に targetNamespace が使用されます。
@WebService.targetNamespace アノテーションが、サービスエンドポイントインターフェースを参照するサービス実装 Bean (endpointInterface 属性経由) にある場合、targetNamespace は wsdl:service (および関連する XML 要素) にのみ使用されます。
- 戻り値:
targetNamespace
アノテーション
- デフォルト:
- ""
serviceName
StringSE serviceName
Web サービスのサービス名。WSDL 1.1 にマップされるときに、wsdl:service の名前として使用されます。
このメンバー値は、エンドポイントインターフェースでは許可されていません。
- 戻り値:
- サービス名
- デフォルト:
- ""
portName
StringSE portName
Web サービスのポート名。WSDL 1.1 にマップされるときに、wsdl:port の名前として使用されます。
このメンバー値は、エンドポイントインターフェースでは許可されていません。
- 戻り値:
- ポート名
- 導入:
- 2.0
- デフォルト:
- ""
wsdlLocation
StringSE wsdlLocation
サービスを説明する事前定義された WSDL の場所。wsdlLocation は、既存の WSDL ファイルを参照する URL (相対または絶対) です。wsdlLocation 値が存在する場合、サービス実装 Bean が定義済みの WSDL 契約を実装していることを示します。サービス実装 Bean が、この WSDL で宣言されている portType およびバインディングと一致しない場合、JSR-181 ツールはフィードバックを提供する必要があります。1 つの WSDL ファイルに複数の portTypes および複数のバインディングが含まれる場合があることに注意してください。サービス実装 Bean のアノテーションによって、Web サービスに対応する特定の portType およびバインディングが決定されます。
- 戻り値:
- 事前定義された WSDL の場所
- デフォルト:
- ""
endpointInterface
StringSE endpointInterface
サービスの抽象 Web サービス契約を定義するサービスエンドポイントインターフェースの完全な名前。このアノテーションにより、開発者はインターフェース契約を実装から分離できます。このアノテーションが存在する場合、サービスエンドポイントインターフェースは抽象 WSDL 契約 (portType およびバインディング) を決定するために使用されます。サービスエンドポイントインターフェースには、Java から WSDL へのマッピングをカスタマイズするための JSR-181 アノテーションを含めることができます。
サービス実装 Bean はサービスエンドポイントインターフェースを実装できますが、実装する必要はありません。
このメンバー値が存在しない場合は、サービス実装 Bean のアノテーションから Web サービス契約が生成されます。サービスエンドポイントインターフェースがターゲット環境で必要な場合は、実装定義の名前を持つ実装定義パッケージに生成されます。このメンバー値は、エンドポイントインターフェースでは許可されていません。
- 戻り値:
- サービスエンドポイントインターフェースの完全な名前
- デフォルト:
- ""