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

マッピングアルゴリズムは次のとおりです。