Vous pouvez configurer la façon dont un client ou un service Web JAX-WS (Java™ API for XML Web Services) ou un service Web gère le contexte Web Services Atomic Transaction (WS-AT) ou Web Services Business Activity (WS-BA)
en configurant le type de règle WS-Transaction (Web Services
Transaction). Vous pouvez indiquer que le client ou le service doit utiliser le contexte, peut utiliser le contexte s'il est disponible ou ne doit pas utiliser le contexte. Utilisez des scripts de commandes pour configurer un ensemble de règles pour des transactions de services Web.
Pourquoi et quand exécuter cette tâche
Vous pouvez configurer un ensemble de règles WS-Transaction à l'aide de l'outil de script
wsadmin, comme décrit dans cette tâche, ou en utilisant console d'administration.
Remarque : Le support de l'ensemble de règles WS-Transaction n'existe qu'au niveau de l'application et des services.
Bien que la console d'administration permettent d'associer des règles/liaisons
WS-Transaction au niveau du noeud final et/ou au niveau des opérations, celles-ci ne sont pas appliquées.
Procédure
- Démarrez le client de scriptage wsadmin s'il ne l'est pas déjà.
- Utilisez la commande createPolicySet pour créer un ensemble de règles ou la commande copyPolicySet pour copier et renommer un ensemble de règles existant. Vous pouvez copier un ensemble de règles existant défini par l'utilisateur ou l'un des ensembles de règles WS-Transaction par défaut (WSTransaction ou SSL WSTransaction).
- Vérifiez que votre ensemble de règles inclut le type de règles WS-Transaction. Si nécessaire, ajoutez le type de règles WS-Transaction. Exemple :
AdminTask.importPolicySet('[-defaultPolicySet WSTransaction]')
AdminTask.addPolicyType('[-policySet policy_set_name
-policyType WSTransaction -enabled true]')
- Utilisez la commande setPolicyType pour configurer les attributs du type de règle WS-Transaction. Les attributs du type WS-Transaction sont les suivants :
- ATAssertion
- BAAtomicOutcomeAssertion
Chaque attribut peut avoir la valeur supports, mandatory ou never. Pour plus d'informations sur ces attributs configurables, reportez-vous à la rubrique relative aux paramètres de règle WS-Transaction. Exemple :AdminTask.setPolicyType('[-policySet policy_set_name
-policyType WSTransaction
-attributes "[ [BAAtomicOutcomeAssertion mandatory] [ATAssertion supports] ]"]
-replace')
- Sauvegardez les modifications dans la configuration principale. Par exemple, entrez la commande suivante :
AdminConfig.save()
Que faire ensuite
Vous êtes désormais prêt à associer l'ensemble de règles au client JAX-WS ou au service, au noeud final ou à l'opération JAX-WS.