Groupe de commandes WebServicesAdmin pour l'objet AdminTask
Vous pouvez utiliser les langages de script Jython ou Jacl pour configurer la sécurité à l'aide de l'outil wsadmin. Les commandes du groupe WebServicesAdmin permettent de répertorier tous les services web, les références de service et les attributs, de rechercher les attributs d'un service Web particulier, de déterminer le noeud final d'un service web ou de déterminer le nom des opérations d'un service Web.
Utilisez les commandes du groupe WebServicesAdmin pour rechercher des informations relatives aux services Web installés. Pour plus d'informations sur l'objet AdminTask, voir l'article sur les commandes de l'objet AdminTask.
getWebService
La commande getWebService extrait les attributs d'un service Web. Cette commande s'applique uniquement aux applications d'entreprise.
Objet cible
Aucune.
Paramètres obligatoires
- -application
- Indique le nom de l'application d'entreprise déployée. (Chaîne, obligatoire)
- -module
- Spécifie le nom du module. (Chaîne, obligatoire)
- -service
- Indique le nom du service Web. (Chaîne, obligatoire)
Paramètres facultatifs
- -client
- Indique si le service Web est un fournisseur ou un client. La valeur par défaut est false (fournisseur de service). Lorsque la valeur de ce paramètre est true, la commande ne renvoie que des clients de services Web. (Booléen, facultatif)
Valeur renvoyée
Cette commande renvoie une liste d'attributs, y compris le nom de service et le type de service, et indique si le service est un fournisseur ou un client. L'attribut de type de service n'est applicable que pour les fournisseurs de service.
Exemple d'utilisation en mode de traitement par lots
AdminTask.getWebService('[–application application_name -module module_name -service webservice_name
-client false]')
'[[service {http://www.ibm.com}service1][type JAX-WS][client false]]'
Syntaxe d'un exemple de mode interactif
AdminTask.getWebService ('-interactive')
listServices
La commande listServices demande la configuration de services, de noeuds finaux et d'opérations. Cette commande fournit des fonctions de requête plus génériques que le reste des commandes de ce groupe. Elle concerne les applications Java, ainsi que d'autres actifs tels que des clients WSN (Web Services Notification).
Objet cible
Aucune.
Paramètres facultatifs
- -queryProps
- Spécifie les propriétés utilisées pour localiser le fournisseur de services ou le client concerné. Par exemple, si vous spécifiez [[type=JAX-WS][client=true]], la commande renvoie chaque référence de client JAX-WS dans les applications d'entreprise. (Propriétés, facultatif)Le paramètre -queryProps accepte plusieurs propriétés. Vous pouvez utiliser une ou plusieurs propriétés pour spécifier vos critères de recherche. Ne mélangez pas les propriétés de requête entre les différents types d'actif. Par exemple, si vous spécifiez application et bus, la commande signale une erreur.
- Spécifiez les propriétés suivantes avec le paramètre -queryProps pour interroger des applications d'entreprise :
Tableau 1. Propriétés du paramètre -queryProps pour les applications d'entreprise. Utilisez ces propriétés pour interroger les applications d'entreprise. Propriété et valeur Description assetType=J2EE Application Interroge chaque application Java EE. application=nom_application Interroge une application Java EE spécifique. module=nom_module Interroge un module d'application Java EE spécifique. Vous devez spécifier les propriétés application et module pour demander des modules d'application. - Spécifiez les propriétés suivantes avec le paramètre -queryProps pour interroger des clients WSN :
Tableau 2. Propriétés pour l'interrogation des clients WSN. Utilisez ces propriétés pour interroger les clients WSN. Propriété et valeur Description assetType=WSN Service Interroge chaque client de service WSN. bus=nom_bus Interroge un bus spécifique. WSNService=nom_service_WSN Interroge un service WSN spécifique. Vous devez spécifier les propriétés bus et WSNService pour un service WSN spécifique. - Spécifiez les propriétés suivantes avec le paramètre -queryProps pour interroger tous les actifs :
Tableau 3. Propriétés du paramètre -queryProps pour l'interrogation de tous les actifs. Utilisez ces propriétés pour interroger tous les actifs. Propriété et valeur Description serviceType=type_service Interroge par type de service. Spécifiez JAX-WS pour rechercher des actifs JAX-WS (Java API for XML-Based Web Services). Spécifiez JAX-WS (WSN) pour rechercher des actifs WSN (Web Services Notification). client=Booléen Recherche des clients ou des fournisseurs. Spécifiez true pour rechercher des clients. Spécifiez false pour rechercher des fournisseurs. service=nom_service Recherche les noeuds finaux et les opérations logiques pour un service spécifique. - Spécifiez les propriétés suivantes avec le paramètre -queryProps
pour interroger toutes les références de service ou une référence de service spécifique
lorsque client=true :
Tableau 4. Propriétés du paramètre -queryProps pour l'interrogation des références de service. Utilisez ces propriétés pour interroger toutes les références de service des clients de service. Propriété et valeur Description serviceRef=nom_refservice Demandes d'une référence de service spécifique.
Vous pouvez également utiliser un astérisque (*) comme caractère générique pour spécifier le renvoi de toutes les références de service sous le client de service correspondant.
- Spécifiez les propriétés suivantes avec le paramètre -queryProps pour interroger des applications d'entreprise :
- -expandResource
- Indique si les noms de service uniquement ou des détails sur les ressources doivent être renvoyés. Spécifiez logicalEndpoint ou operation. Si vous spécifiez la valeur logicalEndpoint, la commande renvoie les services correspondants et chaque noeud final des services. Si vous spécifiez la valeur operation, la commande renvoie les services, les noeuds finaux et les opérations correspondants. (Chaîne, facultatif)
- Vous pouvez utiliser le paramètre expandResource pour renvoyer les informations de ressources détaillées des noeuds finals et des opérations sous la référence de service.
Valeur renvoyée
La commande renvoie une liste de propriétés pour chaque service, ainsi que des informations détaillées sur le noeud final ou l'opération si vous recherchez des noeuds finaux ou des opérations.
Syntaxe d'un exemple de mode de traitement par lots
[ [service {http://www.ibm.com}EchoService] [assetType [J2EE Application]]
[client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] ]
[ [assetType [J2EE Application]] [service {http://www.ibm.com}EchoService]
[client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS]
[logicalEndpoint EchoServicePort] ]
[ [service {http://www.ibm.com}PingService] [assetType [J2EE Application]]
[client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] ]
[ [assetType [J2EE Application]] [service {http://www.ibm.com}PingService]
[client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS]
[logicalEndpoint PingServicePort] ]
AdminTask.listServices('[-queryProps [[application MyWSApplication][client false]] -expandResource
logicalEndpoint]')
AdminTask.listServices(['–queryProps', '[[application myApplication][client false]]', '-expandResource',
'logicalEndpoint'])
Les exemples suivants interrogent chaque client de service sous le bus myBus. Les exemples ne renvoient pas de noeud final ou d'opération logique pour chaque client de service car le paramètre -expandResource n'est pas spécifié.
AdminTask.listServices('[–queryProps [[bus myBus][client true]] ]')
AdminTask.listServices(['–queryProps', '[[bus myBus][client true]]'])
Les exemples suivants interrogent les références de service portant le nom testRef pour chaque client de service de l'application JaxWSServicesSamples. Ils renvoient des informations détaillées sur les ressources relatives aux noeuds finaux logiques et aux opérations pour chaque référence de service, parce que le paramètre -expandResource est spécifié.
AdminTask.listServices('[-queryProps [[client true] [application JaxWSServicesSamples] [module SampleClientSei.war]
[serviceRef testRef] -expandResource logicalEndpoint]')
AdminTask.listServices(['-queryProps', '[[application JaxWSServicesSamples][client true][module SampleClientSei.war]
[serviceRef testRef]', '-expandResource', 'logicalEndpoint'])
'[ [serviceRef testRef] [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [client true]
[application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ]
[ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true] [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [logicalEndpoint portA] [application JaxWSServicesSamples] ]
[ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true] [service {http://www.ibm.com/}TestService] [assetType [J2EE Application]] [logicalEndpoint portB] [application JaxWSServicesSamples] ]'
Syntaxe d'un exemple de mode interactif
AdminTask.listServices('-interactive')
listWebServices
La commande listWebServices extrait la liste des services Web disponibles pour l'une ou la totalité des applications. Si aucun nom d'application n'est fourni, la commande répertorie tous les services Web. Cette commande s'applique uniquement aux applications d'entreprise.
Objet cible
Aucun.
Paramètres obligatoires
Aucune.
Paramètres facultatifs
- -application
- Indique le nom de l'application d'entreprise déployée. Si ce paramètre n'est pas spécifié, la commande renvoie tous les services Web dans la cellule. (Chaîne, facultatif)
- -client
- Indique si le service Web est un fournisseur ou un client. La valeur par défaut est false (fournisseur de service). Lorsque la valeur de ce paramètre est true, la commande ne renvoie que des clients de services Web. (Booléen, facultatif)
Valeur renvoyée
Tous les services Web de l'application spécifiée. Pour chaque service Web, cette commande renvoie les attributs suivants et les valeurs correspondantes : le nom de l'application, le nom du module, le nom de service, le type de service. Elle indique aussi si le service Web est un fournisseur ou un client. Le type de service n'est spécifié que si le service Web est un fournisseur de service.
Syntaxe d'un exemple de mode de traitement par lots
AdminTask.listWebServices('[–application application1 -client false]')
AdminTask.listWebServices(['–application', 'application1', '-client', 'false'])
'[[service {http://www.ibm.com}service1][application application1][module webapp1.war][type JAX-WS][client false]]'
Syntaxe d'un exemple de mode interactif
AdminTask.listWebServices('-interactive')
listWebServiceEndpoints
La commande listWebServiceEndpoints renvoie la liste des noeuds finaux logiques pour un service Web. Le nom de noeud final logique correspond au nom de port dans le document WSDL (Web Services Description Language). Cette commande s'applique uniquement aux applications d'entreprise.
Objet cible
Aucun.
Paramètres obligatoires
- -application
- Indique le nom de l'application d'entreprise déployée. (Chaîne, obligatoire)
- -module
- Spécifie le nom du module. (Chaîne, obligatoire)
- -service
- Indique le nom du service Web. (Chaîne, obligatoire)
Paramètres facultatifs
- -client
- Indique si le service Web est un fournisseur ou un client. La valeur par défaut est false (fournisseur de service). Lorsque la valeur de ce paramètre est true, la commande ne renvoie que des clients de services Web. (Booléen, facultatif)
Valeur renvoyée
Cette commande renvoie le nom de point de contact logique pour le service Web spécifié.
Syntaxe d'un exemple de mode de traitement par lots
AdminTask.listWebServiceEndpoints('[–application nom_application -module nom_module
-service nom_service Web -client false]')
AdminTask.listWebServiceEndpoints(['–application', 'nom_application', '-module', 'nom_module',
'-service', 'nom_service Web', '-client', 'false'])
'[[logicalEndpoint QuotePort01]]'
Syntaxe d'un exemple de mode interactif
AdminTask.listWebServiceEndpoints('-interactive')
listWebServiceOperations
La commande listWebServiceOperations renvoie la liste des opérations de service Web. Cette commande s'applique uniquement aux applications d'entreprise.
Objet cible
Aucun.
Paramètres obligatoires
- -application
- Indique le nom de l'application d'entreprise déployée. (Chaîne, obligatoire)
- -module
- Spécifie le nom du module. (Chaîne, obligatoire)
- -service
- Indique le nom du service Web. (Chaîne, obligatoire)
- -logicalEndpoint
- Nom de port dans le document WSDL (Web Services Description Language). (Chaîne, obligatoire)
Paramètres facultatifs
- -client
- Indique si le service Web est un fournisseur ou un client. La valeur par défaut est false (fournisseur de service). Lorsque la valeur de ce paramètre est true, la commande ne renvoie que des clients de services Web. (Booléen, facultatif)
Valeur renvoyée
La commande renvoie le nom de l'opération du service Web spécifié.
Syntaxe d'un exemple de mode de traitement par lots
AdminTask.listWebServiceOperations('[–application nom_application -module
nom_module -service nom_service Web -client false
-logicalEndpoint nom_noeud_final]')
AdminTask.listWebServiceOperations(['–application', 'nom_application', '-module',
'nom_module', '-service', 'nom_service_web', '-client',
'false', '-logicalEndpoint', 'nom_noeud_final'])
'[[operation ivt_app_op1][operation ivt_app_op2]]'
Syntaxe d'un exemple de mode interactif
AdminTask.listWebServiceOperations('-interactive')