27.2. 시작 지점 코드 생성

JAX-WS는 WSDL에 정의된 서비스에서 해당 서비스를 서비스 공급자로 구현할 Java 클래스에 대한 자세한 매핑을 지정합니다. wsdl:portType 요소에서 정의하는 논리 인터페이스는 서비스 끝점 인터페이스(SEI)에 매핑됩니다. WSDL에 정의된 모든 복잡한 유형은 JAXB(Java Architecture for XML Binding) 사양에 정의된 매핑에 따라 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>

이 작업은 다음을 수행합니다.

코드 생성기에 대한 전체 옵션 목록은 44.2절. “cxf-codegen-plugin” 에서 참조하십시오.

표 27.1. “서비스 공급자를 위한 생성된 클래스” 서비스 공급자를 생성하기 위해 생성된 파일을 설명합니다.

또한 코드 생성기는 WSDL 계약에 정의된 모든 형식에 대해 Java 클래스를 생성합니다.

생성된 코드는 WSDL 계약에 사용되는 네임스페이스를 기반으로 패키지에 배치됩니다. 서비스를 지원하도록 생성된 클래스( wsdl:portType 요소, wsdl:service 요소 및 wsdl:port 요소)는 WSDL 계약의 대상 네임스페이스를 기반으로 하는 패키지에 배치됩니다. 계약의 형식 요소에 정의된 형식을 구현하기 위해 생성된 클래스는 types 요소의 targetNamespace 특성을 기반으로 패키지에 배치됩니다.

매핑 알고리즘은 다음과 같습니다.