Configuración de correlaciones de puerto del cliente preferido de servicios web mediante scripts wsadmin

Se puede configurar un tipo de puerto de cliente con puertos que tienen distintas calidades de servicio. Para especificar qué puerto desea utilizar, utilice la opción de línea de mandatos WebServicesClientBindPreferredPort.

Antes de empezar

Si todavía no ha desplegado el archivo EAR (Enterprise Archive), es necesario tenerlo preparado o ya desplegado en el servidor de aplicaciones.

Acerca de esta tarea

Para cada tipo de puerto que se configura, hay disponibles uno o más puertos que implementan dicho tipo de puerto. Cuando un cliente de servicio web llama al método getPort, la correlación del puerto preferente determina el puerto que se va a utilizar. Esta determinación se produce cuando más de un puerto puede satisfacer la llamada al método getPort, como por ejemplo, una llamada getPort que especifica el tipo de puerto, pero no el puerto. Por ejemplo, suponga que el cliente de servicios web se ha configurado para utilizar tanto la implementación JMS (Java Message Service) como la implementación HTTP. Durante la instalación o la gestión, puede utilizar el mandato WebServicesClientBindPreferredPort para configurar el puerto preferido de la aplicación para utilizar el transporte que desee.

Para configurar la correlación de puerto preferido con la herramienta wsadmin, realice los siguientes pasos:

Procedimiento

  1. Inicie un mandato de script. Para obtener más información, consulte cómo iniciar el cliente de scripts wsadmin.
  2. Configure correlaciones de puerto preferente de cliente de servicios web.

    Para utilizar el puerto de escucha existente en lugar de utilizar o crear una nueva especificación de activación, determine si la versión JAR de EJB es anterior a la 2.1. El sistema crea y utiliza automáticamente una especificación de activación si especifica la opción -usedefaultbindings para desplegar una aplicación. Si existe una especificación de activación, el sistema ignora el puerto de escucha y, en su lugar, utiliza la especificación de activación. Para desplegar una aplicación con una versión JAR de EJB mayor o igual a 2.1 con los puertos de escucha definidos en lugar de una nueva especificación de activación, establezca la propiedad del sistema com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting en true en el archivo wsadmin.properties del directorio de propiedades del perfil de interés.

    Utilice las opciones de instalación, installInteractive, edición o editInteractive para configurar las correlaciones de puerto preferente de cliente de servicios web, como se muestra en la sintaxis siguiente:

    • En Jython:
      AdminApp.install('app_name', '[-usedefaultbindings -deployejb 
      -WebServicesClientBindPreferredPort {{nombre_módulo nombre_EJB servicio_Web tipo_puerto 
      nombre_puerto]')
    • En Jacl:
      $AdminApp install nombre_aplic {-usedefaultbindings -deployejb 
      -WebServicesClientBindPreferredPort {{nombre_módulo nombre_EJB servicio_Web tipo_puerto 
      nombre_puerto}}
    El ejemplo muestra varios nodos y puntos finales de URL, porque puede editar varios fragmentos de URL donde:
    • nombre_aplic es la nombre de aplicación, por ejemplo, MultiEjbJar.ear
    • nombre_EJB es el nombre del módulo de enterprise bean que no es un módulo web, por ejemplo Exchange
    • nombre_módulo es el nombre del módulo, por ejemplo ejbclientonly.jar
    • servicio_web es el nombre del servicio web, por ejemplo service/StockQuoteService
    • tipo_puerto es la información de tipo de puerto, por ejemplo, {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote
    • nombre_puerto es el nombre de puerto, por ejemplo, {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote

Resultados

Ha configurado las correlaciones de puerto del cliente preferido del servicio web con la herramienta wsadmin.

Ejemplo

El siguiente ejemplo incluye la aplicación, módulo, servicio web, tipo de puerto e información de puerto tal como se escribe en la línea de mandatos:
$AdminApp install MultiEjbJar.ear {-WebServicesClientBindPreferredPort {{ejbclientonly.jar 
Exchange service/StockQuoteService {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote
{http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote}...}}

La información de tipo de puerto que controla la creación de los datos de opciones WebServicesClientBindPreferredPort reside en el archivo WSDL del cliente. Dado que las correlaciones de puerto preferido están limitadas a puertos que implementan la interfaz del tipo de puerto, la validación requiere el tipo de implementación de cada puerto. Debe accederse al archivo WSDL de cliente para determinar el tipo y la información de implementación.

El archivo WSDL del cliente se encuentra en el atributo ServiceRef del descriptor de despliegue de cliente del servicio web. En función de la versión y el tipo de módulo, el descriptor de despliegue de cliente se encuentra en el archivo application-client.xml; el archivo web.xml o el archivo ejb-jar.xml. Si utiliza J2EE 1.3, la información de descriptor de despliegue de cliente se encuentra en el archivo webservices.xml.

Qué hacer a continuación

Ahora puede terminar todas las demás configuraciones, iniciar o reiniciar la aplicación y verificar el comportamiento esperado del servicio web.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_preferredportwsadmin
File name: txml_preferredportwsadmin.html