요약

이 기사에서는 WebSphere Integration Developer에서 테스트 케이스 지원으로 웹 서비스 모듈을 테스트하는 방법을 사용자에게 보여준다. 대부분의 사용자들이 테스트 케이스에서 테스트 변수를 설정하는 Java 표현식을 사용하는 방법과 원인을 알지 못한다는 것을 알아냈다. 이 기사에서는 또 다른 변수에서 필드를 참조하는 Java 표현식을 사용하는 방법에 대해 설명한다. 이 기사에서는 더 중요하게도 사용자들이 SOAP 메시지 변수에서 특정 필드를 참조할 수 있는 일부 내장 Java 유틸리티도 공개할 것이다.

소개

WebSphere Integration Developer v7.0에서 테스트 케이스 지원에 제공되는 향상된 기능 중의 하나는 SOAP(Simple Object Access Protocol) 첨부로 웹 서비스 모듈을 테스트하는 기능이다. 프로덕션 환경에서는 웹 페이지의 단추를 클릭하면 다른 웹 서비스 모듈의 호출 체인이 연결될 수 있었다. 웹 서비스 개발을 완료한 후에 실제 프로덕션 환경에서 호출되는 것처럼 이를 테스트하려고 할 수 있다. 테스트 케이스 지원을 통해 테스트 시나리오를 작성하여 웹 서비스 모듈이 예상대로 작동하는지 확인할 수 있다.

이 기사에서는 SOAP 첨부로 웹 서비스에 대한 시나리오 기반 테스트 케이스를 작성하기 위해 WebSphere Integration Developer에서 테스트 케이스 지원을 사용하는 방법을 보여준다. 시나리오 테스트 케이스에서 때때로 또 다른 웹 서비스를 호출하는 웹 서비스에서부터 리턴되는 응답 SOAP 메시지를 사용하려 할 수 있다. 테스트 케이스 지원에서 Java 표현식 기능을 사용하여 이를 수행하는 방법을 심도 있게 보여준다.

이 기사는 WebSphere Process Server v7.0.0.3에서 준비되었으므로, 반드시 WebSphere Integration Developer 및 WebSphere Process Server의 사본을 v7.0.0.3으로 업데이트할 것을 권장한다. 이 기사에서 언급된 일부 API는 v7.0.0.3 이전 버전에서 사용 가능하지 않을 수도 있다.

위로

웹 서비스 모듈 작성

시나리오 테스트 케이스를 작성하기 전에 WebSphere Integration Developer v7.0에서 웹 서비스 모듈을 작성하는 방법을 간략히 보여줄 것이다. 이 기사의 목적은 두 개의 웹 서비스 내보내기를 작성할 것이므로 이를 시나리오 테스트 케이스에서 테스트할 수 있다. 참고: 이 샘플은 WS-I 준수 SOAP 첨부를 지원하는 WebSphere Integration Developer v7.0.0.3에서 준비되었다.

다음 단계에서 웹 서비스를 작성하는 방법을 안내한다.

1. WebService_InitialPI.zip 프로젝트 인터체인지 파일을 가져온다.
2. WebServiceModule의 Assembly Diagram을 연다.

Assembly Diagram에서 두 개의 중개 컴포넌트가 있다. 하나는 UserMediation이며, 이는 주어진 사용자 ID를 위해 사용자 레코드를 검색하기 위한 서비스이다. 사용자 ID와 사진 첨부를 매개변수로 취하고 해당되는 사용자 레코드를 리턴한다. 또 다른 컴포넌트는 AttachmentMediation이며, 이는 등록된 사용자에 대한 PDF 파일을 제출하기 위한 서비스이다. 이는 사용자 레코드(UserMediation으로 리턴됨) 및 PDF 첨부를 매개변수로 취하고 제출 상태와 제출된 PDF 첨부를 리턴한다.

3. UserMediation 컴포넌트를 선택하고 컨텍스트 메뉴에서 Generate Export > Web Service Binding을 선택한다.
4. SOAP1.1/HTTP를 선택하고 Finish를 클릭한다.

