Anotaciones de JAX-WS 2.0 (JSR 224)

La especificación JSR 224 define anotaciones para JAX-WS 2.0.

Nota: La clase Java™ que contiene cada anotación en el estándar JSR 224 se denomina javax.xml.ws.xxx, donde xxx es el nombre de la anotación después del carácter '@'. Por ejemplo, el nombre de clase Java para la anotación @BindingType es javax.xml.ws.bindingtype.
Nombre: Descripción: Propiedades: Definiciones:
@BindingType Esta anotación especifica qué enlace se utiliza cuando publica un punto final de este tipo. Si la anotación no se especifica, el valor predeterminado es SOAP11_HTTP_BINDING.

Puede aplicar esta anotación a una clase de implementación de JavaBeans para un punto final de servicio que se basa en la interfaz de punto final de servicio o la interfaz de proveedor.

Importante:

Utilice la anotación @BindingType en la clase de implementación de punto final de JavaBeans para habilitar el mecanismo de optimización de transmisión de mensajes (MTOM), especificando SOAP11_HTTP_MTOM_BINDING o SOAP12_HTTP_MTOM_BINDING como el valor de la anotación.

  • Destino de anotación: Type
  • Propiedades:
    - value
    Indica la dirección web del identificador del enlace. (String)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public  @interface BindingType{
	String value() default SOAP11_HTTP_BINDING;
};
@RequestWrapper Esta anotación proporciona el bean de envoltura de solicitud generado por JAXB, el nombre del elemento y el espacio de nombres para la serialización y la deserialización con el bean de envoltura de solicitud que se utiliza en el tiempo de ejecución.

Cuando empieza con un objeto Java, este elemento se utiliza para resolver los conflictos de sobrecarga en la modalidad de literal de documentos. En este caso, sólo se requiere el atributo className.

Esta anotación puede aplicarse a los métodos en una interfaz de punto final de servicio (SEI) de cliente o servidor, o en una clase de implementación de punto final de servicio para un punto final de JavaBeans.

  • Destino de anotación: Method
  • Propiedades:
    - localName
    Especifica el nombre local del elemento del esquema XML que representa la envoltura de solicitud. El valor predeterminado es operationName, como se ha definido en la anotación javax.jws.WebMethod. (String)
    - targetNamespace
    Especifica el espacio de nombres XML del método de envoltura de solicitud. El valor predeterminado es el espacio de nombres de destino de la SEI. (String)
    - className
    Especifica el nombre de la clase que representa la envoltura de solicitud. (String)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface RequestWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ResponseWrapper Esta anotación proporciona el bean de envoltura de respuesta generado por JAXB, el nombre del elemento y el espacio de nombres para la serialización y la deserialización con el bean de envoltura de respuesta que se utiliza en el tiempo de ejecución.

Cuando empieza con un objeto Java, utilice este elemento para resolver los conflictos de sobrecarga en la modalidad de literal de documentos. En este caso, sólo se requiere el atributo className.

Puede aplicar esta anotación a los métodos en una interfaz de punto final de servicio (SEI) de cliente o servidor, o en una clase de implementación de punto final de servicio para un punto final de beans Java.

  • Destino de anotación: Method
  • Propiedades:
    - localName
    Especifica el nombre local del elemento del esquema XML que representa la envoltura de solicitud. El valor predeterminado es operationName más response. $operationName se define en la anotación javax.jws.WebMethod. (String)
    - targetNamespace
    Especifica el espacio de nombres XML del método de envoltura de solicitud. El valor predeterminado es el espacio de nombres de destino de la SEI. (String)
    - className
    Especifica el nombre de la clase que representa la envoltura de respuesta. (String)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface ResponseWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ServiceMode Esta anotación especifica si un proveedor de servicios debe tener acceso a un protocolo de mensaje completo o sólo a la carga útil del mensaje.
Importante: La anotación @ServiceMode sólo está soportada en clases que tienen la anotación @WebServiceProvider.
  • Destino de anotación: Type
  • Propiedades:
    - value
    Indica si la clase de proveedor acepta la carga útil del mensaje, PAYLOAD, o el mensaje completo MESSAGE. El valor predeterminado es PAYLOAD. (String)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
@Inherited
public @interface ServiceMode{
Service.Mode value() default javax.xml.ws.Service.Mode.PAYLOAD; 
};	
@WebFault Esta anotación correlaciona errores de WSDL con excepciones Java. Utilice esta anotación para capturar el nombre del error; esta captura se produce durante la serialización del tipo JAXB que se genera a partir de un elemento global al que se hace referencia en un mensaje de error de WSDL. También puede utilizar esta anotación para personalizar la correlación de excepciones específicas del servicio con los errores de WSDL.

Puede aplicar esta anotación a una clase de implementación anómala.

  • Destino de anotación: Type
  • Propiedades:
    - name
    Especifica el nombre local del elemento XML que representa el error correspondiente en el archivo WSDL. Debe especificar el valor real. (String)
    - targetNamespace
    Especifica el espacio de nombres del elemento XML que representa el error correspondiente en el archivo WSDL. (String)
    - faultBean
    Especifica el nombre de la clase de bean de error. (String)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface WebFault{
	String name() default “”; 
	String targetNamespace() default “”;
	String faultBean() default “”;
};
Icono que indica el tipo de tema Tema de referencia
Términos y condiciones para centros de información | Comentarios

Icono de indicación de fecha y hora Última actualización: 22 de abril de 2014

Nombre de archivo: rwsandoc004.html