JAX-WS 2.0 어노테이션(JSR 224)

JSR 224 스펙은 JAX-WS 2.0의 어노테이션을 정의합니다.

참고: JSR 224 표준의 각 어노테이션을 포함하는 Java™ 클래스 이름은 javax.xml.ws.xxx이며 여기서 xxx는 '@' 문자 다음에 오는 어노테이션 이름입니다. 예를 들어, @BindingType 어노테이션의 Java 클래스 이름은 javax.xml.ws.bindingtype입니다.
이름: 설명: 특성: 정의:
@BindingType 이 어노테이션은 이 유형의 엔드포인트를 공개할 때 사용하는 바인딩을 지정합니다. 어노테이션을 지정하지 않은 경우 기본값은 SOAP11_HTTP_BINDING입니다.

이 어노테이션을 SEI(Service Endpoint Interface) 또는 제공자 인터페이스를 기반으로 하는 서비스 엔드포인트에 대한 JavaBeans 구현에 적용할 수 있습니다.

중요:

SOAP11_HTTP_MTOM_BINDING 또는 SOAP12_HTTP_MTOM_BINDING을 어노테이션 값으로 지정하여 MTOM(Message Transmission Optimization Mechanism)을 사용 가능하게 설정하려면 @BindingType 어노테이션을 JavaBeans 엔드포인트 구현 클래스에서 사용하십시오.

  • 어노테이션 대상: 유형
  • 특성:
    - value
    바인딩 ID 웹 주소를 표시합니다. (문자열)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public  @interface BindingType{
	String value() default SOAP11_HTTP_BINDING;
};
@RequestWrapper 이 어노테이션은 JAXB 생성 요청 랩퍼 Bean, 요소 이름, 런타임에서 사용된 요청 랩퍼 Bean이 포함된 직렬화 및 직렬화 해제에 대한 네임스페이스를 제공합니다.

Java 오브젝트를 시작하는 경우에 이 요소는 문서 리터럴 모드에서 과부하 충돌을 해결할 때 사용됩니다. className 속성만 이 경우에 필요합니다.

이 어노테이션은 클라이언트나 서버 SEI(Service Endpoint Interface) 또는 JavaBeans 엔드포인트의 서비스 엔드포인트 구현 클래스에만 적용할 수 있습니다.

  • 어노테이션 대상: 메소드
  • 특성:
    - localName
    요청 랩퍼를 나타내는 XML 스키마 요소의 로컬 이름을 지정합니다. 기본값은 javax.jws.WebMethod 어노테이션에 정의된 대로 operationName입니다. (문자열)
    - targetNamespace
    요청 랩퍼 메소드의 XML 네임스페이스를 지정합니다. 기본값은 SEI의 대상 네임스페이스입니다. (문자열)
    - className
    요청 랩퍼를 나타내는 클래스 이름을 지정합니다.(문자열)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface RequestWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ResponseWrapper 이 어노테이션은 JAXB 생성 응답 랩퍼 Bean, 요소 이름, 런타임에서 사용된 응답 랩퍼 Bean이 포함된 직렬화 및 직렬화 해제에 대한 네임스페이스를 제공합니다.

Java 오브젝트를 시작하는 경우에 문서 리터럴 모드에서 과부하 충돌을 해결할 때 이 요소를 사용하십시오. className 속성만 이 경우에 필요합니다.

이 어노테이션을 클라이언트나 서버 SEI(Service Endpoint Interface) 또는 Java Bean의 엔드포인트의 서비스 엔드포인트 구현 클래스의 메소드에 적용할 수 있습니다.

  • 어노테이션 대상: 메소드
  • 특성:
    - localName
    요청 랩퍼를 나타내는 XML 스키마 요소의 로컬 이름을 지정합니다. 기본값은 operationName + response입니다. operationName은 javax.jws.WebMethod 어노테이션에 정의됩니다. (문자열)
    - targetNamespace
    요청 랩퍼 메소드의 XML 네임스페이스를 지정합니다. 기본값은 SEI의 대상 네임스페이스입니다. (문자열)
    - className
    응답 랩퍼를 나타내는 클래스 이름을 지정합니다. (문자열)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface ResponseWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ServiceMode 이 어노테이션은 서비스 제공자가 전체 메시지 프로토콜에 액세스해야 하는지 또는 메시지 페이로드에만 액세스하는 지를 지정합니다.
중요사항: @ServiceMode 어노테이션은 @WebServiceProvider 어노테이션이 있는 클래스에서만 지원됩니다.
  • 어노테이션 대상: 유형
  • 특성:
    - value
    제공자 클래스가 메시지 페이로드인 PAYLOAD 또는 전체 메시지인 MESSAGE를 허용하는지를 표시합니다. 기본값은 PAYLOAD입니다. (문자열)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
@Inherited
public @interface ServiceMode{
Service.Mode value() default javax.xml.ws.Service.Mode.PAYLOAD; 
};	
@WebFault 이 어노테이션은 WSDL 결함을 Java 예외에 맵핑합니다. 이 어노테이션을 사용하여 결함 이름을 캡처하십시오. 캡처는 WSDL 결함 메시지에서 참조되는 글로벌 요소에서 생성된 JAXB 유형 직렬화 중에 수행됩니다. 이 어노테이션을 사용하여 서비스 고유 예외에서 WSDL 결함으로의 맵핑을 사용자 정의할 수도 있습니다.

이 어노테이션은 결함 구현 클래스에 적용할 수 있습니다.

  • 어노테이션 대상: 유형
  • 특성:
    - name
    WSDL 파일의 해당 결함을 나타내는 XML 요소의 로컬 이름을 지정합니다. 실제 값을 지정해야 합니다. (문자열)
    - targetNamespace
    WSDL 파일의 해당 결함을 나타내는 XML 요소의 네임스페이스를 지정합니다. (문자열)
    - faultBean
    결함 Bean 클래스 이름을 지정합니다. (문자열)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface WebFault{
	String name() default “”; 
	String targetNamespace() default “”;
	String faultBean() default “”;
};
주제 유형을 표시하는 아이콘 참조 주제
Information Center의 이용 약관 | 피드백

시간소인 아이콘 마지막 업데이트 날짜: 2014-05-22

파일 이름: rwsandoc004.html