A especificação J2EE 1.4 incluiu suporte para serviços da Web através da nova API JAX-RPC 1.0.
Os descritores de implementação de serviço da Web, conforme definidos pelo JSR-109 V1.0, consistem nos arquivos webservices.xml, webservicesclient.xml e todos os descritores de implementação de mapeamento JAX-RPC que são referidos pelo webservices.xml e pelo webservicesclient.xml. Como com outros descritores de implementação J2EE, a migração modificará a estrutura de informações contida nos descritores para conformidade com a especificação J2EE 1.4. Uma alteração estrutural que é específica dos descritores de implementação de serviço da Web é a alteração na maneira como os nomes completos são representados. No JSR-109 V1.0, os nomes qualificados são representados utilizando uma seqüência de dois elementos <namespaceURI> e <localpart>, que contêm o URI do espaço de nomes e a parte local do nome respectivamente. Os nomes completos do J2EE 1.4 são baseados no tipo XMLSchema QName, que utiliza espaços de nomes XML.
O descritor de implementação webservices.xml está presente em projetos da Web e projetos EJB que contêm serviços J2EE da Web.O elemento <wsdl-port> e o elemento <soap-header> contêm nomes qualificados e seus conteúdos serão migrados para o formato J2EE 1.4.
O descritor de implementação webservices.xml está presente em projetos da Web que contêm serviços J2EE da Web. O elemento <wsdl-port> e o elemento <soap-header> contêm nomes qualificados e seus conteúdos serão migrados para o formato J2EE 1.4.
Por exemplo, se <wsdl-port> for representado da seguinte maneira antes da migração,
<wsdl-port> <namespaceURI>http://addressbook.webservice</namespaceURI> <localpart>AddressBook</localpart> </wsdl-port>
após a migração <wsdl-port> será representado como:
<wsdl-port xmlns:pfx="http://addressbook.webservice">pfx:AddressBook</wsdl-port>
O prefixo "pfx" é utilizado como o prefixo do espaço de nomes para todos os nomes completos migrados.
O elemento <service-qname> e o elemento <soap-header> contêm nomes qualificados e seus conteúdos serão migrados para o formato J2EE 1.4. Por exemplo, se <service-qname> for representado da seguinte maneira antes da migração,
<service-qname> <namespaceURI>http://addressbook.webservice</namespaceURI> <localpart>AddressBookService</localpart> </service-qname>
após a migração <service-qname> será representado como:
<service-qname xmlns:pfx="http://addressbook.webservice">pfx:AddressBookService</service-qname>
O prefixo "pfx" é utilizado como o prefixo do espaço de nomes para todos os nomes completos migrados.
Os descritores de implementação webservices.xml e webservicesclient.xml podem fazer referência a um ou mais descritores de implementação de mapeamento JAX-RPC.
No arquivo webservices.xml, essas referências estão contidas no elemento <jaxrpc-mapping-file> sob cada elemento <webservice-description>. No arquivo webservicesclient.xml, essas referências estão contidas no elemento <jaxrpc-mapping-file> sob cada elemento <service-ref>.
Durante a migração de J2EE 1.3 para 1.4, todos os descritores de implementação de mapeamento JAX-RPC referenciados em webservices.xml e em webservicesclient.xml são migrados.A migração inclui a migração de todos os nomes qualificados para o formato J2EE 1.4 (consulte a seção acima em webservices.xml e em webservicesclient.xml para obter exemplos de nomes qualificados migrados).
Tópico pai: Migração do Nível de Especificação J2EE 1.3 para 1.4
Tarefas relacionadas
Migrando Serviços da Web Protegidos
Referências relacionadas
Projetos da Web (Nível de Servlet 2.3 para Nível de Servlet 2.4)
Projetos do Conector (JCA 1.0 para JCA 1.5)
Migração do Nível de Especificação J2EE 1.3 para 1.4