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
Resultados
Ejemplo
$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.