WebSphere 웹 서비스 환경 설정

WebSphere® 웹 서비스 환경 설정 페이지에서 WebSphere 웹 서비스를 작성하거나 이용할 때 사용되는 다음 환경 설정을 설정할 수 있습니다.

보안

FIPS 준수 알고리즘만 표시
데이터 암호화 메소드 알고리즘 및 키 암호화 메소드 알고리즘 드롭 다운 목록에 FIPS 준수 알고리즘만 표시하려는 경우에 선택하십시오. 이 애플리케이션이 WebSphere 관리 콘솔의 글로벌 보안 패널에 FIPS(Federal Information Processing Standard) 사용 옵션이 설정된 WebSphere Application Server에서 실행되도록 하려는 경우에만 이 옵션을 사용하십시오.
비밀번호 문자 대신 '*' 표시
기본적으로 워크벤치는 비밀번호 문자 대신 별표(*)를 표시합니다.

사설 UDDI 레지스트리

이 절을 사용하여 UDDI 카테고리 데이터 열 및 문자열 분리문자를 설정하십시오.
  • 기본 열 분리문자는 #입니다.
  • 기문 문자열 분리문자는 "입니다.

JAX-RPC 코드 생성

이 주제에 있는 정보와 함께 일부 JAX-RPC 웹 서비스 환경 설정에 대한 자세한 정보를 포함하는 developerWorks®에 몇 가지 기사가 공개되어 있습니다.
Java2WSDL
  • 스타일 및 사용: WSDL 파일에 생성되는 스타일 및 사용 조합을 지정합니다. 조합은 RPC/인코딩, RPC/리터럴 또는 문서/리터럴입니다.
  • 대상 네임스페이스: 생성 중인 WSDL의 기본 대상 공간을 입력하십시오.
  • 랩핑: 랩핑 규칙에 따라 WSDL 파일 생성 여부를 지정합니다. 이 옵션은 리터럴 전용으로 사용하는 경우에만 유효합니다. 옵션의 기본값은 true입니다. 사용하려는 WSDL 스타일에 대한 추가 정보는 developerWorks 기사인 Which Style of WSDL Should I Use?를 참조하십시오.
  • WSDL 1.1 사용. MIME 첨부 제외: MIME 유형을 WSDL 1.1 표준에 맵핑할 수 없는 경우에는 명령이 실패합니다.
  • SOAP 조치: 이 옵션은 생성된 WSDL에 soapAction 필드를 설정하는 데 사용됩니다. 배치 정보에 따라 soapAction 필드가 기본값으로 설정됩니다. 없음인 경우 soapAction 필드가 큰따옴표("")로 설정됩니다. 오퍼레이션은 soapAction 필드를 오퍼레이션 이름으로 설정합니다.
  • Void 리턴: 이 필드는 웹 서비스에서 응답 필요 여부를 설명하는 void 리턴 유형의 웹 서비스 메소드에 사용됩니다. void 리턴의 메소드는 단방향입니다. 이 인수는 JMS 전송의 기본값입니다. void 리턴의 메소드는 양방향입니다. 이 인수는 HTTP 전송의 기본값입니다.
  • 기본 바인딩: 출력 WSDL 파일에 작성되는 바인딩 유형 목록을 지정합니다. Java2WSDL 명령의 각 바인딩 생성기는 특정 바인딩 유형을 지원합니다. 올바른 HTTP 바인딩 유형 값은 HTTP(SOAP/HTTP), JMS(SOAP/JMS) 및 EJB(로컬 또는 원격 EJB 호출)입니다.
  • JAX-RPC 준수에 대해 Java 클래스 유효성 검증 선택한 경우 마법사는 코드를 생성하기 전에 Java 클래스가 JAX-RPC를 준수하는지 검증합니다.
