@xml

이 복합 특성 @xml에는 웹(SOAP) 서비스의 런타임 액세스에 영향을 주는 데이터가 있습니다. 서비스 파트, 인터페이스 파트, 서비스 파트와 인터페이스 파트의 함수에서 이 특성을 사용할 수 있습니다.

@xml 특성은 다음 경우에 유용합니다.
  • WSDL 파일을 작성 중이고 WSDL 파일을 수신할 사람들에게 사용자 조직의 이름 지정 규칙을 노출하고 싶지 않습니다.
  • WSDL 파일에서 인터페이스 파트를 작성 중이고 제공된 이름 이외의 EGL 패키지 이름을 사용하고 싶습니다. 이 특성은 WSDL 파일에서 복사된 이름이 EGL에서 올바르지 않은 경우에도 유용합니다.
@xml 특성에는 다음 특성 필드가 포함되어 있으며 해당 필드에 대해서는 이 주제에서 나중에 자세히 설명합니다.
이름
이름 쌍을 맵핑하는 문자열입니다.
  • EGL 서비스 또는 인터페이스 파트의 경우 이 쌍은 EGL 서비스 또는 인터페이스 파트의 이름과 WSDL 문서에서 해당 portType 요소의 이름입니다.
  • EGL 함수의 경우 이 쌍은 EGL 함수의 이름과 WSDL 문서에서 해당 조작 요소의 이름입니다.
네임스페이스
이름 쌍을 맵핑하는 문자열입니다.
  • EGL 서비스 또는 인터페이스 파트의 경우 이 쌍은 EGL 패키지의 이름과 WSDL 문서에서 대상 네임스페이스의 이름입니다.
  • EGL 함수의 경우 네임스페이스 특성은 무시됩니다.
자세한 설명은 다음과 같습니다.
  • EGL 서비스 파트에서 WSDL 파일을 작성하는 경우(웹 서비스를 생성하는 경우 이와 같이 발생함) 기본 동작은 다음과 같습니다.
    • portType 요소에 EGL 서비스의 이름이 지정됩니다.
    • WSDL 파일의 대상 네임스페이스에 EGL 패키지의 이름이 역순으로 http:// 접두부와 함께 지정됩니다. 예를 들어, 패키지 이름이 com.ibm.egl.mypkg인 경우 WSDL 파일의 대상 네임스페이스는 http://mypkg.egl.ibm.com입니다.

    @xml 특성을 추가하여 portType 요소의 이름을 지정하거나(이름 특성 필드 사용), WSDL 문서의 대상 네임스페이스를 지정하거나(네임스페이스 특성 필드 사용), 둘 다 지정할 수 있습니다.

    EGL 웹 서비스의 WSDL에서 생성된 엔드포인트의 기본값은 http://localhost:9081입니다. 사용자 시스템에서 사용 중인 서버 포트와 일치하도록 WSDL 파일을 수동으로 변경해야 할 수 있습니다. 사용 중인 서버 포트에 대한 세부사항은 서버 문서를 참조하십시오.

  • EGL 도구가 WSDL 문서에서 인터페이스 파트를 작성하는 경우 기본 동작은 다음과 같습니다.
    • WSDL 문서의 portType 요소에서 인터페이스 파트의 이름을 가져옵니다.
    • WSDL 문서의 대상 네임스페이스에서 EGL 패키지의 이름을 가져옵니다. 도구는 작성된 EGL 파일에 패키지 이름을 포함하며 필요한 경우 패키지 자체를 작성합니다.

      이 경우 도구는 접두부 http://가 있는 경우 이를 제거하고 순서를 되돌립니다. 예를 들어, 대상 네임스페이스가 http://mypkg.egl.ibm.com인 경우 EGL 도구는 EGL 패키지 이름을 com.ibm.egl.mypkg로 작성합니다.

     EGL에서 이름이 올바르지 않은 경우가 있습니다. 이런 경우 EGL 도구가 올바른 이름을 작성하고 @xml 특성을 사용하여 WSDL 문서에 있는 이름을 식별합니다. 이 특성은 이름이 일치하지 않아도 서비스 호출에 성공하도록 합니다.

    EGL 도구를 사용하여 인터페이스 파트와 패키지에 지정한 이름을 변경할 수 있습니다.

EGL 서비스 또는 인터페이스 파트의 함수는 WSDL portType 요소에 임베디드된 조작 요소를 나타냅니다. 이 경우 워크벤치 처리에서 조작 요소의 대상 네임스페이스를 고려하지 않습니다. 해당 네임스페이스가 portType 요소의 네임스페이스와 동일할 것으로 가정합니다. 그러나 WSDL 파일에서 조작 요소의 이름은 중요합니다.
  • WSDL 파일을 작성할 때 @xml 특성의 이름 특성 필드에서 조작 이름을 가져옵니다. 기본값은 EGL 함수 이름입니다.
  • EGL 도구가 WSDL 문서에서 인터페이스 파트를 작성 중이고 조작 이름이 EGL에서 올바르지 않은 경우 EGL 도구는 EGL 함수의 다른 이름을 작성하지만 이름 특성을 사용하여 조작 요소의 이름을 유지합니다.