Consulta de servicios web mediante scripts wsadmin
Puede utilizar el lenguaje de scripts Jython o Jacl para consultar las propiedades de servicios web con la herramienta wsadmin. Utilice los mandatos del grupo WebServicesAdmin para listar todos los servicios web, las referencias de servicio y atributos, buscar atributos de un servicio web específico, determinar el punto final de un servicio web y determinar el nombre de operación de un servicio web.
Antes de empezar
El programa de scripts administrativos de wsadmin da soporte a dos lenguajes de scripts, Jacl y Jython. La sintaxis Jacl está en desuso. Se incluyen ejemplos escritos sólo en el lenguaje de scripts Jython.
Para poder completar el procedimiento de los mandatos del grupo WebServicesAdmin, debe iniciar la herramienta wsadmin.
Acerca de esta tarea
Utilice los mandatos siguientes para consultar los servicios web y los atributos de servicios web. Si recibe un error NoItemFoundException, no se puede encontrar la aplicación, el módulo, el servicio o el punto final especificados. Compruebe que todos los parámetros son correctos.
Opcionalmente puede especificar el parámetro de cliente para cualquier mandato del grupo de mandatos WebServicesAdmin. El parámetro de cliente indica si se deben devolver proveedores de servicio o clientes de servicio. Especifique false para solicitar proveedores de servicio y true para solicitar clientes de servicio.
Procedimiento
- Consulte la configuración de todos los servicios web instalados para una aplicación empresarial específica. Entre el mandato siguiente. No es necesario que especifique el parámetro de aplicación para este mandato.
Este mandato devuelve todos los servicios web instalados. El mandato también devuelve el nombre de aplicación, el nombre de módulo, el nombre de servicio y el tipo de servicio para cada servicio web.AdminTask.listWebServices()
Salida de ejemplo:'[ [service {http://www.ibm.com}service1] [client false] [application application1] [module webapp1.war] [type JAX-WS] ]'
- Consulte la configuración de todos los servicios web instalados para una aplicación empresarial específica. Entre el mandato siguiente y especifique el nombre de la aplicación que desea consultar:
Este mandato devuelve todos los servicios web instalados para el nombre_aplicación que ha especificado. El mandato también devuelve el nombre de aplicación, el nombre de módulo, el nombre de servicio y el tipo de servicio para cada servicio web.AdminTask.listWebServices('[–application application_name -client false]')
Salida de ejemplo:'[ [service {http://www.ibm.com}service1] [client false] [application application1] [module webapp1.war] [type JAX-WS] ]'
- Consulte la configuración del nombre y tipo del servicio web para una aplicación de empresa. Entre el mandato siguiente y especifique el nombre de aplicación, el nombre de módulo y el nombre de servicio web. El parámetro client es opcional.
El mandato devuelve el nombre de servicio web y el tipo de servicio web.AdminTask.getWebService('[–application nombre_aplicación -module nombre_módulo -service nombre_servicio_web -client false]')
Salida de ejemplo:'[ [service {http://www.ibm.com}service1] [client false] [type JAX-WS] ]'
- Consulte la configuración de los puntos finales del servicio web para una aplicación de empresa. El nombre de punto final lógico es el nombre de puerto del documento WSDL (Web Services Description Language. Entre el mandato siguiente y especifique el nombre de aplicación, el nombre de módulo y el nombre de servicio web. El parámetro client es opcional.
Este mandato devuelve el puerto en el que está instalado el servicio web.AdminTask.listWebServiceEndpoints('[–application nombre_aplicación -module nombre_módulo -service nombre_servicio_web -client false]')
Salida de ejemplo:'[logicalEndpoint QuotePort01]'
- Consulte la configuración de los nombres de operación del servicio web para una aplicación de empresa. Entre el mandato siguiente y especifique el nombre de aplicación, el nombre de módulo, el nombre de servicio web y el nombre de punto final. El nombre de punto final lógico es el nombre de puerto del documento WSDL (Web Services Description Language. El parámetro client es opcional.
Este mandato devuelve todas las operaciones de servicio web.AdminTask.listWebServiceOperations('[–application nombre_aplicación -module nombre_módulo -service nombre_servicioweb -logicalEndpoint nombre_puntofinal -client false]')
Salida de ejemplo:'[operation ivt_app_op1] [operation ivt_app_op2]'
- Consulte la configuración para los proveedores de servicio, puntos finales y operaciones de cada activo desplegado.
El mandato listServices proporciona funciones de consulta genéricas. Utilice el siguiente mandato para mostrar información sobre los proveedores de servicios, los puntos finales y las operaciones para las aplicaciones empresariales y los clientes de Web Services Notification (WSN). Los parámetros son opcionales. Si no especifica el parámetro queryProps, el mandato devuelve todos los proveedores de servicio de su configuración. Si no especifica el parámetro expandResources, el mandato no devuelve los puntos finales lógicos ni las operaciones de cada servicio.
En el siguiente ejemplo de mandato se devuelve cada proveedor de servicios y los puntos finales correspondientes para la aplicación miAplicación:AdminTask.listServices('-queryProps "[[CompositionUnit=myApplication][client=false]" -expandResources endpoint']
En el siguiente ejemplo de mandato se devuelve cada proveedor de servicios JAX-WS y los puntos finales correspondientes y operaciones dentro de una célula:
Este mandato devuelve los proveedores de servicio que coinciden con la consulta de búsqueda.AdminTask.listServices('[-queryProps "[[serviceType JAX-WS][client false]]"]')
Salida de ejemplo:'[ [service {http://www.ibm.com}EchoService] [assetType [J2EE Application]] [client false] [application WSSampleServicesSei] [module SampleServicesSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}EchoService12] [assetType [J2EE Application]] [client false] [application WSSampleServicesSei] [module SampleServicesSei.war] [serviceType JAX-WS] ] [service {http://www.ibm.com}PingService] [assetType [J2EE Application]] [client false] [application WSSampleServicesSei] [module SampleServicesSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}PingService12] [assetType [J2EE Application]] [client false] [application WSSampleServicesSei] [module SampleServicesSei.war] [serviceType JAX-WS]]'
Utilice el mandato listServices para obtener más información sobre las referencias de servicio. Puede utilizar la propiedad serviceRef con el parámetro queryProps con el mandato listServices para consultar todas las referencias de servicio o una referencia de servicio específica. Este parámetro sólo es aplicable a los clientes de servicios. Si especifica un asterisco (*) como un carácter comodín como el nombre de la referencia de servicio, se devuelven todas las referencias de servicio para el cliente de servicio coincidente. También puede consultar una referencia de servicio específico especificando el nombre de la referencia de servicio deseada. Para devolver información de referencia de servicio detallada de puntos finales y operaciones, especifique la propiedad expandResource.
En el ejemplo de mandato siguiente se enumeran todos los clientes de servicio y las referencias de servicio en una célula:
Este mandato devuelve las referencias de servicio que coinciden con la consulta de búsqueda.AdminTask.listServices('[-queryProps [[client true] [serviceRef *]]]')
En el siguiente ejemplo de salida, se listan los clientes de servicio EchoService y Echoservice12 y estos clientes no tienen referencias de servicios en la célula. Sin embargo, los clientes de servicio TestService y TestService2 sí que tienen referencias de servicio. Hay un objeto de propiedades para cada referencia de servicio en el cliente de servicio. El nombre de componente sólo está disponible para un módulo EJB.'[ [service {http://www.ibm.com}EchoService] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}EchoService12] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [serviceRef testRef] [assetType [J2EE Application]] [service {http://www.ibm.com}TestService] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}TestService2] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [serviceRef testRef2] [assetType [J2EE Application]] [service {http://www.ibm.com}TestService2] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ]
En el ejemplo de mandato siguiente se muestra una referencia de servicio específica expandiendo puntos finales y operaciones:
Este mandato devuelve las referencias de servicio especificadas para testRef y la propiedad serviceRef se incluye en cada objeto de propiedades; por ejemplo:AdminTask.listServices('[-queryProps [[client true] [application JaxWSServicesSamples] [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] ]'
En el siguiente ejemplo de mandato se devuelve cada cliente de servicio WSN y las operaciones y los puntos finales correspondientes de una célula:
Este mandato devuelve los proveedores de servicio que coinciden con la consulta de búsqueda.AdminTask.listServices('[-queryProps "[[serviceType [JAX-WS (WSN)]][clie nt true]]" -expandResource logicalEndpoint]')
Salida de ejemplo:'[ [service {http://www.ibm.com/websphere/wsn/out/remote-publisher}OutboundRemotePublisherService] [assetType [WSN Service]] [client true] [bus bus1] [WSNService wsn1] [serviceType [JAX-WS (WSN)]] ] [ [assetType [WSN Service]] [service {http://www.ibm.com/websphere/wsn/out/remote-publisher}OutboundRemotePublisherService] [bus bus1] [client true] [WSNService wsn1] [serviceType [JAX-WS (WSN)]] [logicalEndpoint OutboundRemotePublisherPort] ] [ [service {http://www.ibm.com/websphere/wsn/out/notification}OutboundNotificationService] [assetType [WSN Service]] [client true] [bus bus1] [WSNService wsn1] [serviceType [JAX-WS (WSN)]] ] [ [assetType [WSN Service]] [service {http://www.ibm.com/websphere/wsn/out/notification}OutboundNotificationService] [bus bus1] [client true] [WSNService wsn1] [serviceType [JAX-WS (WSN)]] [logicalEndpoint OutboundNotificationPort] ]'
Subtopics
Grupo de mandatos WebServicesAdmin para el objeto AdminTask
Puede utilizar los lenguajes de script Jython o Jacl para configurar la seguridad con la herramienta wsadmin. Utilice los mandatos del grupo WebServicesAdmin para listar todos los servicios web, las referencias de servicio y atributos, buscar atributos de un servicio web específico, determinar el punto final de un servicio web y determinar el nombre de operación de un servicio web.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_wsfpmanagews
File name: txml_wsfpmanagews.html