Der Spezifikation J2EE 1.4 wurde durch die neue JAX-RPC 1.0-API Unterstützung für Web-Services hinzugefügt.
Gemäß der Definition von JSR-109 V1.0 umfassen Implementierungsdeskriptoren für Web-Services die Dateien webservices.xml, webservicesclient.xml und alle Implementierungsdeskriptoren für JAX-RPC-Zuordnung, auf die in den Dateien webservices.xml und webservicesclient.xml verwiesen wird. Wie bei anderen J2EE-Implementierungsdeskriptoren verändert die Migration die Struktur der in den Deskriptoren enthaltenen Informationen, sodass diese diese mit der Spezifikation J2EE 1.4 konform sind. Eine strukturelle Änderung, die für Implementierungsdeskriptoren für Web-Services kennzeichnend ist, ist die geänderte Darstellung der qualifizierten Namen. In JSR-109 V1.0 werden qualifizierte Namen mithilfe einer aus zwei Elementen bestehenden Sequenz dargestellt, <namespaceURI> und <localpart>, die die namespace-URI bzw. den lokalen Teil des Namens enthalten. Qualifizierte Namen basieren in J2EE 1.4 auf dem XMLSchema QName-Typ, der XML-Namespaces verwendet.
Der Implementierungsdeskriptor webservices.xml ist in Webprojekten und EJB-Projekten, die J2EE-Web-Services enthalten, vorhanden. Sowohl das Element <wsdl-port> als auch das Element <soap-header> enthalten qualifizierte Namen und ihr Inhalt wird auf das J2EE 1.4-Format migriert.
Der Implementierungsdeskriptor webservices.xml ist in Webprojekten vorhanden, die J2EE-Web-Services enthalten. Sowohl das Element <wsdl-port> als auch das Element <soap-header> enthalten qualifizierte Namen und ihr Inhalt wird auf das J2EE 1.4-Format migriert.
Wenn z. B. <wsdl-port> vor der Migration wie folgt dargestellt wird,
<wsdl-port> <namespaceURI>http://addressbook.webservice</namespaceURI> <localpart>AddressBook</localpart> </wsdl-port>
wird <wsdl-port> nach der Migration wie folgt dargestellt:
<wsdl-port xmlns:pfx="http://addressbook.webservice">pfx:AddressBook</wsdl-port>
Das Präfix "pfx" wird als Namespace-Präfix für alle migrierten qualifizierten Namen verwendet.
Sowohl das Element <service-qname> als auch das Element <soap-header> enthalten qualifizierte Namen, und ihr Inhalt wird auf das J2EE 1.4-Format migriert. Wenn z. B. <service-qname> vor der Migration wie folgt dargestellt wird,
<service-qname> <namespaceURI>http://addressbook.webservice</namespaceURI> <localpart>AddressBookService</localpart> </service-qname>
wird <service-qname> nach der Migration wie folgt dargestellt:
<service-qname xmlns:pfx="http://addressbook.webservice">pfx:AddressBookService</service-qname>
Das Präfix "pfx" wird als Namespace-Präfix für alle migrierten qualifizierten Namen verwendet.
Die Implementierungsdeskriptoren webservices.xml und webservicesclient.xml können beide auf einen oder mehrere Implementierungsdeskriptoren für JAX-RPC-Zuordnung verweisen.
In der Datei webservices.xml sind diese Verweise im Element <jaxrpc-mapping-file> unter dem jeweiligen Element <webservice-description> enthalten. In der Datei webservicesclient.xml sind diese Verweise im Element <jaxrpc-mapping-file> unter dem jeweiligen Element <service-ref> enthalten.
Während der Migration von J2EE 1.3 auf 1.4 werden alle Implementierungsdeskriptoren für die JAX-RPC-Zuordnung, auf die in webservices.xml und webservicesclient.xml verwiesen wird, migriert. Die Migration umfasst das Migrieren aller qualifizierten Namen auf das J2EE 1.4-Format (siehe die vorstehenden Abschnitte über webservices.xml und webservicesclient.xml für Beispiele für qualifizierte Namen nach der Migration).
Übergeordnetes Thema: Migration der J2EE-Spezifikationsstufe 1.3 auf 1.4
Zugehörige Tasks
Migration sicherer Web-Services
Zugehörige Verweise
Webprojekte (Servletstufe 2.3 auf Servletstufe 2.4)
Connectorprojekte (JCA 1.0 auf JCA 1.5)
Migration der J2EE-Spezifikationsstufe 1.3 auf 1.4