Les ensembles de règles peuvent simplifier votre configuration de qualité de
service pour les services Web en combinant les paramètres de configuration des services,
tels que l'adressage, la messagerie et la sécurité. Pour utiliser des ensembles de règles
dans un client non géré, structurez-les de sorte qu'ils puissent être utilisés par le
client sur l'appel de ligne de commande.
Avant de commencer
Avant de créer des ensembles de règles ou d'en modifier des existants, identifiez la sécurité et les autres
exigences du service Web.
Remarque : Vous ne pouvez
utiliser des ensembles de règles qu'avec des applications JAX-WS s'exécutant sur
le moteur de service Web Axis2. Vous ne pouvez pas utiliser des ensembles de règles
pour des applications JAX-RPC.
Pourquoi et quand exécuter cette tâche
Les ensembles de règles sont des assertions sur la manière dont les
services sont définis ; vous pouvez les utiliser pour contrôler les services Web au
niveau de l'application ou du système. Les ensembles de règles peuvent être gérés via le serveur d'applications pour les
services déployés, mais si vous utilisez un client léger, qui n'est pas géré,
vous devez configurer les ensembles de règles manuellement pour en bénéficier.
Procédure
- Créez un ensemble de règles ou exportez un ensemble de règles existant
à partir du serveur d'applications.
- Pour un nouvel ensemble de règles, créez les fichiers de cet ensemble de règles à
l'aide de scripts ou de la console d'administration. Pour plus d'informations sur la
gestion des ensembles de règles des services Web, reportez-vous à la rubrique Gestion des ensembles de règles à l'aide de la console d'administration.
- Pour exporter un ensemble de règles existant :
- Sélectionnez
- Sélectionnez l'ensemble de règles à exporter dans la liste.
- Cliquez sur Exporter...
- Cliquez sur le nom de l'ensemble de règles pour télécharger le fichier archive.
- Placez les fichiers de l'ensemble de règles dans le répertoire META-INF de
sorte qu'ils puissent être utilisés par le client non géré.
Eviter les incidents: Si vous avez exporté un ensemble de règles à partir du serveur
d'applications, vous devez extraire les fichiers de l'ensemble de règles de l'archive et
les placer dans le répertoire META-INF.
gotcha
Voici un exemple de
structure de fichier d'une collection d'ensemble de règles : -META-INF
-PolicySets
-policy_set1
policySet.xml
-PolicyTypes
-policy_type1
policy.xml
-policy_type2
policy.xml
-policy_set2
...
- Créez le fichier clientPolicyAttachments.xml, qui fait référence
aux ensembles de règles à implémenter et placez-le dans le répertoire META-INF.
- Créez le fichier clientPolicyAttachments.xml dans Rational
Application Developer ou un autre outil de développement. Voici un exemple
de fichier clientPolicyAttachments.xml :
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<psa:PolicySetAttachment
xmlns:psa="http://www.ibm.com/xmlns/prod/websphere/200605/policysetattachment"
xmlns:ps="http://www.ibm.com/xmlns/prod/websphere/200605/policyset">
<psa:PolicySetReference name="policy_set1" id="1342">
<psa:Resource pattern="WebService:/">
</psa:Resource>
</psa:PolicySetReference>
</psa:PolicySetAttachment>
- Vérifiez que le fichier clientPolicyAttachments.xml se trouve
dans le répertoire META-INF.
- Créez une liaison d'ensemble de règles client générale ou spécifique à
une application, compatible à l'ensemble de règles. Vous pouvez
exporter une liaison générale à partir du serveur d'applications ou utiliser un
outil de développement tel que Rational Application Developer pour créer une liaison
spécifique à une application. Pour plus d'informations sur les liaisons, voir Définition et gestion de liaisons d'ensemble de règles. Pour exporter
une liaison à partir du serveur d'applications :
- Sélectionnez
- Sélectionnez la liaison à exporter à partir de la liste.
- Cliquez sur Exporter...
- Cliquez sur le nom de la liaison pour télécharger le fichier archive.
- Placez les fichiers de liaison dans le répertoire META-INF de
sorte qu'ils puissent être utilisés par le client non géré.
Eviter les incidents: Si vous avez exporté des liaisons à partir du serveur d'applications, vous devez
extraire les fichiers de l'archive et les placer dans le
répertoire META-INF.
gotcha
La structure de fichier est différente si vous utilisez des liaisons générales
ou des liaisons spécifiques à l'application :- Voici un exemple d'un ensemble de liaisons générales, qui se trouvent dans le
sous-répertoire des liaisons :
-META-INF
-bindings
-binding1
bindingDefinition.xml
-PolicyTypes
-policy_type1
bindings.xml
-policy_type2
bindings.xml</p><p>
-binding2
...
- Voici un exemple de liaison spécifique à l'application, pour lequel il n'existe pas de
sous-répertoire de liaisons :
-META-INF
-binding1
bindingDefinition.xml
-PolicyTypes
-policy_type1
bindings.xml
-policy_type2
bindings.xml
-binding2
...
- Vérifiez que l'emplacement de l'ensemble de règles et des liaisons
se trouve dans le chemin d'accès aux classes lorsque vous démarrez votre client léger. Par
exemple, vous pouvez indiquer le chemin d'accès aux classes sur la ligne de commande :
java -cp ensemble_règles/
mon_client