Información del puerto del cliente de servicios web

Utilice esta página para especificar un tiempo de espera de solicitud, sobrescribir un punto final y un espacio de nombres de enlace para un puerto del cliente de servicios web.

Un servicio web puede tener varios puertos. Puede ver y configurar los atributos de puerto para cada puerto de servicio web definido. Los servicios web se listan en la página Enlaces de cliente de servicios web.

Para ver esta página de la consola de administración, realice los pasos siguientes:
  1. Pulse Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere > nombre_recurso .
  2. Pulse Gestionar módulos > nombre_módulo > Enlaces del cliente de servicios web.
  3. Pulse Editar en Información de puerto.

Esta página de la consola de administración se aplica a la API de Java para servicios web basados en XML (JAX-WS) y a la API de Java para servicios web RPC (JAX-RPC) basados en XML. El campo URL de punto final sobrescrito es el único campo compatible con clientes JAX-WS. Los demás campos no son aplicables a clientes JAX-WS.

Puerto

Especifica el nombre de un puerto.

Tiempo de espera de petición

Especifica el intervalo de tiempo en segundos que el enlace de servicio web espera para que una solicitud se complete en este puerto. Si no se especifica ningún tiempo de espera, el tiempo de espera de solicitud predeterminado que debe esperar el cliente es de 300 segundos. Si el valor está establecido en 0 (cero), el tiempo de espera utilizado es el valor predeterminado para el mecanismo de transporte subyacente. Este campo sólo tiene soporte en clientes JAX-RPC.

Un uso típico de este valor es personalizar el comportamiento del cliente cuando se configura para que utilice un transporte JMS con el fin de acceder a un servicio web de modo que espere más tiempo para una conclusión prevista. Según las condiciones de red o la naturaleza de una implementación de servicio web, es posible que tenga que ajustar el tiempo de espera.

URL de punto final sobrescrito

Especifica el nombre de un punto final que se utiliza para sobrescribir el punto final actual. Un cliente que invoque una solicitud en este puerto utiliza este punto final en lugar del punto final especificado en el archivo WSDL. Este campo tiene soporte para clientes JAX-WS y JAX-RPC.

[Updated in March 2013]Cuando se invocan clientes JAX-RPC o JAX-WS, se envían solicitudes al URL especificado en la dirección SOAP del puerto contenida en el archivo WSDL (Web Services Description Language). Ambos modelos de programación también ofrecen a los clientes la posibilidad de establecer mediante programación el URL de la dirección de punto final. Para JAX-RPC, el cliente utiliza la propiedad javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY para establecer el URL de dirección de punto final; para JAX-WS, el cliente utiliza la propiedad javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY.[Updated in March 2013]

Si una aplicación ensamblada contiene un cliente de servicio web que está enlazado estáticamente, el cliente está forzado a utilizar la implementación (punto final de servicio) identificada en el archivo WSDL utilizado durante el desarrollo. Sobrescribir el punto final es una alternativa a configurar el atributo WSDL desplegado.

El URI de punto final sobrescrito se especifica para cada puerto. No necesita un archivo WSDL alternativo dentro del módulo. El URI de punto final sobrescrito tiene preferencia sobre el atributo WSDL desplegado. El cliente utiliza este valor para la dirección SOAP o el URI de punto final de servicio, en lugar del valor de los enlaces del cliente estáticos.

Evite problemas Evite problemas:
  • [Updated in March 2013]Normalmente, este campo no afecta a los clientes JAX-WS no gestionados porque el usuario no puede editar este campo si sólo tiene clientes no gestionados. Pero si sólo tiene clientes gestionados o una combinación de clientes gestionados y no gestionados, el usuario puede editar este campo y los clientes no gestionados pueden verse afectados por el valor de la propiedad. Si no desea que una solicitud realizada por un servicio de cliente JAX-WS no gestionado se envíe al URL de punto final que se especifica en este campo, añada la propiedad personalizada siguiente a los valores de máquina virtual Java:
    com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri
    El añadir esta propiedad personalizada a los valores de máquina virtual Java para un servidor de aplicaciones y establecer su valor en true impide que los servicios de cliente JAX-WS no gestionados accedan al URL de punto final que sobrescribe el punto final en el archivo WSDL.[Updated in March 2013]
  • Los valores de URL de punto final sobrescritos no persisten cuando se sustituye un módulo o aplicación en una operación de actualización.
gotcha

Espacio de nombres de enlace sobrescrito

Especifica el URI de espacio de nombres de enlace del archivo WSDL para su uso con este puerto, en lugar de del espacio de nombres del archivo WSDL. No es necesario que este enlace exista en el archivo WSDL. Un cliente que invoque una solicitud en este puerto utiliza este enlace en lugar del enlace especificado en el archivo WSDL. Un espacio de nombres de enlace sobrescrito no puede especificarse a menos que se especifique un punto final sobrescrito.Este campo sólo tiene soporte en clientes JAX-RPC.



Nombre de archivo: uwbs_portattribute.html