5. Assembly Diagram에서 AttachmentMediation 컴포넌트를 선택하고 컨텍스트 메뉴에서 Generate Export > Web Service Binding을 선택한다.
6. SOAP1.1/HTTP를 선택하고 Next를 클릭한다.
7. 다음 페이지에서 Next를 클릭하여 마지막 페이지로 진행한다.
8. Use WS-I compliant SOAP message를 선택하고 Finish를 클릭한다.

9. Assembly Diagram을 저장한다.
10. UserInterfaceExport1을 선택하고 Properties 보기를 연다.
11. Name 필드를 선택하고 Alt+Shift+R을 눌러 내보내기 이름을 UserWebService로 바꾼다.
12. AttachmentInterfaceExport1을 선택하고 Properties 보기를 연다.
13. Name 필드를 선택하고 Alt+Shift+R을 눌러 내보내기 이름을 AttachmentWebService로 바꾼다.

이제 두 개의 웹 서비스를 작성하였으며 이를 테스트하려고 한다. 다음 섹션에서는 WebSphere Integration Developer에서 사용 가능한 테스트 케이스 지원을 사용하여 이를 테스트하는 방법을 보여줄 것이다.

위로

시나리오 기반 테스트 케이스 작성

WebSphere Integration Developer에서 테스트 케이스 지원을 사용하면 모듈의 여러 호출이 연관되는 시나리오 기반 테스트 케이스를 작성할 수 있다. 이 섹션에서는 이전 섹션에서 작성한 웹 서비스에 대해 테스트 케이스를 작성하는 방법을 보여줄 것이다.

다음 단계에서 웹 서비스를 테스트하는 테스트 케이스를 작성할 것이다.

1. Business Integration 보기에서 WebServiceTestProject를 선택한다.
2. 컨텍스트 메뉴에서 New > Component Test Suite를 선택한다.
3. 새 테스트 스위트에 대한 이름을 지정하고 Next를 클릭한다.
4. Scenario-based testing을 선택하고 Next를 클릭한다.

5. Define a Test Scenario 페이지에서는 이전 섹션에서 작성한 두 개의 웹 서비스를 테스트하는 테스트 케이스를 작성하려 한다. 우선 UserWebService에서 getUser 메소드를 호출하여 사용자 ID의 사용자 레코드를 찾은 후에 AttachmentWebService에서 submitDocument 메소드를 호출하여 그 사용자에 대한 PDF 파일을 제출하려고 한다. 테스트 케이스를 작성하려면 다음을 수행한다.
• 테스트 케이스에 대한 이름을 지정한다.
• Available components and interfaces 섹션에서 WebServiceModule > UserWebService > UserInterface를 선택한다.
• Testable operations 섹션에서 getUser를 두 번 클릭한다. 그러면 Test Scenario 섹션에 그 조작이 추가되었음이 표시될 것이다.
• 이제 Available components and interfaces 섹션에서 WebServiceModule > AttachmentWebService > AttachmentInterface를 선택한다.
• Testable operations 섹션에서 submitDocument를 두 번 클릭한다. 그러면 Test Scenario 섹션에 그 조작이 추가되었음이 표시될 것이다.

6. Finish를 클릭하여 테스트 시나리오를 작성한다.

테스트 스위트 편집기에서 열린 새 테스트 스위트가 표시될 것이다. 이제 호출과 예상 결과에 대한 매개변수 값을 설정하자.

테스트 케이스에서 값 설정하기

테스트 스위트가 작성된 후에 테스트 스위트 편집기에서 테스트 케이스 세부사항을 지정하자. Test Data Table 보기를 열면 몇 개의 정의된 변수가 표시되고 이러한 변수가 테스트 케이스에서 호출 태스크에 사용되었음이 표시될 것이다.

다음 단계에서는 테스트 케이스 변수에서 값을 설정하는 방법을 보여준다.

1. 테스트 스위트 편집기에서 Test Cases 페이지로 전환한다.
2. 1. Invoke UserWebService:getUser 태스크를 선택한다.
3. Detailed Properties 섹션의 맨 아래로 스크롤한다. Request 탭이 표시될 것이다. Request 탭에 정의된 두 개의 변수가 있다.
4. request 링크를 클릭한다. 이렇게 하면 Test Data Table 보기에서 연관된 변수가 표시될 것이다.
5. request 변수의 SOAP 본문을 확장한다.
6. userId 필드의 중개 ID를 입력한다. (예: 12345)
7. picture 필드를 선택하고 Type 열에서 셀을 클릭한다.
8. 드롭다운 메뉴에서 image/gif를 선택한다.

