パッケージ jakarta.jws

アノテーション型 WebService


  • @RetentionSE(RUNTIMESE)
    @TargetSE(TYPESE)
    public @interface WebService
    Java クラスを Web サービスを実装するものとしてマークするか、Java インターフェースを Web サービスインターフェースを定義するものとしてマークします。
    導入:
    1.6
    • オプション要素のサマリー

      オプション要素  
      修飾子と型 オプションの要素 説明
      StringSEendpointInterface
      サービスの抽象 Web サービス契約を定義するサービスエンドポイントインターフェースの完全な名前。
      StringSEname
      Web サービスの名前。
      StringSEportName
      Web サービスのポート名。
      StringSEserviceName
      Web サービスのサービス名。
      StringSEtargetNamespace
      @WebService.targetNamespace アノテーションがサービスエンドポイントインターフェース上にある場合、wsdl:portType (および関連する XML 要素) の名前空間には targetNamespace が使用されます。
      StringSEwsdlLocation
      サービスを説明する事前定義された 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 サービス契約が生成されます。サービスエンドポイントインターフェースがターゲット環境で必要な場合は、実装定義の名前を持つ実装定義パッケージに生成されます。

        このメンバー値は、エンドポイントインターフェースでは許可されていません。

        戻り値:
        サービスエンドポイントインターフェースの完全な名前
        デフォルト:
        ""