웹 서비스 마이그레이션에 대한 힌트 및 팁

마이그레이션 힌트

이전 제품 버전의 웹 서비스 또는 웹 서비스 컴포넌트를 마이그레이션하려는 경우, 아래의 힌트와 팁을 참조하면 더 좋은 결과를 얻을 수 있습니다.
JAX-RS jar 위치

이전 버전의 제품에서 작성된 JAX-RS 웹 서비스는 Web 2.0 v1.0.x 및 v1.1.0용 기능팩 공존을 지원하는 WebSphere Application Server 버전 8.0의 영향을 받습니다. 이로 인해 Rational Application Developer는 4가지 JAX-RS 1.1 라이브러리 제공자와 4가지의 더 이상 사용되지 않는 JAX-RS 1.0.x 라이브러리 제공자를 지원합니다.

Web 2.0 v1.0.x용 기능팩 JAX-RS 라이브러리를 참조하는 프로젝트를 새 버전의 Rational Application Developer로 마이그레이션하는 경우 Web 2.0 v1.0.x용 기능팩이 설치되어 있어야만 프로젝트가 작동합니다. Web 2.0 v1.1용 기능팩으로 마이그레이션한 경우 새로운 JAX-RS 라이브러리를 사용하려면 프로젝트를 마이그레이션해야 합니다. 프로젝트를 마우스 오른쪽 단추로 클릭한 후 특성 > 프로젝트 패싯 > JAX-RS를 선택하고 새 라이브러리 유형을 선택하여 이를 수행할 수 있습니다.

보안 웹 서비스가 마이그레이션되지 않음
웹 서비스를 J2EE 1.3에서 J2EE 1.4로 마이그레이션할 경우, J2EE 마이그레이션 마법사를 통해 보안 웹 서비스를 마이그레이션할 수 없습니다. 보안 웹 서비스의 마이그레이션은 수동으로 수행해야 합니다. J2EE 마이그레이션 후에는 다음을 수행하여 보안 바인딩 및 확장 파일을 J2EE 1.4로 직접 마이그레이션해야 합니다.
  1. webservices.xml 파일을 두 번 클릭하여 웹 서비스 편집기를 여십시오.
  2. 바인딩 파일을 편집하려면 바인딩 구성 탭을 선택하십시오.
  3. 새 절인 요청 이용자 바인딩 구성 세부사항응답 생성기 바인딩 구성 세부사항에 필요한 바인딩 구성을 모두 추가하십시오.
  4. 확장 파일을 편집하려면 확장 탭을 선택하십시오.
  5. 새 절인 요청 이용자 서비스 구성 세부사항응답 생성기 서비스 세부사항에 필요한 확장 구성을 모두 추가하십시오.
  6. 저장 후 편집기를 종료하십시오.
JDK 준수 레벨로 인해 마이그레이션된 EAR에 빌드 오류 발생
이전 제품 버전에서 생성된 웹 서비스 EAR의 경우, Java™ 컴파일러가 기본 JDK 준수 레벨로 J2SE 5.0을 사용하기 때문에 빌드 오류가 있을 수 있습니다. 이전 웹 서비스 마법사에서 생성된 Java 코드는 enum이라는 패키지 이름을 사용하는데, 이 패키지 이름은 J2SE 5.0의 예약어입니다. 이 문제를 해결하려면 다음을 수행하십시오.
  1. 해당되는 웹 서비스 프로젝트를 선택하고 마우스 오른쪽 단추로 클릭한 후 특성을 선택하십시오.
  2. 특성 목록에서 Java 컴파일러를 선택하십시오.
  3. JDK 준수 절에서 컴파일러 준수 레벨을 1.4 이상으로 변경하십시오. 확인을 클릭하십시오.
JDK 레벨로 인해 EAR 배치 실패

예외 발생: com.ibm.etools.webservice.deploy.core.WebserviceXMLException: Compilation error in *.jar