9. 셀을 마우스 오른쪽 단추 클릭하여 컨텍스트 메뉴를 시작하고 Browse for File을 선택한다. 참고: 선택한 파일의 애플리케이션은 테스트 케이스를 실행할 때에 서버에도 배치되어야 한다. 따라서 테스트 케이스를 작성하는 테스트 프로젝트에 첨부 파일을 저장할 것을 권장한다.
10. Browse for File 대화 상자에서 WebServiceTestProject를 확장한다.
11. picture.gif를 선택하고 Finish를 클릭한다.
12. 테스트 스위트 편집기의 Test Cases 페이지로 돌아간다.
13. Response 탭으로 전환한다.
14. response 링크를 클릭한다. 이렇게 하면 Test Data Table 보기에서 연관된 변수가 표시될 것이다.
15. response 변수의 아무 열 셀이나 마우스 오른쪽 단추 클릭하고 컨텍스트 메뉴에서 Set To > Equals Default를 선택한다.
16. SOAP 본문을 확장하고 다음 값을 지정한다.
    • userId 필드에 6단계에서 지정한 ID(예: 12345)를 입력한다.
    • firstname 필드에 Joe를 입력한다.
    • lastname 필드에 Smith를 입력한다.
    • picture 필드에서 /WebServiceTestProject/picture.gif를 입력한다.

17. 테스트 스위트를 저장한다.

첫 번째 웹 서비스 호출을 테스트하기 위한 값의 설정을 완료했다. 두 번째 호출에서 첫 번째 호출의 응답 SOAP 메시지의 일부 값을 참조하려고 한다. 다음 섹션에서는 Java 표현식으로 이를 수행하는 방법을 보여준다.

Java 표현식 사용하기

WebSphere Integration Developer에서 테스트 케이스 지원을 통해 또 다른 변수에서부터 필드를 참조하는 Java 표현식을 사용할 수 있다. Test Data Table 보기는 변수에 대한 Java 표현식을 지정하는 데 유용한 컨텐트 지원을 제공한다. 이 샘플에서는 SOAP 메시지에서 필드에 액세스하는 Java 표현식을 사용하는 방법에 집중할 것이다. 변수가 SOAP 메시지 유형이면 SOAP 메시지에서 필드를 검색하기 위한 XPath 표현식을 사용하는 고유한 Java 코드를 쓸 수 있다. 이를 대체하여 특정 SOAP 메시지 필드를 검색하는 테스트 케이스 지원이 제공하는 내장 유틸리티도 사용할 수 있다. 이러한 내장 유틸리티는 주로 테스트 케이스 지원에서 사용되어 웹 서비스에서부터 리턴된 SOAP 메시지를 확인한다.

다음 단계에서는 또 다른 SOAP 메시지 변수에서부터 필드를 참조하는 내장 유틸리티를 사용하는 방법을 보여준다.

1. Java 메소드가 호출 가능하기 전에 Test Data Table 보기에서 메소드를 정의하는 Java 클래스를 가져와야 한다.
   • Test Data Table 보기의 Imports 페이지로 이동한다.
   • Add를 클릭한다. Select Type to Import 대화 상자가 열린다.
   • com.ibm.wbit.comptest.ctnative.runtime.utils.DOMHelper를 선택하고 OK를 클릭한다. 이 유틸리티 클래스는 XPath 표현식을 지정하여 SOAP 메시지에서 특정 필드를 검색할 수 있는 API를 제공한다. API 참조 섹션에서 이 유틸리티 클래스에 대한 자세한 정보를 얻을 수 있다.

2. Default 페이지로 돌아간다.
3. 테스트 스위트 편집기의 Test Cases 페이지로 이동한다.
4. 2. Invoke AttachmentWebService:submitDocument를 선택한다.
5. Detailed Properties 섹션의 맨 아래로 스크롤하고 Request 탭을 클릭한다.
6. request 변수를 클릭하면 Test Data Table 보기에서 연관된 변수가 표시된다.
7. 변수의 SOAP 본문을 확장한다.
8. 다음 필드를 선택하고 컨텍스트 메뉴에서부터 Set Format > Java Expression을 선택하여 형식을 Java 표현식으로 설정한다.
   • userId
   • firstname
   • lastname
   • picture
