Proriedades do Conjunto ibm-webservicesclient-bnd.xmi para Aplicativos de JAX
O arquivo descritor de implementação ibm-webservicesclient-bnd.xmi contém informações para o tempo de execução de serviços da web que é específico do produto WebSphere. Este arquivo descritor de implementação é usado com serviços d a web baseados em Java™ API for XML.
É possível configurar descritores de implementação com as ferramentas de montagem fornecidas com o WebSphere Application Server. Consulte a configuração das ligações de cliente de serviços da Web JAX-RPC no descritor de implementação ibm-webservicesclient-bnd.xmi para aprender mais sobre a configuração desse descritor de implementação.
Propriedades do Conjunto
A lista a seguir é uma coleção de propriedades e atributos suportados que podem ser definidos para seu aplicativo.
- componentNameLink
- Um atributo do elemento componentScopedRefs. Quando um serviço da Web é implementado por uma implementação Enterprise JavaBeans (EJB), cada elemento <componentScopedRefs> contém propriedades de montagem para um enterprise bean individual. O atributo componentNameLink do elemento <componentScopedRefs> identifica o enterprise bean ao qual as propriedades de montagem se aplicam por meio da especificação de <ejb-name>. Essa propriedade é usada apenas quando o cliente de serviços da Web for um enterprise bean.
- serviceRefLink
- Um atributo do elemento serviceRefs. Especifica o link para o <ref-service-name> no elemento <service-ref> no Client Deployment Descriptor. O Client Deployment Descriptor é ejb-jar.xml, web.xml ou application-client.xml.
- deployedWSDLFile
- Um atributo do elemento serviceRefs é opcional. Permite que um arquivo WSDL (Web Services Description Language) alternativo seja utilizado, diferente daquele especificado no elemento <wsdl-file> do elemento <service-ref> no Client Deployment Descriptor. Se um atributo for especificado, o arquivo WSDL alternativo deverá estar empacotado no mesmo módulo e deverá ser compatível com o arquivo WSDL de desenvolvimento. A propriedade deployedWSDLFile fornece um novo arquivo WSDL contendo endereço da Web de terminal diferente do arquivo WSDL original.
- defaultMappings
- Um elemento que identifica qual porta usar para um dado portType quando um não estiver selecionado pelo cliente. Esse elemento possui os seguintes atributos: portTypeNamespace, portTypeLocalName, portNamespace, portLocalName. Esses atributos identificam qual wsdl:port é utilizado para um wsdl:portType.
- syncTimeout
- Um atributo do elemento portQnameBindings. Especifica quanto tempo, em segundos, aguardar por uma resposta de uma chamada síncrona. O padrão é 300 segundos.
- basicAuth
- Um elemento do elemento portQnameBindings. Autentica um cliente de serviço para o terminal em serviço, independentemente do transporte subjacente que inclui, HTTP, HTTPS e JMS (Java Message Service). Defina os atributos de ID do usuário e senha, conforme necessário.
- sslConfig
- Um elemento do elemento portQnameBindings. Especifica a configuração de SSL (Secure Sockets Layer) de um pedido de saída
HTTPS. O atributo name é o nome de uma entrada ou alias de configuração SSL
que é definido no repertório de configuração SSL. Este atributo é utilizado só quando o cliente está em execução no WebSphere Application Server.
Para WebSphere Application Server para z/OS, é necessário algum certificado digital e gerenciamento de keyring. Para saber mais, consulte Criando certificados digitais do Secure Sockets Layer e Conjuntos de Chaves do System Authorization Facility que os aplicativos podem usar para iniciar os pedidos HTTPS
- overriddenEndpointURI
- Uma propriedade que especifica a URLfinal para a qual solicitações serão enviadas. Quando o cliente está executando para chamar o serviço da web, a solicitação é enviada para a URL desta propriedade, que toma precedência sobre o endereço fornecido no arquivo WSDL e no código do cliente. Esta propriedade é a única no arquivo ibm-webservicesclient-bnd.xmi que é aplicável para serviços do JAX-WS.
Um Exemplo de Arquivo de Ligações
O exemplo a seguir demonstra a ortografia e a posição de vários atributos. Não é possível recortar e colar esses exemplos, porque eles não contêm os atributos de ID requeridos. Se você adicionar elementos a um modelo de arquivo de ligação gerado pelo comando WSDL2Java, você deve confirmar que cada elemento tenha um atributo ID cujo valor seja uma cadeia exclusiva. Reveja os arquivos xmi de modelo gerados pelo comando WSDL2Java para obter exemplos de cadeias de ID. Leia sobre a ferramenta de linha de comandos WSDL2Java para aplicativos JAX-RPC (Java API for XML-based Remote Procedure Call) para saber mais sobre esta ferramenta.
<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>