Cette règle marque les références à : <handler> à l'intérieur de l'élément web.xml , webservicesclient.xml , webservices.xml , et ejb-jar.xml . Les gestionnaires sont des unités de traitement supplémentaires appliquées à chaque demande ou réponse. Ils peuvent être enchaînés les uns aux autres, permettant à plusieurs gestionnaires de traiter une demande en séquence. Lorsqu'un client envoie une demande, celle-ci est traitée par chaque gestionnaire dans l'ordre spécifié dans les descripteurs de déploiement avant d'être envoyée à un fournisseur par chaque gestionnaire dans l'ordre spécifié dans les descripteurs de déploiement avant d'être envoyée à un fournisseur. Par exemple par exemple, pour enregistrer chaque demande d'un client, vous pouvez définir un gestionnaire qui lit chaque message de demande et l'écrit dans un fichier dans un fichier. Les gestionnaires peuvent également modifier les demandes et les réponses. En raison de l'implémentation des nouvelles classes énumérées ci-dessous, toutes les méthodes surchargées ou implémentées dans la classe handler ont été mises à jour.
Un certain nombre de changements importants ont été apportés à l'API du gestionnaire entre JAX-RPC et JAX-WS
sont :
- Un changement de convention d'appellation. De
javax.xml.rpc.handler.Handler
à
javax.xml.ws.handler.soap.SoapHandler
.
- Le retrait d'un
HandlerInfo
objet.
- La suppression des deux classes que les gestionnaires devaient auparavant implémenter/extendre. Il s'agit de
javax.xml.rpc.handler.Handler
et
javax.xml.rpc.handler.GenericHandler
. Les gestionnaires doivent maintenant implémenter
javax.xml.ws.handler.soap.SoapHandler
ou
javax.xml.ws.handler.LogicalHandler
.
L'exemple suivant d'un LoggingHandler illustre la différence de mise en œuvre entre les JAX-RPC Handlers et les JAX-WS SOAPHandlers
exemple suivant d'un LoggingHandler.
Lorsque vous utilisez les gestionnaires JAX-RPC, votre déclaration de classe doit ressembler à ce qui suit
donc :
Et de définir la même classe en utilisant les Soap Handlers dans JAX-WS :