웹 서비스 애플리케이션에 대한 알려진 문제점 및 제한사항
WebSphere® Developer Tools를 사용하여 작업하는 경우 다양한 알려진 문제점과 제한사항이 적용됩니다. 그 중에서도 특히 보안 WebSphere Application Server를 사용하고 웹 서비스 마법사를 사용할 때 문제가 있습니다.
제한사항 및 문제점 해결 팁에 대한 자세한 정보는 WebSphere Application Server Developer Tools for Eclipse Beta에 대한 알려진 문제점 및 제한사항의 내용을 참조하십시오.
웹 서비스 작업 중에 고려해야 할 제한사항은 다음과 같은 절로 구분됩니다.웹 서비스의 일반 제한사항
테스트 클라이언트 JSP를 사용하면, 비동기 호출 사용을 선택한 후 서비스를 호출하는 경우 응답 클래스가 정의되지 않았습니다.라는 오류 메시지가 표시됩니다.
동기식으로 서비스를 테스트하여 문제점을 해결할 수 있습니다.
Liberty가 UDDI에의 공개를 지원하지 않습니다. 그러나 웹 서비스 공개가 웹 서비스 마법사에서 여전히 선택됩니다.
이 문제점을 해결할 수 있습니다. 웹 서비스 공개 선택 선택을 선택 취소하십시오. 웹 서비스 공개 페이지가 여전히 표시됩니다. 이 페이지에서 모든 선택란을 선택 취소하십시오.
기본적으로 Liberty는 씬 클라이언트를 지원하지 않습니다.
이 문제점을 해결할 수 있습니다. 씬 클라이언트에 대한 지원을 추가하기 위해 WebSphere Application Server traditional을 설치하고 runtimes 폴더에서 씬 클라이언트 JAR 파일을 얻을 수 있습니다. 그런 다음, 해당 파일을 Java 프로젝트에 추가할 수 있습니다.
또한 웹 프로젝트와 같은 다른 프로젝트 유형도 사용할 수 있습니다.
일반 서비스 클라이언트는 OS X에서 지원되지 않습니다. WSE 또는 샘플 JSP를 사용하여 웹 서비스를 테스트하십시오.
- Liberty 서버를 대상으로 지정하고, 웹 서비스 마법사를 사용하여 상향식 JAX-WS 웹 서비스를 생성하는 경우 널 포인터 예외를 수신할 수 있습니다.
- 새 웹 프로젝트 마법사에서 REST 템플리트를 선택하면 초기 JAX-RS 패싯 버전이 2.0일 수 있습니다. IBM® WebSphere Application Server Liberty JAX-RS Library 및 IBMRestServlet 클래스가 Rest 서비스 구성 페이지에서 미리 채워져 표시되도록 하려면 이를 1.1로 수동으로 변경해야 합니다.
- [Liberty] JAX-WS 웹 서비스가 OSGi 번들 프로젝트에 있는 경우 웹 서비스 마법사를 사용한 JAX-WS 웹 서비스 클라이언트 작성이 실패할 수 있습니다.
OSGi 번들 프로젝트에서 웹 서비스를 작성하고
웹 서비스 마법사에서 프로젝트에 WSDL 복사를 선택하지 않고
OSGi 번들 프로젝트를 Liberty에 배치하는 경우 이 문제점이 발생할 수 있습니다. WSDL(Web Services Description Language) 파일이 추가된 웹 서비스로부터 JAX-WS 클라이언트를 작성할 때 이 프로세스는 실패할 수 있습니다. 도구에서 다음 오류 메시지를 표시합니다.
[오류] 이름이 "sample.ObjectFactory"인 클래스/인터페이스가 이미 사용 중입니다. 사용자 정의 클래스를 사용하여 이 충돌을 해결하십시오.웹 서비스 마법사를 사용하여 클라이언트를 작성하는 Liberty 서버의 서비스 WSDL 파일에 다음 요소가 포함되어 있으므로 이 프로세스가 실패할 수 있습니다.<xs:complexType name="objectFactory"> <xs:sequence></xs:sequence> </xs:complexType>이 문제를 해결하기 위해 OSGi 번들 프로젝트에서 웹 서비스 프로젝트를 작성할 때 웹 서비스 마법사에서 프로젝트에 WSDL 복사를 선택할 수 있습니다. 대신 다음 단계를 완료할 수 있습니다.- 브라우저에서 WSDL URL을 보고 WSDL 파일을 로컬 컴퓨터에 저장하십시오.
- WSDL 파일에서 complexType 요소를 제거하십시오.
- OSGi 번들 프로젝트의 WEB-INF/wsdl 디렉토리에 WSDL 파일을 복사하십시오.
- 웹 서비스 Java 소스 파일의 @WebService 요소에 wsdlLocation 속성을 추가하십시오.wsdlLocation 속성에는 로컬 WSDL 파일을 가리키는 값이 있어야 합니다. 다음 행은 이 속성의 예입니다.
wsdlLocation="WEB-INF/wsdl/Sample.wsdl"
팁: OSGi 번들 프로젝트 대신 웹 프로젝트에서 웹 서비스를 작성하는 경우 웹 서비스 클라이언트가 생성됩니다. 도구에서 오류 메시지를 표시하지 않습니다. - [WebSphere Application Server traditional] JAX-RS 웹 프로젝트를 작성한 후에
도구를 사용하여 패싯 버전을 변경할 수 있습니다. JAX-RS 1.1과 2.0 사이에서
패싯 버전을 변경할 때 클래스 경로 컨테이너는 포함된 .jar 파일을
자동으로 업데이트하지 않습니다. 도구가 프롬프트되면 JPA 패싯 레벨과 같은
기타 패싯 레벨을 업데이트하여 포함된 .jar 파일을 업데이트할 수 있습니다.
그런 다음 JPA 패싯 레벨로 변경사항을 되돌릴 수 있습니다.팁: 패싯 레벨을 지정하지 않고 JAX-RS 프로젝트를 작성하는 경우 도구는 기본적으로 JAX-RS 2.0을 사용합니다.
보안 WebSphere Application Server 사용시 발생한 문제점
다음 오류 메시지가 나타날 수 있습니다. SSLSocketFactory error message: java.net.SocketException: java.lang.ClassNotFoundException: Cannot find the specified class com.ibm.websphere.ssl.protocol.SSLSocketFactory
웹 서비스 탐색기를 사용하고 샘플 JSP를 생성하며, HTTPS WSDL 파일에서 웹 서비스 또는 클라이언트를 작성하거나 Axis 웹 서비스를 배치하기 전에 워크벤치에서 SSL(Secure Sockets Layer)을 사용하여 서버와 통신하도록 구성해야 합니다. 이 태스크에 대한 정보는 SSL 연결을 사용하여 보안 서버에서 작업하는 데 문제점의 내용을 참조하십시오.
Error opening socket: javax.net.ssl.SSLHandshakeException: unknown certifcate라는 오류 메시지가 표시될 수 있습니다.
웹 서비스 마법사를 사용하여 HTTPS WSDL을 검색하거나 보안 WebSphere Application Server에서 웹 서비스 탐색기를 사용하려면 보안 WebSphere Application Server와 통신하도록 IBM JRE 구성의 단계를 완료하십시오.
웹 서비스 마법사 사용 시 발생하는 문제점
WebSphere JAX-WS 런타임 환경 및 JAXB 사용 시 발생하는 문제점
- 여러 개의 스키마 문서에서 동일한 네임스페이스를 사용할 때 스키마 라이브러리를 작성하려고 하면 컴파일 오류와 함께 프로젝트와 코드가 생성됩니다. 컴파일 오류는 ObjectFactory.java 파일에 있습니다. 문제는 스키마에 대한 JAXB 코드가 스키마의 targetNamespace에 따라 이름이 지정되는 패키지에 생성된다는 것입니다. ObjectFactory.java 클래스도 이 패키지에 생성되며, 해당 컨텐츠는 동일한 네임스페이스를 갖는 모든 스키마를 기초로 합니다. 런타임 환경은 이 클래스를 패키지당 하나로 간주하므로 컴파일 오류를 해결하기 위해 이 패키지를 분할하거나 복제할 수 없습니다. 따라서 스키마 라이브러리 기능은 모든 스키마가 각각 다른 targetNamespaces에 종속되어 있는 경우에만 작동합니다.
- JAXB에서는 IBMWebSphere JAX-WS 런타임 환경이
이름 충돌 문제를 해결하지 않습니다. 이 충돌이 발생하면 다음과 같은 오류 메시지가
나타날 수 있습니다. error:
Property "property_name" is already defined.
Java 웹 서비스 학습서: JAXB 바인딩 사용자 정의 학습서에는 이름 충돌 문제를 해결하기 위한 자세한 정보와 몇 가지 예제가 포함되어 있습니다.
웹 서비스 클라이언트를 작성할 때 제한사항
EJB 프로젝트에 웹 서비스 클라이언트를 배치할 때 프록시 구성 페이지에서 웹 서비스 클라이언트가 범위로 포함되는 EJB를 선택해야 합니다. 이 선택사항은 JSR-109에 의해 정의된 요구사항으로, component-scoped-refs 요소의 component-name이 모듈에 포함된 EJB의 ejb-name과 일치할 것을 요구합니다.
프로젝트에 하나 이상의 EJB가 있을 경우 오류가 발생하지 않습니다. 그러나 프로젝트에 EJB가 없을 경우에는 프록시 구성 페이지의 옵션이 편집 가능하고 기본값은 접미부가 "EJB"인 WSDL의 서비스 이름과 같습니다. 또한 클라이언트 마법사는 웹 서비스 클라이언트의 범위가 기존의 EJB로 지정되지 않았으므로 배치가 완료되지 않았다는 경고를 표시합니다. webservicesclient.xml에서 사용되는 component-name과 동일한 이름의 EJB를 작성하여 이 오류를 수정할 수 있습니다.
그러나 마법사를 취소하고 클라이언트 작성 종료를 선택하는 경우 마법사에서 불완전한 component-scoped-refs를 webservicesclient.xml에서 제거하지 못합니다. 이 경우, 재배치를 수행하기 전에 불완전한 component-scoped-refs를 수동으로 제거하십시오.
웹 서비스 샘플 JSP 제한사항
- 웹 서비스 샘플 JSP에는 매개변수로 콜렉션 또는 배열을 사용하는 메소드에 대한 지원이 포함되지 않습니다. 이러한 메소드는 샘플 JSP의 메소드 분할창에서 생략됩니다.
웹 서비스 탐색기 문제
- 웹 서비스 탐색기에서 다중 인라인 스키마를 사용하는 WSDL 파일을 로드하면 이러한 스키마에서 참조되는 유형에 대해 경고 메시지가 생성됩니다. 이 경고 메시지는 Reference of type <qualified_type_name> isn't resolved.와 유사합니다. 이는 오류가 아닌 경고이며 웹 서비스 탐색기의 조작 시작 기능을 방해하지 않습니다. 따라서, 이 경고는 무시해도 됩니다.
- 웹 서비스 탐색기는 HTTP 기본 인증이 아닌 다른 프로토콜(예: NTML)을 사용하는 프록시 서버를 인증하여 웹 서비스를 호출하도록 지원하지 않습니다. 이러한 이유 또는 다른 이유로 웹 서비스 탐색기에서 선택된 웹 서비스에 연결하지 못할 경우, 결과 분할창에 IWAB0135E An unexpected error has occurred 오류가 표시되고 HTTP 응답에서 검색된 장애 정보가 함께 표시됩니다. 이 문제를 해결하려면 HTTP 기본 인증 프록시 서버로 전환하십시오.
- 스키마가 시퀀스를 포함하는 선택사항을 사용하는 경우 소스 보기를 양식 보기로 전환할 때 웹 서비스 탐색기에서 문제가 발생합니다. complexType의 선택사항 요소를 사용 중인 경우 선택사항은 시퀀스를 포함한 둘 이상의 요소를 포함하며 웹 서비스 탐색기의 양식 보기에서 소스 보기로 전환할 경우 소스 보기의 대응하는 XML 단편을 데이터 손실 없이 양식 보기로 다시 변환하는 데 문제가 있을 수 있습니다. 이 문제점을 해결하려면 데이터를 처음 입력할 때 양식 보기에서 시퀀스를 시작하십시오. 이 구성에서는 소스 보기를 사용하지 않는 것이 좋습니다. 소스 보기를 사용할 경우에는 양식 보기로 다시 전환하지 마십시오.
- 웹 서비스 탐색기는 상대 가져오기 URL을 해석하지 않고 WSDL을 가져옵니다. 웹 서비스 탐색기를 사용하는 경우 WSDL 페이지에 있는 WSDL을 작업공간으로 가져올 때 문제가 발생합니다. WSIL 문서에 대한 서비스 참조로 가져오기 옵션을 선택한 경우 WSDL의 원래 URL을 참조하므로 모든 상대적 가져오기에 도달할 수 있습니다. WSDL 문서 가져오기를 선택한 경우 WSDL 파일에 상대적 가져오기가 포함되어 있으면 이러한 가져오기에 더 이상 도달할 수 없으며, 도구의 다른 위치에서 처리할 수 없거나 처리하기가 어려운 WSDL 사본이 남게 됩니다. 가져오는 WSDL에 상대적 가져오기가 포함되어 있는 경우 WSIL 메소드를 사용하십시오. WSDL의 사본이 필요한 경우에는 끊어진 링크를 해결하도록 가져온 후에 상대적 가져오기에 대한 검사를 수동으로 수행하십시오.
- Eclipse에서 Java 8 버전의 JVM(Java Virtual Machine)을 사용하면 웹 서비스 탐색기가 작동하지 않습니다. Java 8을 사용하여 웹 서비스 탐색기를 시작하는 경우 기본 창에서 HTTP 오류 500을 표시합니다. 이 문제를 해결하려면 Java 7을 Eclipse JVM으로 사용하거나 일반 서비스 클라이언트를 사용하십시오.
- Eclipse 4.5.1 워크벤치에서 WebSphere Developer Tools를 설치하면
웹 서비스 탐색기가 작동하지 않습니다. 웹 서비스 탐색기를 사용하려고 하는 경우
웹 서비스 탐색기의 Response/Status 섹션이 공백이며 도구가
다음 오류를 표시합니다.
이 문제점을 해결하려면 Eclipse 4.5.2 워크벤치에서 WebSphere Developer Tools를 설치하십시오. 이 문제점에 대한 자세한 정보는 Bug 476132 - Web services explorer issue with Java 8 - Page load failed with error: cannot parse response의 내용을 참조하십시오.Page load failed with error: cannot parse response.
웹 서비스 명령행 사용 시 발생하는 문제점
- Java EE 1.4를 사용하는 명령행 도구에서 생성한 EJB 클라이언트가 포함된 EAR을 작업공간으로 가져오면 컴파일 오류가 발생합니다. 오류를 수정하려면 EJB 프로젝트를 마우스 오른쪽 단추로 클릭한 후 특성을 선택하십시오. Java 빌드 경로로 이동하여 라이브러리 탭을 선택하십시오. EJBClientProject/imported_classes(class folder) 항목을 제거하십시오. EJBServiceClient/imported_classes/Meta-inf/classess 클래스 폴더를 추가하십시오. 확인을 클릭하십시오.
- [WebSphere Application Server traditional] Java EE 1.4를 사용하는 명령행 도구에서 생성한 애플리케이션 클라이언트가 포함된 EAR을 작업공간으로 가져오면 해당 클라이언트를 실행할 때 ClassNotFoundException 오류가 발생합니다. 오류를 해결하려면 애플리케이션 클라이언트 프로젝트를 마우스 오른쪽 단추로 클릭한 후 특성을 선택하십시오. Java 빌드 경로로 이동하여 라이브러리 탭을 선택하십시오. ApplicationClientProject/imported_classes(class folder) 항목을 제거하십시오. ApplicationClientProject/imported_classes/Meta-Inf/classess 클래스 폴더를 추가하십시오. 확인을 클릭하십시오.
- 대상이 Axis 런타임인 웹 서비스 Ant 태스크는 웹 서비스 생성 작업을 처리하지만, 배치 작업은 처리하지 않습니다. 따라서 Apache Axis 기본 AdminClient 유틸리티를 사용하여 서비스를 수동으로 배치하지 않을 경우, 실행 중인 서버에서 Ant 태스크를 사용하여 작성한 Axis 웹 서비스에 도달할 수 없습니다. Axis AdminClient 도구를 사용하여 수동으로 Axis에 웹 프로젝트의 WebContent/WEB-INF 디렉토리 아래 서브디렉토리에 생성된 deploy.wsdd 파일을 배치하십시오. 세부사항은 Axis 1.4 사용자 안내서의 "AdminClient 사용" 절의 내용을 참조하십시오.