Utilisation des fichiers de propriétés pour les fragments d'URL de noeud final des services Web

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

  1. 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
  2. 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 ]')
  3. 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']) 
  4. 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.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_wbs_endptURL_prop
Nom du fichier : txml_wbs_endptURL_prop.html