Vous pouvez utiliser des fichiers de propriétés pour gérer ou changer les fragments d'URL de noeud final pour les services Web accessibles via HTTP, SOAP et
Java™ Message Service (JMS), ou directement en tant que beans enterprise. Les fragments d'URL permettent de former des adresses complètes de
noeud final de services Web, incluses dans des fichiers WSDL (Web Services
Description Language) publiés.
Avant de commencer
Les fragments d'URL de noeud final sont des métadonnées facultatives
pour les applications de services Web. La gestion et la configuration des fragments d'URL est réalisée en utilisant soit la console d'administration, soit les fichiers de propriété. Avant de pouvoir interroger les fragments d'URL, vous devez les définir, soit par le biais de la console d'administration, soit en utilisant la commande applyConfigProperties. Lorsqu'ils ont été définis à l'aide de la console administrative ou des
fichiers de propriété, vous pouvez les modifier de la même manière.
Pour en savoir plus sur l'utilisation de la console d'administration pour définir les fragments d'URL, consultez les rubriques relatives à la configuration des informations d'URL de noeud final pour les liaisons HTTP et JMS.
Pourquoi et quand exécuter cette tâche
La version 8.0 et les versions ultérieures prennent
en charge l'utilisation des fichiers de propriétés pour la gestion des fragments
d'URL de noeud final des services Web dont l'accès s'effectue par HTTP, SOAP et
JMS (Java Message Service), ou
directement par des beans enterprise.
Vous pouvez spécifier une
portion de l'URL de noeud final à utiliser dans chaque module de service Web. La portion spécifiée est utilisée pour créer le noeud final effectif de l'URL lors de la publication d'un fichier WSDL. Dans un fichier WSDL publié, l'URL définissant l'adresse de noeud final cible se trouve dans l'attribut
location d'un élément soap:address de port. Cette page s'applique aux services Web Java API
for XML-Based Web Services (JAX-WS) et Java API
for XML-based RPC (JAX-RPC).
Les propriétés des fragments d'URL de noeud final de service Web constituent
une extension du fichier de propriétés de l'application. Lorsque vous utilisez la commande extractConfigProperties pour obtenir le fichier de propriétés d'une application, vous obtenez également, parmi les autres propriétés, les fragments d'URL de noeud final. Utilisez les commandes applyConfigProperties, validateConfigProperties et
deleteConfigProperties décrites dans cette procédure pour mettre à jour,
valider ou supprimer des fragments d'URL de noeud final dans une application de
service Web.
Procédure
- Extrayez le fichier de propriétés.
Par exemple, utilisez la commande extractConfigProperties pour extraire les propriétés de l'application sampleApplication.
AdminTask.extractConfigProperties(['-propertiesFileName', 'myProperties.props', '-configData', 'Deployment=sampleApplication' ])
Si vous aviez déjà configuré les fragments d'URL de noeud final des services
Web, le système extrait les fichiers de propriétés, et le résultat contient une
section réservée à ces fragments, illustrée dans l'exemple ci-dessous :
#
# CWSAD0103I: URLPrefixMap Section: module=TestApp.jar
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
ExtensionId=ApplicationWebServicesExtension
#
#
#Properties
http=http://myhostname:80
module=TestApp.jar
- Créez une nouvelle instance du fichier de propriétés.
Si vous modifiez les propriétés du fragment d'URL existant, ou si vous créez de nouvelles propriétés, utilisez la commande suivante pour appliquer les propriétés de fragment d'URL. Cette commande crée ou met à jour le fichier de métadonnées correspondant dans l'application spécifiée. Dans l'exemple qui suit, le paramètre facultatif
-reportFileName sert à demander la production d'un rapport par la commande.
AdminTask.applyConfigProperties('[-propertiesFileName myProperties.props -reportFileName report.txt ]')
- Validez le fichier de propriétés.
La commande validateConfigProperties valide les noms et les valeurs des propriétés dans le fichier de propriétés. Si tous les noms et toutes les valeurs sont valides, le résultat de la commande est true. Dans le cas contraire, la commande renvoie la valeur false, par exemple :
AdminTask.validateConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName',
'report.txt'])
- Supprimez le fichier de propriétés.
Lorsqu'une commande deleteConfigProperties est appelée, la commande supprime toutes les propriétés qui sont spécifiées dans le fichier de propriétés. Si vous partez d'un fichier de propriétés extrait précédemment, supprimez toutes les sections figurant dans le fichier de propriétés, sauf les sections auxquelles appliquer la commande deleteConfigProperties. Par exemple, si vous voulez supprimer une mappe de préfixes d'URL, supprimez toutes les sections du fichier de propriétés extrait sauf la section de mappe de préfixes d'URL et éventuellement la section des variables d'environnement, si vous utilisez des variables.
La commande deleteConfigProperties supprime les propriétés spécifiées dans le fichier de propriétés, par exemple :
AdminTask.deleteConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName',
'report.txt'])
Le fichier myProperties.txt suivant est un exemple
de fichier de propriétés que vous pouvez utiliser pour procéder à la suppression
d'une mappe de préfixes d'URL http URL
pour le module TestApp.jar :
#
# CWSAD0103I: URLPrefixMap Section: module=TestApp.jar
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
ExtensionId=ApplicationWebServicesExtension
#
#
#Properties
http=http://myhostname:80
module=TestApp.jar
#
#
EnvironmentVariablesSection
#
#
#Environment Variables
applicationName=TestApp
cellName=XYZNode01Cell
serverName=server1
nodeName=XYZNode01
Résultats
Vous pouvez utiliser des fichiers de propriétés de services Web pour interroger, configurer et gérer le fragment d'URL de noeud final de service Web pour différents protocoles.