9. 테스트 케이스 지원은 com.ibm.wbit.comptest.ct.soap.SoapWrapper 유형의 SOAP 변수를 정의한다. API 참조 섹션에서 이 Java 유형에 대한 자세한 정보를 얻을 수 있다. 해당되는 각 필드에 다음 Java 표현식을 입력한다.

처음 세 개의 필드(예: userId, firstname, lastname)는 String 유형 값을 예상한다. DOMHelper를 호출하여 XPath 표현식을 SOAP 메시지(예: response.getMessage())에서부터 검색하려는 필드에 제공한다. XPath 표현식에 사용되는 네임스페이스 접두부가 실제 SOAP 메시지에 정의된 네임스페이스 접두부와 정확히 동일해야 함을 참고하자. 실제 SOAP 메시지에 사용된 네임스페이스 접두부는 테스트 스위트를 작성할 때에 알려지지 않을 수 있다. 그 대신에 XPath 표현식에 사용된 네임스페이스와 접두부가 들어있는 맵을 DOMHelper.getSelectedNode()에 제공할 수 있기 때문에 네임스페이스는 런타임 시에 적절하게 해결될 수 있다. 이를 수행하는 방법은 고유 Java 클래스 작성 섹션에서 알려줄 것이다.

picture 필드는 SOAP 첨부 필드이다. 응답 SOAP 메시지에서부터 컨텐트 ID를 검색하여 SOAP 메시지에서 첨부의 2진 컨텐트를 검색하는 response.getAttachment(contentId)를 호출할 수 있다.

10. pdf 필드를 선택하고 컨텍스트 메뉴에서부터 Browse for File 조치를 사용하여 이를 /WebServiceTestProject/test.pdf 파일로 설정한다.
11. 테스트 스위트 편집기의 Test Cases 페이지로 돌아간다.
12. Response 탭으로 전환한다.
13. response 링크를 클릭한다. 이렇게 하면 Test Data Table 보기에서 연관된 변수가 표시될 것이다.
14. 변수의 열 셀을 마우스 오른쪽 단추 클릭하고 컨텍스트 메뉴에서부터 Set To > Equals Default를 선택한다.
15. 변수에서 SOAP 본문을 확장하고 submitDocumentResult0 필드에 대해 OK를 입력한다.
16. 응답 SOAP 메시지 변수에서 pdf 필드를 마우스 오른쪽 단추 클릭하고 컨텍스트 메뉴에서부터 Set Format > Java Expression을 선택한다.
17. Expected 열 셀에서 request_2.getAttachmentByPartName("pdf")을 입력한다. 이 Java 표현식은 요청 SOAP 메시지에서 pdf 첨부의 2진 컨텐트를 검색할 것이다.

18. 테스트 스위트를 저장한다.

웹 서비스에 대한 시나리오 테스트 케이스를 작성하였으며, 통합 테스트 클라이언트에서 이를 실행할 준비가 되었다.

위로

시나리오 테스트 케이스 실행

시나리오 테스트 케이스를 실행하려면 Business Integration 보기에서 테스트 스위트를 마우스 오른쪽 단추 클릭하고 컨텍스트 메뉴에서부터 Run Test를 선택한다. 이렇게 하면 테스트 클라이언트 편집기가 열릴 것이다. 테스트 클라이언트 편집기에서 Continue를 클릭하여 테스트를 실행한다. 테스트가 완료되면 실행에서부터 제작된 테스트 추적을 조사할 수 있다.

전송되거나 웹 서비스에서부터 리턴되는 SOAP 메시지와 첨부를 확인하는 Binding 이벤트를 선택할 수 있다.

위로

고유의 Java 클래스 작성

때로는 고유의 Java 유틸리티를 작성하여 Test Data Table 보기에서 사용하려 할 수 있다. 컴포넌트 테스트 프로젝트 및 공유하는 라이브러리에서 Java 유틸리티를 작성할 수 있고, 그 다음에 이를 Java 표현식 사용하기 섹션에서 수행한 것과 같이 테스트 데이터 표에 가져올 수 있다. 이 섹션에서는 DOMHelper.getSelectedNode() API에서 공급한 사용자 정의 네임스페이스 맵을 작성하는 방법을 보여줄 것이다.

