Annotations JAX-WS 2.0 (JSR 224)

La spécification JSR 224 définit des annotations pour JAX-WS 2.0.

Remarque : La classe Java™ qui contient chaque annotation dans la norme JSR 224 s'appelle javax.xml.ws.xxx, où xxx est le nom de l'annotation après le caractère '@'. Par exemple, le nom de classe Java pour l'annotation @BindingType est javax.xml.ws.bindingtype.
Nom : Description : Propriétés : Définitions :
@BindingType Cette annotation spécifie la liaison à utiliser lorsque vous publiez un noeud final de ce type. Si l'annotation n'est pas spécifiée, la valeur par défaut est SOAP11_HTTP_BINDING.

Vous pouvez appliquer cette annotation à une classe d'implémentation JavaBeans pour un noeud final de service qui repose sur l'interface de noeud final de service ou l'interface de fournisseur.

Important :

Utilisez l'annotation @BindingType dans la classe d'implémentation de noeud final JavaBeans pour activer le mécanisme d'optimisation de transmission des messages (MTOM), en spécifiant SOAP11_HTTP_MTOM_BINDING ou SOAP12_HTTP_MTOM_BINDING comme valeur pour l'annotation.

  • Cible de l'annotation : Type
  • Propriétés :
    - value
    Indique l'adresse Web d'identification de liaison. (Chaîne)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public  @interface BindingType{
	String value() default SOAP11_HTTP_BINDING;
};
@RequestWrapper Cette annotation fournit le bean encapsuleur de demande généré par JAXB, le nom d'élément et l'espace de nom pour la sérialisation et la désérialisation avec le bean encapsuleur de demande utilisé au moment de l'exécution.

Lors du démarrage à l'aide d'un objet Java, cet élément sert à résoudre les conflits de surcharge en mode document/littéral. Seul l'attribut className est requis dans ce cas.

Cette annotation peut être appliquée à des méthodes dans une interface de noeud final de service client ou serveur, ou dans une classe d'implémentation de noeud final de service pour un noeud final JavaBeans.

  • Cible de l'annotation : Méthode
  • Propriétés :
    - localName
    Indique le nom local de l'élément de schéma XML qui représente l'encapsuleur de demande. La valeur par défaut est operationName, comme défini dans l'annotation javax.jws.WebMethod. (Chaîne)
    - targetNamespace
    Indique l'espace de nom XML de la méthode d'encapsulation de demande. La valeur par défaut est l'espace de nom cible de l'interface SEI. (Chaîne)
    - className
    Indique le nom de la classe qui représente l'encapsuleur de demande. (Chaîne)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface RequestWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ResponseWrapper Cette annotation fournit le bean encapsuleur de réponse généré par JAXB, le nom d'élément et l'espace de nom pour la sérialisation et la désérialisation avec le bean encapsuleur de réponse utilisé au moment de l'exécution.

Lors du démarrage avec un objet Java, utilisez cet élément pour résoudre les conflits de surcharge en mode document/littéral. Seul l'attribut className est requis dans ce cas.

Vous pouvez appliquer cette annotation à des méthodes dans une interface de noeud final de service client ou serveur, ou dans une classe d'implémentation de noeud final de service pour un noeud final de beans Java.

  • Cible de l'annotation : Méthode
  • Propriétés :
    - localName
    Indique le nom local de l'élément de schéma XML qui représente l'encapsuleur de demande. La valeur par défaut est operationName + réponse. La valeur par défaut operationName est définie dans l'annotation javax.jws.WebMethod. (Chaîne)
    - targetNamespace
    Indique l'espace de nom XML de la méthode d'encapsulation de demande. La valeur par défaut est l'espace de nom cible de l'interface SEI. (Chaîne)
    - className
    Indique le nom de la classe qui représente l'encapsuleur de réponse. (Chaîne)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface ResponseWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ServiceMode Cette annotation indique si un fournisseur de services doit avoir accès à la totalité d'un message de protocole ou juste à la charge du message.
Important : L'annotation @ServiceMode est prise en charge uniquement dans les classes comportant l'annotation @WebServiceProvider.
  • Cible de l'annotation : Type
  • Propriétés :
    - value
    Indique si la classe de fournisseur accepte la charge du message, PAYLOAD, ou la totalité du message, MESSAGE. La valeur par défaut est PAYLOAD. (Chaîne)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
@Inherited
public @interface ServiceMode{
Service.Mode value() default javax.xml.ws.Service.Mode.PAYLOAD; 
};	
@WebFault Cette annotation mappe les erreurs WSDL à des exceptions Java. Utilisez-la pour capturer le nom de l'erreur ; cette capture au lieu au cours de la sérialisation du type JAXB qui est généré à partir d'un élément global référencé par un message d'erreur WSDL. Vous pouvez aussi utiliser cette annotation pour personnaliser le mappage d'exceptions propres à un service à des erreurs WSDL.

Vous pouvez appliquer cette annotation à une classe d'implémentation d'erreur.

  • Cible de l'annotation : Type
  • Propriétés :
    - name
    Indique le nom local de l'élément XML représentant l'erreur correspondante dans le fichier WSDL. Vous devez spécifier la valeur réelle. (Chaîne)
    - targetNamespace
    Indique l'espace de nom de l'élément XML représentant l'erreur correspondante dans le fichier WSDL. (Chaîne)
    - faultBean
    Indique le nom de la classe de bean d'erreur. (Chaîne)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface WebFault{
	String name() default “”; 
	String targetNamespace() default “”;
	String faultBean() default “”;
};
Icône indiquant le type de rubrique Rubrique de référence
Dispositions pour les centres de documentation | Commentaires en retour

Icône d'horodatage Dernière mise à jour: May 29, 2014 10:11

Nom de fichier : rwsandoc004.html