WSDL2Java
  • 기본 서비스 범위: 서버 구현 배치 방법을 표시합니다. 애플리케이션에서는 전체 요청에 대해 한 개의 구현 클래스 인스턴스를 사용합니다. 요청은 각 요청에 대해 새 구현 클래스 인스턴스를 작성합니다. 세션은 각 세션에 대해 새 구현 클래스 인스턴스를 작성합니다.
  • 스켈레톤 생성에 -noWrappedOperations 사용: 랩핑된 오퍼레이션 발견을 사용할 수 없습니다. 요청 및 응답 메시지의 Java Bean이 생성됩니다.
  • 데이터 바인딩 사용 안함 및 SOAPElement 사용: Java 유형에 대한 XML 유형의 바인딩을 사용하지 않습니다. 대신 각 XML 유형은 SAAJ(SOAP with Attachments API for Java) 1.2에서 정의된 javax.xml.soap.SOAPElement 인터페이스에 맵핑됩니다. JAX-RPC 스펙은 XML 유형의 서브세트에 대해 Java 맵핑을 정의합니다. 여러 개의 XML 유형은 Java Bean이나 원시에 맵핑할 수 없습니다. 이런 경우 WSDL2Java 명령은 유형을 SAAJ SOAPElement에 맵핑합니다. SAAJ SOAPElement는 메시지에서 요소의 일반 표시입니다. SOAPElement의 메소드를 사용하여 요소와 해당 하위를 평가할 수 있습니다.
  • Java 클래스에서 SDO Facade 생성: 이는 JAX-RPC 스키마가 마법사에서 기본적으로 사용하는 Java 맵핑을 부분적으로 사용할 수 없도록 설정하며 대신 XML 스키마의 Java Eclipse EMF SDO 표시를 사용합니다. 이는 XML 스키마에 JAX-RPC 맵핑에서 제대로 처리하지 못하는 컨텐츠가 포함된 경우에 유용하게 사용됩니다. SDO Facade를 생성하려면 데이터 바인딩 사용 안함을 선택하고 SOAPElement를 사용해야 합니다.
  • 로드 가능 Java 클래스를 겹쳐쓰지 않음: 이 옵션은 JAX-RPC 상향식 웹 서비스 마법사에만 해당됩니다. 이 옵션을 선택하면 마법사는 다음과 같은 경우 대상 프로젝트에 Java 클래스를 겹쳐쓰지 않습니다.
    • 프로젝트에 아직 없음
    • 애플리케이션을 서버에서 실행할 때 대상 프로젝트에서 로드할 수 있는 프로젝트, 모듈 또는 JAR 파일에 있음.
    이 옵션을 선택하지 않으면 마법사는 Java 클래스를 대상 프로젝트로 겹쳐쓰고 이로 인해 다른 프로젝트, 모듈이나 JAR 파일에 있는 동일한 이름의 기존 클래스가 마스크됩니다. 이로 인해 런타임 환경 및 컴파일 오류가 발생할 수 있습니다. 이 설정은 웹 서비스 Java 또는 EJB 스켈레톤 마법사에 적용되지 않습니다. 이 설정은 JAX-RPC 상향식 웹 서비스 마법사에만 적용됩니다.
    참고: 이 선택란은 웹 서비스 마법사에 있는 "경고 없이 파일 겹쳐쓰기" 선택란과 관계가 없습니다. 해당 선택란을 선택해도 이 설정이 무시되지 않습니다. 그러나 상향식 시나리오가 실행될 때, WSDL2Java 이미터를 사용하여 WSDL에서 자동 생성되는 Java 코드는 "경고 없이 파일 겹쳐쓰기" 선택란의 설정에 따릅니다. 여기에는 프록시 및 서비스 엔드포인트 인터페이스와 같은 파일이 포함됩니다.
  • 웹 서비스 메타데이터 유지: 이를 선택하면 웹 서비스 메타데이터가 현재 작업공간의 .backup 폴더에 배치됩니다. 프로젝트 메타데이터 파일을 프로젝트의 .backup 폴더에 있는 파일로 바꾸려면 다음을 수행하십시오.
    1. .backup 폴더의 파일을 선택하고 마우스 오른쪽 단추로 클릭한 다음 복사를 선택하십시오.
    2. 메타데이터 파일이 있는 프로젝트의 폴더를 선택하고 마우스 오른쪽 단추로 클릭한 다음 붙여넣기를 선택하십시오. 파일을 겹쳐쓰는지를 묻는 프롬프트가 표시되면 를 선택하십시오.
    참고: 프로젝트의 지정된 보기 내에서 프로젝트의 .backup 폴더에 있는 파일을 보려면 .*resources 필터가 보기에 적용되지 않았는지 확인하십시오(보기 메뉴 > 보기 사용자 정의).
  • 모든 유형에 대해 Java 파일 생성: 이를 선택하면 참조되지 않은 파일을 포함하여 WSDL 파일에 설명된 모든 유형에 대해 Java 파일이 생성됩니다.
  • 스켈레톤 생성에 -noWrappedArrays 사용: 랩핑된 배열 발견 사용 안 함
  • hashcode() 및 equal() 메소드 생성: 생성된 각 Java Bean에 equals 및 hashCode 메소드가 있음을 표시합니다. 기본값은 false입니다.
  • 생성된 Bean이 java.io.Serializable 구현: 생성된 각 Java Bean이 java.io.Serializable을 구현하도록 합니다. 기본값은 false입니다.
  • 상대적 네임스페이스 허용: 이 선택란을 선택하면 웹 서비스 작성 시 상대적 네임스페이스를 사용할 수 있습니다. 상대적 네임스페이스를 사용하면 상호 운용성 문제가 발생할 수 있으므로 권장되지 않습니다. 상대적 네임스페이스를 사용하는 웹 서비스는 WS-I를 준수하지 않는 것으로 간주됩니다.