1. Java Perspective로 전환한다.
2. WebServiceTestProject를 선택하고 워크벤치 메뉴에서부터 File > New > Class를 선택한다.
3. 패키지 이름과 클래스 이름을 다음 스크린샷과 같이 지정한다. Finish를 클릭하여 완료한다.

4. custom.NameSpaceMapManager 클래스가 Java 편집기에서 열린다.
5. 아래와 같이 Java 클래스에서 getNamespaceInfo라는 정적 메소드를 작성한다.

public class NameSpaceMapManager {

   public static NamespaceInfo getNamespaceInfo() {
      NamespaceInfo nsInfo = new NamespaceInfo();
      nsInfo.addNamespace("ns0", "http://schemas.xmlsoap.org/soap/envelope/");
      nsInfo.addNamespace("ns1", "http://WebServiceLibrary/UserInterface");
      return nsInfo;
   }
}

6. 테스트 스위트 편집기에서 WebServiceTest를 연다.
7. 테스트 데이터 표에서 custom.NameSpaceMapManager를 가져온다.

8. Test Data Table 보기의 Default 페이지로 돌아가서 request_2 variable에서 userId, firstname, lastname 및 picture 필드의 Java 표현식을 변경한다.

새 XPath 표현식이 NameSpaceMapManager 클래스에서 정의한 네임스페이스 접두부를 사용하고 있으며, NameSpaceMapManager 클래스에서 작성한 네임스페이스 맵이 DOMHelper.getSelectedNode() API로 전달되었음을 확인할 수 있다.

9. 테스트 스위트를 저장한다.
10. 시나리오 테스트 케이스 실행 섹션에 나와 있는 대로 테스트 케이스를 다시 실행할 수 있다.

공유하는 라이브러리 작성

다른 컴포넌트 테스트 프로젝트에서 Java 유틸리티를 다시 사용하려는 경우 이를 공유하는 라이브러리에서 작성할 수 있다. 다음 단계에서는 공유하는 라이브러리를 작성하는 방법을 보여준다.

1. 워크벤치 메뉴에서부터 File > New > Library를 선택한다.

2. 새 라이브러리에 대한 중개 이름을 입력하고 Finish를 클릭한다.
3. 새 라이브러리를 사용하려면 테스트 케이스가 들어있는 컴포넌트 테스트 프로젝트의 종속 항목으로 이를 추가해야 한다. Business Integration 보기에서 WebServiceTestProject의 Dependencies를 두 번 클릭한다.
4. Dependencies 편집기가 열린다. Add 단추를 클릭하여 라이브러리를 컴포넌트 테스트 프로젝트에 추가한다.

5. Save를 클릭하여 Dependencies 편집기를 저장한다.
6. 새 라이브러리는 이제 컴포넌트 테스트 프로젝트에 의해 참조된다. 그러면 이 라이브러리에서 Java 유틸리티를 작성하는 고유의 Java 클래스 작성의 단계를 따른다.

위로

API 참조

이 섹션은 테스트 스위트에서 SOAP 메시지 변수에 액세스하는 데 유용한 테스트 케이스 지원이 제공하는 내장 유틸리티의 javadoc을 보여준다. 다음 javadoc은 WebSphere Process Server v7.0.0.3으로부터 생성되었음을 참고하자. 일부 메소드는 v7.0.0.3 이전 버전에서 사용 가능하지 않을 수도 있다.

/**
 * @return the SOAP envelope in this wrapper.
 */
public Document getMessage();

/**
 * 
 * @param index
 *        the position of the attachment in this wrapper
 * @return the content of the attachment in raw bytes at the given position.
 */
public byte[] getAttachment(int index);

/**
 * 
 * @param contentID
 *       the corresponding content ID of the attachment in this wrapper
 * @return the content of the attachment in raw bytes.
 */
public byte[] getAttachment(String contentID);

/**
 * 
 * @param partName
 *      the corresponding part name of the attachment in this wrapper
 * @return the content of the attachment in raw bytes.
 */
public byte[] getAttachmentByPartName(String partName);

/**
 * @return the number of attachments found in this wrapper.
 */