문제점: 작업공간에서 작성 후 내보낸 EAR 파일을 WebSphere® Application Server 6.1.x 로 배치하면 class file has wrong version 49.0, should be 48.0 Please remove or make sure it appears in the correct subdirectory of the classpath 오류와 함께 배치가 실패합니다.

원인: 프로젝트를 작성할 때의 기본 JDK 컴파일러가 JDK 5.0입니다. WebSphere Application Server 6.1.x JDK 레벨은 1.4입니다. Java 1.4는 버전 48.0으로 레이블 지정된 클래스 파일을 작성합니다. Java 1.5는 버전 49.0으로 레이블 지정된 클래스 파일을 작성합니다. Java 1.4는 버전 49.0으로 레이블 지정된 클래스 파일을 실행할 수 없습니다.

솔루션: 다음을 수행하여 JDK 1.4 컴파일러를 사용하는 클래스가 포함된 프로젝트를 다시 컴파일하십시오.
  1. 해당되는 프로젝트를 마우스 오른쪽 단추로 클릭하고 특성 > 프로젝트 패싯을 선택하십시오.
  2. 프로젝트 패싯 추가/제거를 클릭하십시오.
  3. 두 번째 Java 항목에 대해 버전을 두 번 클릭하십시오.
  4. 드롭 다운 목록에서 1.4를 선택하십시오.
  5. 완료 > 확인을 클릭하십시오.
  6. 프로젝트를 마우스 오른쪽 단추로 클릭하고 특성 > Java 컴파일러를 선택하십시오.
컴파일러 준수 레벨이 1.4 7로 변경된 것을 확인할 수 있습니다. 컴파일된 EAR 파일을 내보낸 후 WebSphere Application Server 6.1.x에 배치하면 배치가 성공해야 합니다.
Rational® Application Developer 버전 7.0.0.x의 일부 정책 세트 구성이 포함된 클라이언트 애플리케이션을 Rational Application Developer v7.5로 마이그레이션

Rational Application Developer 버전 7.0.0.x와 함께 설치되는 WebSphere Application Server 6.1.0.9 버전 또는 그 이전 버전의 일부 정책 세트 구성이 포함된 클라이언트 애플리케이션을 상위 레벨의 WebSphere Application Server(예: WebSphere Application Server v7.5)로 마이그레이션할 때에는 클라이언트측 정책 세트 바인딩 구성을 업데이트해야 합니다. WebSphere Application Server v6.1.0.9 이하에서는 서버측 기본 바인딩을 보완하기 위해 사용자 정의 클라이언트 바인딩 구성이 생성됩니다. 이 클라이언트 애플리케이션과 해당 서비스를 상위 레벨의 WebSphere Application Server로 마이그레이션할 때에는 클라이언트측 기본 바인딩도 함께 사용하도록 변경해야 합니다.

클라이언트측 애플리케이션의 마이그레이션 단계는 다음과 같습니다.
  1. 클라이언트 애플리케이션에 대한 정책 세트 첨부 관리 마법사를 실행하십시오.
  2. 애플리케이션 표에서 엔드포인트를 선택하십시오.
  3. 편집을 선택한 후, 엔드포인트 구성 대화 상자의 드롭 다운 메뉴에서 <기본 바인딩>을 선택하여 바인딩 필드를 수정하십시오.
  4. 확인을 선택한 후 완료를 클릭하십시오.
  5. 테스트 전에 애플리케이션이 WebSphere 서버에 재공개될 때까지 기다리십시오.
더 이상 인식되지 않는 정책 세트를 마이그레이션(예: 웹 서비스를 WebSphere Application Server v6.1.x에서 WebSphere Application Server v7으로 이동)하려는 경우, 정책 세트 첨부 관리 마법사를 실행하면 해당 정책 세트의 지원 여부가 표시되며 지원되는 정책 세트로 마이그레이션할 수 있는 옵션이 표시됩니다.

피드백