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 폴더에 있는 파일로 바꾸려면 다음을 수행하십시오.
- .backup 폴더의 파일을 선택하고 마우스 오른쪽 단추로 클릭한 다음 복사를 선택하십시오.
- 메타데이터 파일이 있는 프로젝트의 폴더를 선택하고 마우스 오른쪽 단추로 클릭한 다음
붙여넣기를 선택하십시오. 파일을 겹쳐쓰는지를 묻는 프롬프트가
표시되면 예를 선택하십시오.
참고: 프로젝트의 지정된 보기 내에서
프로젝트의 .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만 지원합니다.