V6 씬 클라이언트

버전 6.0.2부터 WebSphere Application Server에는 Java SE JAX-RPC 웹 서비스 클라이언트를 빌드 및 실행할 수 있는 JAR가 도입되었습니다. WebSphere v6 씬 클라이언트 옵션을 사용하면 독립형 Java 프로젝트에서 IBM® WebSphere v6 JAX-RPC 웹 서비스를 작성하는 동안 Java 프로젝트에 추가되는 클래스 경로 변수로 사용할 씬 클라이언트를 등록할 수 있습니다.

웹 서비스 환경 설정 페이지에서 WebSphere v6 씬 클라이언트 JAR를 사용 가능하게 하고 등록하도록 선택하면 WebSphere Application Server v6.x를 JRE로 사용하고 Java 1.4 패싯을 사용할 수 있는 Java 프로젝트를 작성할 수 있고 이 프로젝트에 웹 서비스 클라이언트를 생성할 수 있습니다.

  • WebSphere V6 씬 클라이언트 사용: 웹 서비스에 Java SE 씬 클라이언트를 사용하려면 이를 선택하십시오.
  • 경로: ibm-jaxrpc-client.jar에 대한 완전한 경로를 입력하십시오. 발견을 클릭하여 Rational® Application Developer가 이 JAR를 찾도록 하거나 수동으로 경로를 입력하십시오.

JAX-WS 코드 생성

하향식
  • WSDL을 프로젝트로 복사: 작성 중인 웹 서비스에서 WSDL 파일을 웹 서비스 프로젝트로 복사하려면 이를 선택하십시오. 이는 이후에 클라이언트를 작성하거나 다른 사용자를 위해 WSDL을 공개하려는 경우에 유용하게 사용됩니다.
  • 랩퍼 스타일 사용: 문서/리터럴 랩핑 패턴을 구현하는 WSDL 문서의 경우 루트 요소는 XML 스키마에 선언되어 메시지 플로우의 오퍼레이션 랩퍼로 사용됩니다. 요청 및 응답에 대해 별도의 랩퍼 요소 정의가 존재합니다. 더 단순하게, 오퍼레이션과 이름이 동일한 요소(랩퍼 요소)는 분리되어 각 컨텐츠 요소는 생성된 Java 메소드 시그니처의 매개변수가 됩니다.
  • 직렬화 가능 JAXB 클래스 생성: WebSphere Application Server 버전 7.0 및 버전 8.0에서 Java 6 패싯을 사용하도록 설정하면 java.io.Serializable을 구현하는 JAXB 클래스를 생성하도록 선택할 수 있습니다. 이 인터페이스를 구현하지 않는 클래스는 직렬화되거나 역직렬화된 상태를 가지지 않습니다.
  • MTOM 지원 사용: 이 선택란을 선택하면 SOAP MTOM(Message Transmission Optimization Mechanism)이 사용됩니다.
  • XSD 파일에서 스키마 라이브러리 프로젝트 생성: 이를 선택하면 Java 컴파일러에 대해 JAX-WS 스키마를 실행하여 스키마 라이브러리에 스키마 코드가 생성됩니다.
  • 웹 서비스 배치 디스크립터 생성: 런타임에 JAX-WS 웹 서비스 배치 정보가 동적으로 생성되는 경우, 정적 배치 디스크립터는 더 이상 필요하지 않습니다. 이 선택란를 선택하면 배치 디스크립터가 생성됩니다.
  • 생성할 JAX-WS 코드 버전: WebSphere Application Server 버전 7.0 이상에 배치하면 JAX-WS 2.1 호환 코드를 생성할 수 있으며 WebSphere Application Server 버전 8.0을 사용할 경우에는 JAX-WS 2.2 호환 코드를 생성할 수 있습니다. 이전 버전의 서버는 JAX-WS 2.0만 지원합니다.
