27.2. 開始点コードの生成

JAX-WS は、WSDL で定義されたサービスからそのサービスをサービスプロバイダーとして実装する Java クラスへの詳細なマッピングを指定します。wsdl:portType 要素で定義される論理インターフェースは、サービスエンドポイントインターフェース (SEI) にマッピングされます。WSDL で定義された複合型は、Java Architecture for XML Binding (JAXB) 仕様で定義されているマッピングに従って Java クラスにマッピングされます。wsdl:service 要素で定義されるエンドポイントも、サービスを実装するサービスプロバイダーにアクセスするためにコンシューマーによって使用される Java クラスに生成されます。

cxf-codegen-plugin Maven プラグインがこのコードを生成します。実装の開始点コードを生成するオプションも提供します。コードジェネレーターには、生成されるコードを制御するためのさまざまなオプションが用意されています。

例27.1「サービスコードの生成」に、コードジェネレーターを使用して、サービスの開始点コードを生成する方法を示します。

<plugin>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-codegen-plugin</artifactId>
    <version>${cxf.version}</version>
    <executions>
        <execution>
            <id>generate-sources</id>
            <phase>generate-sources</phase>
            <configuration>
                <sourceRoot>outputDir</sourceRoot>
                <wsdlOptions>
                    <wsdlOption>
                        <wsdl>wsdl</wsdl>
                        <extraargs>
                            <extraarg>-server</extraarg>
                            <extraarg>-impl</extraarg>
                        </extraargs>
                    </wsdlOption>
                </wsdlOptions>
            </configuration>
            <goals>
                <goal>wsdl2java</goal>
            </goals>
       </execution>
    </executions>
</plugin>

これにより、以下の操作が行われます。

コードジェネレーターのオプションの完全なリストは、「cxf-codegen-plugin」を参照してください。

表27.1「サービスプロバイダー用に生成されるクラス」で、サービスプロバイダを作成するために生成されるファイルについて説明します。

さらに、コードジェネレーターは、WSDL コントラクトで定義されたすべての型の Java クラスを生成します。

生成されたコードは、WSDL コントラクトで使用される namespace に基づいてパッケージに配置されます。(wsdl:portType 要素、wsdl:service 要素、および wsdl:port 要素に基づき) サービスをサポートするために生成されたクラスは、WSDL コントラクトのターゲット namespace に基づいてパッケージに配置されます。コントラクトの types 要素で定義された型を実装するために生成されたクラスは、types 要素の targetNamespace 属性に基づいてパッケージに配置されます。

マッピングアルゴリズムは以下のようになります。