public int getAttachmentCount();

/**
 * Look up the object from the specified DOM document using the XPath
 * expression.
 * 
 * @param target
 *            the DOM Document node
 * @param xpathExpr
 *            the XPath expression for the lookup
 * @param nsInfo
 *            contains the prefix-namespace pair. Since the namespace
 *            prefixes used in the DOM document can be anything, it allows
 *            the specified XPath expression to use its own namespace
 *            prefixes and this API will try to use this object to map them
 *            to the namespace prefixes used in the actual DOM document. If
 *            this is <code
type="inline">null</code>, the XPath expression must use the
 *            same namespace prefixes as appeared in the DOM document.
 * @return the value or DOM node identified by the given XPath expression.
 * @throws Exception
 */
public static Object getSelectedNode(Object target, String xpathExpr,
        NamespaceInfo nsInfo) throws Exception;

/**
 * Add a namespace pair to this map.
 * 
 * @param prefix
 *            the namespace prefix
 * @param namespace
 *            the namespace defined by the specified prefix
 */
public void addNamespace(String prefix, String namespace);

/**
 * Finds the namespace defined by the given prefix in this map.
 * 
 * @param prefix
 *            a namespace prefix cached in this map
 * @return the namespace paired with the given prefix or null if the prefix
 *         cannot be found in this map.
 */
public String getNamespace(String prefix);

/**
 * Finds the namespace prefix associated to the given namespace cached in
 * this map.
 * 
 * @param namespace
 *            the namespace cached in this map
 * @return the associated namespace prefix or null if the namespace is not
 *         found in this map.
 */
public String getPrefix(String namespace);

위로

결론

WebSphere Integration Developer에서 테스트 케이스 지원을 통해 웹 서비스 모듈에 대한 포괄적인 테스트 케이스를 작성할 수 있다. 이 기사에서는 여러 호출에 연관되는 웹 서비스 모듈에 대한 시나리오 테스트 케이스를 작성하는 방법에 대해 배웠다. 또한 다른 것에서부터 변수의 필드를 참조하는 Java 표현식을 사용하는 방법에 대해서도 설명한다. 이제 다시 돌아가서 웹 서비스 애플리케이션 작업을 견고하게 보장하는 고유의 테스트 케이스의 작성을 시도할 수 있다.

위로

다운로드 하십시오

다운로드 방식에 대한 정보

참고자료

교육

• "Taking component testing to the next level in WebSphere Integration Developer"(developerWorks, 2008년 6월)에서는 WebSphere Integration Developer의 테스트 케이스 지원 기능의 개요를 제공한다.
  
  
• "Using attachments in SOA applications with WebSphere Integration Developer V7"(developerWorks, 2010년 3월)에서는 WebSphere Integration Developer V7에서 기능을 사용하여 애플리케이션에 첨부를 추가하는 방법을 보여준다.
  
  
• WebSphere Business Process Management V7 Information Center에 대해 더 자세히 알아보자.
  
  
• Twitter의 developerWorks 페이지를 살펴보자.
  
  
• developerWorks on-demand demos에서는 입문자를 위한 제품 설치 및 설정부터 숙련된 개발자를 위한 고급 기능까지 망라된 다양한 데모를 제공한다.
  
  

제품 및 기술 얻기

• 자신에게 가장한 적합한 방법으로 IBM 제품을 평가해 보자. 시험판 제품을 다운로드하거나, 온라인으로 제품을 사용해 보거나, 클라우드 환경에서 제품을 사용하거나, SOA Sandbox에서 SOA(Service Oriented Architecture)를 효과적으로 구현하는 방법을 배울 수 있다.
  
  

토론

• My developerWorks 커뮤니티에 참여하자. 개발자가 운영하고 있는 블로그, 포럼, 그룹 및 위키를 살펴보면서 다른 developerWorks 사용자와 의견을 나눌 수 있다.
  
  

필자소개

아티클 순위

의견

위로

목차

• 요약
• 소개
• 웹 서비스 모듈 작성
• 시나리오 기반 테스트 케이스 작성
• 시나리오 테스트 케이스 실행
• 고유의 Java 클래스 작성
• API 참조
• 결론
• 다운로드 하십시오
• 참고자료
• 필자소개
• 의견