Propiedades de ensamblaje de ibm-webservicesclient-bnd.xmi para aplicaciones JAX
El archivo de descriptor de despliegue ibm-webservicesclient-bnd.xmi contiene información del tiempo de ejecución de los servicios web que es específica del producto WebSphere. Este archivo de descriptor de despliegue se utiliza con la API de Java™ para servicios web basados en XML.
Los descriptores de despliegue pueden configurarse con herramientas de ensamblaje que se suministran con WebSphere Application Server. Consulta la información acerca de la configuración de los enlaces de cliente de servicios web JAX-RPC del descriptor de despliegue ibm-webservicesclient-bnd.xmi para obtener más información sobre la configuración de este descriptor de despliegue.
Propiedades de ensamblaje
La siguiente lista es una colección de propiedades y atributos soportados que puede definir para las aplicaciones.
- componentNameLink
- Un atributo del elemento componentScopedRefs. Cuando una implementación de Enterprise JavaBeans (EJB) implementa un servicio web, cada elemento <componentScopedRefs> contiene propiedades de ensamblaje para un enterprise bean concreto. El atributo componentNameLink del elemento <componentScopedRefs> identifica el enterprise bean al que se aplican las propiedades de ensamblaje especificando el <ejb-name>. Esta propiedad sólo se utiliza cuando el cliente del servicio web es un enterprise bean.
- serviceRefLink
- Un atributo del elemento serviceRefs. Especifica el enlace a <service-ref-name> en el elemento <service-ref> del descriptor de despliegue del cliente. El descriptor de despliegue del cliente es ejb-jar.xml, web.xml o application-client.xml.
- deployedWSDLFile
- Un atributo del elemento serviceRefs; es opcional. Permite que un archivo WDSL (Web Services Description Language) alternativo utilice otra cosa que la especificada en el elemento <wsdl-file> del elemento <service-ref> del descriptor de despliegue del cliente. Si se especifica un atributo, debe empaquetarse el archivo WSDL alternativo en el mismo módulo y además debe ser compatible con el archivo WSDL de desarrollo. La propiedad deployedWSDLFile proporciona un nuevo archivo WSDL que contiene una dirección web de punto final distinta a la del archivo WSDL original.
- defaultMappings
- Un elemento que identifica el puerto que debe utilizarse para un tipo de puerto dado cuando el cliente no selecciona ninguno. Este elemento tiene los atributos siguientes: portTypeNamespace, portTypeLocalName, portNamespace, portLocalName. Estos atributos identifican qué puerto wsdl:port se utiliza para wsdl:portType.
- syncTimeout
- Un atributo del elemento portQnameBindings. Especifica cuánto tiempo, en segundos, se debe esperar a la respuesta de una llamada síncrona. El valor predeterminado es 300 segundos.
- basicAuth
- Elemento del elemento portQnameBindings. Autentica un cliente de servicio para el punto final del servicio, independientemente del transporte subyacente que incluye HTTP, HTTPS y JMS (Java Message Service). Establezca los atributos de ID de usuario y contraseña como sea necesario.
- sslConfig
- Elemento del elemento portQnameBindings. Especifica la configuración SSL (Secure Sockets Layer) de una solicitud de salida HTTPS. El atributo name es el nombre de una entrada de configuración SSL o un alias definido en el repertorio de configuración SSL. Este atributo sólo se utiliza cuando el cliente se ejecuta en WebSphere Application Server.
En WebSphere Application Server para z/OS, es necesario la gestión de archivos de claves y certificados digitales. Para obtener más información, consulte el tema acerca de la creación de certificados digitales SSL (Secure Sockets Layer) y la información sobre los archivos de claves del recurso de autorización del sistema que las aplicaciones pueden utilizar para iniciar solicitudes HTTPS.
- overriddenEndpointURI
- Una propiedad que especifica el URL final al que se enviarán las solicitudes. Cuando el cliente se ejecuta para invocar el servicio web, la solicitud se envía al URL de esta propiedad, que tiene prioridad sobre la dirección dada en el archivo WSDL y el código de cliente. Esta propiedad es la única propiedad en el archivo ibm-webservicesclient-bnd.xmi que es aplicable a los servicios JAX-WS.
Ejemplo de archivo de enlaces
En el ejemplo siguiente se demuestra la ortografía y la posición de los distintos atributos. No puede realizar las operaciones de cortar y pegar con estos ejemplos porque no contienen los atributos ID (identificación) necesarios. Si añade elementos a una plantilla de archivo de enlaces temporal generada con el mandato WSDL2Java, deberá confirmar que cada elemento tiene un atributo ID (identificación) cuyos valores son una serie única. Revise los archivos xmi de plantilla generados mediante el mandato WSDL2Java para obtener ejemplos de series de ID (identificación). Consulte la información acerca de la herramienta de línea de mandatos WSDL2Java para las aplicaciones JAX-RPC (Java API for XML-based RPC) para obtener más información acerca de esta herramienta.
<com.ibm.etools.webservice.wscbnd:ClientBinding xmi:version="2.0"
xmlns:xmi="http://www.omg.org/XMI" xmlns:com.ibm.etools.webservice.wscbnd=
"http://www.ibm.com/websphere/appserver/schemas/5.0.2/wscbnd.xmi">
<componentScopedRefs componentNameLink="myComponent ref"/>
<serviceRefs serviceRefLink="myService ref" deployedWSDLFile="META-INF/wsdl/alternate.wsdl">
<defaultMappings portTypeLocalName="AddressBook" portTypeNamespace="http://www.com.ibm"
portLocalName="AddressBookPort" portNamespace="http://www.com.ibm"/>
<portQnameBindings portQnameNamespaceLink="http://www.com.ibm"
portQnameLocalNameLink="AddressBookPort" syncTimeout="99">
<basicAuth userid="myId" password="myPassword"/>
<sslConfig name="mynode/.DefaultSSLSettings"/>
</portQnameBindings>
</serviceRefs>
</com.ibm.etools.webservice.wscbnd:ClientBinding>