상향식
  • SOAP 1.2 지원 사용: SOAP 1.1과 SOAP 1.2 바인딩 중에서 선택할 수 있습니다.
  • MTOM 지원 사용: 이 선택란을 선택하면 SOAP MTOM(Message Transmission Optimization Mechanism)이 사용됩니다.
  • Java에서 WSDL로 맵핑 스타일: 이는 Java에서 WSDL로 맵핑 스타일을 지정합니다. 스타일은 웹 서비스와 송수신하는 메시지 인코딩 유형을 정의합니다. 매개변수 스타일은 메소드 매개변수가 전체 메시지 본문을 나타내는지 또는 매개변수가 오퍼레이션 후에 이름이 지정된 최상위 레벨 요소 내에서 랩핑된 요소인지를 판별합니다. 조합은 RPC, 문서/랩핑 또는 문서/베어입니다.
  • 프로젝트에 WSDL 생성: WSDL 파일을 웹 서비스 프로젝트에 생성하려면 이를 선택하십시오. 이는 이후에 클라이언트를 작성하거나 다른 사용자를 위해 WSDL을 공개하려는 경우에 유용하게 사용됩니다.
  • 웹 서비스 배치 디스크립터 생성: 런타임에 JAX-WS 웹 서비스 배치 정보가 동적으로 생성되는 경우, 정적 배치 디스크립터는 더 이상 필요하지 않습니다. 이 선택란를 선택하면 배치 디스크립터가 생성됩니다.
클라이언트
  • 비동기 클라이언트 지원 사용: 비동기 클라이언트를 사용할 수 있게 선택한 경우, 웹 서비스의 각 메소드에 대해 두 개의 추가 메소드가 작성됩니다. 이 메소드는 클라이언트가 비동기로 기능할 수 있도록 하는 폴링 및 콜백 메소드입니다.
  • 직렬화 가능 JAXB 클래스 생성: WebSphere Application Server 버전 7.0 및 버전 8.0에서 Java 6 패싯을 사용하도록 설정하면 java.io.Serializable을 구현하는 JAXB 클래스를 생성하도록 선택할 수 있습니다. 이 인터페이스를 구현하지 않는 클래스는 직렬화되거나 역직렬화된 상태를 가지지 않습니다.
  • 이식 가능 클라이언트 생성: 이 선택란을 선택하면 한 시스템에서 다른 시스템으로 또는 WebSphere Application Server의 한 인스턴스에서 다른 인스턴스로 웹 서비스 클라이언트 코드를 이동할 수 있습니다. 이 옵션이 선택되면 WSDL 문서와 이 문서가 종속된 모든 XML 스키마 및 기타 WSDL 문서가 WEB-INF/wsdl 아래의 클라이언트 프로젝트에 복사되며 이 사본을 가리키는 file:relativeURL이 JAX-WS 서비스 클래스의 정적 초기화 블록에 삽입됩니다.
  • 웹 서비스 배치 디스크립터 생성: 런타임에 JAX-WS 웹 서비스 배치 정보가 동적으로 생성되는 경우, 정적 배치 디스크립터는 더 이상 필요하지 않습니다. 이 선택란를 선택하면 배치 디스크립터가 생성됩니다.
  • overriddenEndpointURI 템플리트 생성: 사용하도록 설정한 경우 웹 서비스를 호출할 때 클라이언트에서 사용되는 엔드포인트 URL을 대체하는 WebSphere 확장 배치 디스크립터가 생성됩니다. 이는 클라이언트에서 JSR-109를 사용하는 경우(즉, 클라이언트 service-ref 배치 디스크립터가 있음)에만 적용됩니다. 그렇지 않으면 클라이언트가 관리되지 않는 양식에서 실행되고 이 설정이 무시됩니다. 배치 디스크립터를 생성하고 TCP/IP 모니터를 사용하도록 시도하는 경우 엔드포인트가 고정되고 TCP/IP 모니터에 트래픽이 표시되지 않습니다.
  • MTOM 지원 사용: 이 선택란을 선택하면 SOAP MTOM(Message Transmission Optimization Mechanism)이 사용됩니다.
  • 생성할 JAX-WS 코드 버전: WebSphere Application Server 버전 7.0 이상에 배치하면 JAX-WS 2.1 호환 코드를 생성할 수 있습니다. 이전 버전의 서버는 JAX-WS 2.0만 지원합니다.

피드백