SOAP 서비스에 액세스하기 위한 인터페이스 파트 작성
EGL 인터페이스 파트에는 각각 서비스에서 사용 가능한 조작을 식별하는 하나 이상의 함수 프로토타입이 포함되어 있습니다.
다음 예제에 표시되어 있는 바와 같이, 함수 프로토타입에는 종료 세미콜론(;)이 있으며 함수 이름, 매개변수 목록 및 리턴 유형(선택사항)을 포함합니다.
Interface WeatherForecast
Function GetWeatherByZipCode(zipcode string in) returns(myRecordPart);
end
SOAP 서비스와 관련하여, 함수 프로토타입은 수정자 IN, INOUT 또는 OUT이 있는 매개변수를 포함할 수 있습니다.
WSDL 파일로부터 인터페이스 파트를 작성하려면 다음 작업을 수행하십시오.
- 웹 서비스의 WSDL 파일을 EGL 소스 폴더에 있는, 이름이 wsdl인 하위 폴더 등으로 가져오십시오.
- 프로젝트 탐색기 보기에서 WSDL 파일을 마우스 오른쪽 단추로 클릭하고 EGL 클라이언트 인터페이스 작성을 클릭하십시오. 첫 번째 새 EGL 인터페이스 페이지가 표시됩니다.
- 인터페이스 파트 작성 기반으로 사용할 웹 서비스를 선택하십시오. 웹 서비스에 대한 SOAP 서비스 바인딩을 작성하려는 경우에는 SOAP 서비스 바인딩 작성을 클릭하십시오.
- 다음을 클릭하여 두 번째 새 EGL 인터페이스 페이지를 표시하십시오.
- 선택한 웹 서비스와 관련된 WSDL 파일 portType 항목에 대해 다음 단계를 완료하십시오.
- 새 인터페이스 파트의 이름을 수락하거나 업데이트하십시오.
- 선택란을 선택하거나 선택 취소하여 새 인터페이스 파트에 표시될 portType 항목의 조작을 지정하십시오.
- 소스 폴더, 패키지 및 EGL 소스 파일 이름 필드에서 새 인터페이스 파트를 포함할 파일의 위치 및 이름을 설정하십시오.
- Rich UI 애플리케이션에서 이 인터페이스 파트를 참조하려는 경우에는 Rich UI 애플리케이션과 호환되도록 인터페이스 파트 및 데이터 작성을 선택하십시오.
- 이름이 같은 EGL 파일을 겹쳐쓰려는 경우에는 기존 파일 겹쳐쓰기를 선택하십시오.
- SOAP 서비스 바인딩을 작성하지 않도록 설정한 경우에는 완료를 클릭하십시오. 그렇지 않은 경우에는 다음을 클릭하여 "새 EGL SOAP 서비스 바인딩" 페이지를 표시하십시오.
- 소스 폴더 필드가 EGL 배치 디스크립터의 위치를 식별하는지 확인하십시오.
- EGL 배치 디스크립터 파일 이름 필드에서 서비스 바인딩을 추가하는 EGL 배치 디스크립터의 이름을 선택하십시오.
- 이 파일에 이미 있는 서비스 바인딩 세부사항을 업데이트하려면 모든 기존 바인딩을 업데이트를 선택하십시오.
- WSDL 파일 포트 항목의 테이블에서, 인터페이스 파트를 작성하는 기반으로 삼을 WSDL 파일 portType 항목을 참조하는 항목을 선택하십시오.
- 바인딩 이름 열에서 기본값(WSDL 파일에 있는 portType 항목의 이름)을 수락하거나 다른 이름을 입력하십시오.
이 이름은 서비스 액세스 변수를 선언하고 @BindService 특성 bindingKey 필드를 설정할 때 지정합니다.
- 완료를 클릭하십시오.
앞서 제시된 단계에 따라 인터페이스 파트를 작성할 때는 인터페이스 파트를 저장하고 있는 파일에 기록된 모든 주석을 기록해 두십시오.
이러한 주석은 서비스 액세스에 대한 세부사항을 지정할 때 유용할 수 있는 복합 특성을 나타냅니다. 이러한 세부사항은 다음 두 경우 중 하나에서 지정합니다.
- 인터페이스 파트를 기반으로 하는 서비스 액세스 변수를 작성할 때
- EGL 배치 디스크립터에 서비스 바인딩을 작성할 때(선행 단계에서 이를 수행하지 않은 경우)
WSDL 파일로부터 복사되는 이름이 EGL에서 유효하지 않은 경우에는 파트를 작성하는 것이 유용합니다. WSDL 파일로부터 파생되지 않은 EGL 패키지 이름을 사용하려는 경우에도 파트를 작성하는 것이 좋습니다. 세부사항은 "@xml"을 참조하십시오.