27.2. 시작 지점 코드 생성
27.2.1. 개요
Cryostat-WS는 WSDL에 정의된 서비스에서 해당 서비스를 서비스 공급자로 구현할 Java 클래스로의 자세한 매핑을 지정합니다. wsdl:portType
요소에서 정의하는 논리 인터페이스는 서비스 엔드포인트 인터페이스(SEI)에 매핑됩니다. WSDL에 정의된 모든 복잡한 유형은 JAXB(Java Architecture for XML Binding) 사양에 의해 정의된 매핑 뒤에 있는 Java 클래스에 매핑됩니다. wsdl:service
요소에서 정의한 엔드포인트도 사용자가 서비스를 구현하는 서비스 공급자에 액세스하는 데 사용하는 Java 클래스로 생성됩니다.
cxf-codegen-plugin
Maven 플러그인은 이 코드를 생성합니다. 또한 구현을 위한 시작점 코드를 생성하기 위한 옵션을 제공합니다. 코드 생성기는 생성된 코드를 제어하기 위한 다양한 옵션을 제공합니다.
27.2.2. 코드 생성기 실행
예 27.1. “서비스 코드 생성” 코드 생성기를 사용하여 서비스에 대한 시작점 코드를 생성하는 방법을 보여줍니다.
예 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>
이는 다음을 수행합니다.
-
impl
옵션은 WSDL 계약의 각wsdl:portType
요소에 대한 쉘 구현 클래스를 생성합니다. -
-server
옵션은 서비스 공급자를 독립 실행형 애플리케이션으로 실행하는 간단한main()
을 생성합니다. -
sourceRoot
는 생성된 코드가 outputDir 이라는 디렉터리에 작성되도록 지정합니다. -
WSDL
요소는
코드가 생성되는 WSDL 계약을 지정합니다.
코드 생성기에 대한 전체 옵션 목록은 44.2절. “cxf-codegen-plugin” 을 참조하십시오.
27.2.3. 생성된 코드
표 27.1. “서비스 공급자를 위한 생성된 클래스” 서비스 공급자를 생성하기 위해 생성된 파일에 대해 설명합니다.
파일 | 설명 |
---|---|
SEI입니다. 이 파일에는 서비스 공급자가 구현하는 인터페이스가 포함되어 있습니다. 이 파일을 편집해서는 안 됩니다. | |
| 엔드포인트입니다. 이 파일에는 사용자가 서비스에서 요청하는 데 사용하는 Java 클래스가 포함되어 있습니다. |
Skeleton 구현 클래스입니다. 이 파일을 수정하여 서비스 공급자를 빌드합니다. | |
| 서비스 공급자를 독립형 프로세스로 배포할 수 있는 기본 서버 메인라인입니다. 자세한 내용은 31장. 서비스 게시 에서 참조하십시오. |
또한 코드 생성기는 WSDL 계약에 정의된 모든 유형에 대한 Java 클래스를 생성합니다.
27.2.4. 생성된 패키지
생성된 코드는 WSDL 계약에 사용되는 네임스페이스를 기반으로 패키지에 배치됩니다. 서비스를 지원하기 위해 생성된 클래스( wsdl:portType
요소, wsdl:service
요소, wsdl:port
요소)는 WSDL 계약의 대상 네임스페이스를 기반으로 패키지에 배치됩니다. 계약의 유형 요소에 정의된 형식을 구현하기 위해 생성된 클래스는
요소의 types
targetNamespace
특성을 기반으로 패키지에 배치됩니다.
매핑 알고리즘은 다음과 같습니다.
-
선행
http://
또는urn://
는 네임스페이스에서 제거됩니다. -
네임스페이스의 첫 번째 문자열이 유효한 인터넷 도메인인 경우(예:
.com
또는.gov
).
gov로 종료되는 경우 앞에 있는 문자열이 제거되고 나머지 두 구성 요소는 플립됩니다. -
네임스페이스의 최종 문자열이
.xxx
또는.xx
패턴의 파일 확장자로 종료되면 확장자가 제거됩니다. - 네임스페이스의 나머지 문자열은 결과 문자열에 추가되고 점으로 구분됩니다.
- 모든 문자는 소문자로 설정됩니다.