Anotações de JAX-WS 2.0 (JSR 224)

A especificação JSR 224 define anotações para o JAX-WS 2.0.

Nota: A classe Java™ que contém cada anotação no padrão JSR 224 é denominada javax.xml.ws.xxx, em que xxx é o nome da anotação após o caractere '@'. Por exemplo, o nome de classe Java para a anotação @BindingType é javax.xml.ws.bindingtype.
Nome: Descrição: Propriedades: Definições:
@BindingType Esta anotação especifica qual ligação usar ao publicar um terminal desse tipo. Se a anotação não for especificada, o valor padrão será SOAP11_HTTP_BINDING.

Você pode aplicar essa anotação a uma classe de implementação de JavaBeans para um terminal em serviço que é baseado na Interface de Terminal em Serviço ou na interface do Provedor.

Importante:

Use a anotação @BindingType na classe de implementação de terminal JavaBeans para ativar o Message Transmission Optimization Mechanism (MTOM), especificando SOAP11_HTTP_MTOM_BINDING ou SOAP12_HTTP_MTOM_BINDING como o valor para a anotação.

  • Destino da anotação: Tipo
  • Propriedades:
    - value
    Indica o endereço da Web do identificador de ligação. (Sequência de Caracteres)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public  @interface BindingType{
	String value() default SOAP11_HTTP_BINDING;
};
@RequestWrapper Essa anotação fornece o bean do wrapper de solicitação gerado pelo JAXB, o nome de elemento e o namespace para serialização e desserialização com o bean do wrapper de solicitação usado no tempo de execução.

Ao iniciar com um objeto Java, esse elemento é usado para resolver conflitos de sobrecarga no modo literal de documento. Somente o atributo className é necessário neste caso.

Essa anotação pode ser aplicada a métodos em uma Service Endpoint Interface (SEI) de cliente ou servidor, ou em uma classe de implementação de terminal em serviço para um terminal de JavaBeans.

  • Destino da anotação: Método
  • Propriedades:
    - localName
    Especifica o nome local do elemento do esquema XML que representa o wrapper de solicitação. O valor padrão é operationName, conforme definido na anotação javax.jws.WebMethod. (Sequência de Caracteres)
    - targetNamespace
    Especifica o espaço de nomes XML do método do wrapper de pedido. O valor-padrão é o namespace de destino da SEI. (Sequência de Caracteres)
    - className
    Especifica o nome da classe que representa o wrapper de solicitação. (Sequência de Caracteres)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface RequestWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ResponseWrapper Essa anotação fornece o bean do wrapper de resposta gerado por JAXB, o nome de elemento e o namespace para serialização e desserialização com o bean do wrapper de resposta que é usado no tempo de execução.

Ao iniciar com um objeto Java, use esse elemento para resolver conflitos de sobrecarga enquanto está no modo literal de documento. Somente o atributo className é necessário neste caso.

É possível aplicar essa anotação a métodos em uma Service Endpoint Interface (SEI) de cliente ou servidor, ou em uma classe de implementação de terminal em serviço para um terminal de Java beans.

  • Destino da anotação: Método
  • Propriedades:
    - localName
    Especifica o nome local do elemento do esquema XML que representa o wrapper de solicitação. O valor padrão é operationName +resposta. operationName é definido na anotação javax.jws.WebMethod. (Sequência de Caracteres)
    - targetNamespace
    Especifica o espaço de nomes XML do método do wrapper de pedido. O valor-padrão é o namespace de destino da SEI. (Sequência de Caracteres)
    - className
    Especifica o nome da classe que representa o wrapper de resposta. (Sequência de Caracteres)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface ResponseWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ServiceMode Esta anotação especifica se um provedor de serviços deve ter acesso a um protocolo de mensagem inteiro ou apenas à carga útil da mensagem.
Importante: A anotação @ServiceMode é suportada apenas em classes que possuem a anotação @WebServiceProvider.
  • Destino da anotação: Tipo
  • Propriedades:
    - value
    Indica se a classe do provedor aceita a carga útil da mensagem, PAYLOAD, ou a mensagem inteira, MESSAGE. O valor padrão é PAYLOAD. (Sequência de Caracteres)
@Retention(valor = RetentionPolicy.RUNTIME)
@Target({TYPE})
@Inherited
public @interface ServiceMode{
Service.Mode value() default javax.xml.ws.Service.Mode.PAYLOAD; 
};	
@WebFault Essa anotação mapeia as falhas WSDL para exceções Java. Use essa anotação para capturar o nome da falha; essa captura ocorre durante a serialização do tipo JAXB que é gerado a partir de um elemento global que é referido por uma mensagem de falha WSDL. Você pode também usar essa anotação para customizar o mapeamento de exceções específicas do serviço para falhas WSDL.

Você pode aplicar essa anotação a uma classe de implementação de falha.

  • Destino da anotação: Tipo
  • Propriedades:
    - name
    Especifica o nome local do elemento XML que representa a falha correspondente no arquivo WSDL. Você deve especificar o valor real. (Sequência de Caracteres)
    - targetNamespace
    Especifica o espaço de nomes do elemento XML que representa a falha correspondente no arquivo WSDL. (Sequência de Caracteres)
    - faultBean
    Especifica o nome da classe de bean de falha. (Sequência de Caracteres)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface WebFault{
	String name() default “”; 
	String targetNamespace() default “”;
	String faultBean() default “”;
};
Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: rwsandoc004.html