A JAX-RPC migrálása JAX-WS-re

Ez a szabály jelzi a JAX-RPC-specifikus csomagok és konfigurációk használatát:

Csomagok	Konfigurációs fájlok
javax.xml.rpc javax.xml.rpc.encoding javax.xml.rpc.handler javax.xml.rpc.handler.soap javax.xml.rpc.holders javax.xml.rpc.server javax.xml.rpc.soap	webservices.xml web.xml ejb-jar.xml application.xml

A Java API for XML-based RPC (JAX-RPC) nem támogatott Liberty vagy Liberty Core kiszolgálón. A technológia elavult a hagyományos WebSphere Application Server V9.0 változatban és eltávolításra kerülhet egy későbbi változatban. Az átállítás stratégiai módja a JAX-WS használata. A relatív erőfeszítés mértéke a választott átállítási mód alapján változik:

• 1. lehetőség: A JAX-RPC webszolgáltatások JAX-WS webszolgáltatásokba történő migrálása a JAX-RPC forrás migrációs segédprogram
• 2. lehetőség: A JAX-RPC webszolgáltatások JAX-WS webszolgáltatásokba történő migrálása a JAX-RPC konverziós eszközzel
• 3. lehetőség: JAX-RPC webszolgáltatások JAX-WS webszolgáltatásokba történő migrálása manuálisan
• 4. lehetőség: Használja a Apache Axis 1 JAX-RPC motorját a következő oldalakon Liberty
• 5. lehetőség: A WebSphere Application Server hagyományos használata a natív JAX-RPC-vel együtt motorját

A következő táblázat az öt lehetőséget hasonlítja össze az Ön projektjét befolyásoló tényezők alapján.

Projekt tényezők	1. lehetőség JAX-RPC webszolgáltatások migrálása JAX-WS webszolgáltatásokba a JAX-RPC Source Migration Helper segítségével	2. lehetőség JAX-RPC webszolgáltatások átállítása JAX-WS webszolgáltatásokra a JAX-RPC átalakító eszköz használatával	3. lehetőség JAX-RPC webszolgáltatások manuális átállítása JAX-WS webszolgáltatásokra	4. lehetőség Az Apache Axis 1 JAX-RPC alrendszer használata Liberty kiszolgálón	5. lehetőség Hagyományos WebSphere Application Server használata annak natív JAX-RPC alrendszerével
Támogatott megoldás	Igen A JAX-WS a Liberty Core kivételével minden Liberty kiadásban támogatott konfigurálható szolgáltatásként.	Igen A JAX-WS a Liberty Core kivételével minden Liberty kiadásban támogatott konfigurálható szolgáltatásként. Töltse le a WebSphere Liberty JAX-RPC átalakító eszközt Maven és Gradle szoftverekhez.	Igen A JAX-WS a Liberty Core kivételével minden Liberty kiadásban támogatott konfigurálható szolgáltatásként.	Nem Az Axis 1 nem támogatott.	Igen A JAX-RPC támogatott hagyományos WebSphere Application Server kiszolgálón.
Stratégiai megoldás	Igen A JAX-WS a Liberty Core kivételével minden Liberty kiadáshoz stratégiai fontosságú.	Igen A JAX-WS a Liberty Core kivételével minden Liberty kiadáshoz stratégiai fontosságú.	Igen A JAX-WS a Liberty Core kivételével minden Liberty kiadáshoz stratégiai fontosságú.	Nem Az Axis 1 már nincs fejlesztve.	Nem A JAX-RPC elavult hagyományos WebSphere Application Server kiszolgálókon, és egy későbbi változatban eltávolításra kerülhet.
A megvalósítás összetettsége	Közepes Az alkalmazást a JAX-RPC Source Migration Helper használatára validálták. A JAX-RPC szolgáltatások lehetnek jAX-WS webszolgáltatásokká alakíthatók át ezzel az eszközzel az alkalmazás forráskódjában.	Alacsony Az alkalmazás a JAX-RPC átalakító eszköz általi használatra került érvényesítésre. A JAX-RPC szolgáltatások átalakíthatók jAX-WS webszolgáltatásokká alakíthatók a bináris archívumban ezzel az eszközzel.	Magas Ez a lehetőség bonyolult lehet nagy számú JAX-RPC ügyfél és világhálós szolgáltatás esetén. A JAX-RPC szolgáltatások átállításához JAX-WS szolgáltatásokra a JAX-RPC átalakító eszköz használata nélkül a kódbázis jelentős módosításra van szükség.	Alacsony Ha az alkalmazás már az Axis 1 változatot használja, akkor ez a lehetőség nem bonyolult. Máskülönben ez a lehetőség közepesen bonyolult.	Közepes A JAX-RPC világhálós szolgáltatások költöztetése egy eltérő alrendszerre megőrzi a kódalap nagy részét.
Speciális szolgáltatások	Igen A JAX-WS számos speciális szolgáltatást ad, például annotációk, JAXB kötés és SOAP 1.2.	Igen A JAX-WS számos speciális szolgáltatást ad, például annotációk, JAXB kötés és SOAP 1.2.	Igen A JAX-WS számos speciális szolgáltatást ad, például annotációk, JAXB kötés és SOAP 1.2.	Nem A JAX-RPC nem tartalmaz számos olyan speciális szolgáltatást, amelyek megtalálhatók a JAX-WS megvalósításban.	Nem A JAX-RPC nem tartalmaz számos olyan speciális szolgáltatást, amelyek megtalálhatók a JAX-WS megvalósításban.
Megfelelés a specifikációnak	Igen	Igen	Igen	Igen Habár a JAX-RPC még része a Java EE előírásnak, a Java EE 6 változatban elavult.	Igen Habár a JAX-RPC még része a Java EE előírásnak, a Java EE 6 változatban elavult.
Javaslat	Használja ezt a lehetőséget, ha jogosult a IBM Application Modernization Accelerator Developer Tools. Ez az egyetlen olyan lehetőség, amely automatikus segítséget nyújt az alkalmazások forráskódjának JAX-WS-re történő áttelepítéséhez.	Akkor használja ezt a lehetőséget, ha az alkalmazás megfelel a JAX-RPC átalakító eszköz követelményeinek. Ez az eszköz csak bináris archívumokat konvertál.	Akkor használja ezt a lehetőséget, ha rendelkezik néhány JAX-RPC webszolgáltatással, és az alkalmazás nem felel meg a JAX-RPC átalakító eszköz követelményeinek.	Használja ezt a lehetőséget, ha a JAX-RPC világhálós szolgáltatásai már Axis 1 változaton futnak.	Használja ezt a lehetőséget, ha a JAX-RPC világhálós szolgáltatásai már hagyományos WebSphere Application Server kiszolgálón futnak, vagy ha sok JAX-RPC szolgáltatással rendelkezik, amelyek nem Axis 1 változaton futnak.

JAX-RPC webszolgáltatások migrálása JAX-WS webszolgáltatásokba a JAX-RPC Source Migration Helper segítségével

A JAX-RPC Source Migration Helper a IBM Application Modernization Accelerator Developer Tools oldalon érhető el. Ez az eszköz segítséget nyújt a régebbi JAX-RPC szolgáltatások JAX-WS-be történő átalakításában az alkalmazás forráskódjában. További információért lásd Application Modernization Accelerator Developer Tools áttekintés.

JAX-RPC webszolgáltatások átállítása JAX-WS webszolgáltatásokra a JAX-RPC átalakító eszköz használatával

Töltse le a JAX-RPC konverziós eszközt a következő webhelyről WebSphere Liberty JAX-RPC Conversion Tool for Maven és Gradle a bináris archívum migrálásához.

Információkért az alkalmazások átállításával kapcsolatban JAX-RPC szolgáltatásról JAX-WS szolgáltatásra a JAX-RPC átalakító eszköz segítségével, tekintse meg a JAX-RPC alkalmazások átállítása Liberty rendszerre Maven használatával vagy a JAX-RPC alkalmazások átállítása Liberty rendszerre Gradle használatával című részt az online dokumentációban.

JAX-RPC webszolgáltatások manuális átállítása JAX-WS webszolgáltatásokra

Az alkalmazások JAX-RPC szolgáltatásról JAX-WS szolgáltatásra történő átállításával kapcsolatos információkért tekintse meg a következőt: Webszolgáltatás átállítási példahelyzetek: JAX-RPC szolgáltatásról JAX-WS és JAXB szolgáltatásra rész az online dokumentációban.

A JAX-RPC és a JAX-WS közötti különbségekkel kapcsolatos további információkért lásd: JAX-WS alkalmazástelepítési modell.

Az Apache Axis 1 JAX-RPC alrendszer használata Liberty kiszolgálón

Ha már Axis 1 alrendszert használ, akkor ha azt Liberty kiszolgálón kívánja használni, bele kell foglalnia az Axis 1 függvénytárakat a Liberty osztályútvonalba.

Ha beágyazott JAX-RPC szolgáltatást használ, akkor webszolgáltatásait átalakíthatja az Axis 1 használatára. A következő eljárás azt ismerteti, hogy hogyan állíthat át webszolgáltatást Red Hat JBoss platformról Axis 1-re.

1. Töltse le az Axis 1.0 könyvtárakat az Apache webhelyéről.
   Megjegyzés: Az Axis 2.0 a JAX-WS szolgáltatást használja, és nem támogatja a JAX-RPC világhálós szolgáltatásokat.
2. Foglalja bele az Axis függvénytárakat az osztályútvonalba. A függvénytárakat a kiszolgáló osztályútvonalába vagy az alkalmazás WEB-INF/lib könyvtárába foglalhatja bele.
3. Távolítsa el a világhálós szolgáltatásra mutató hivatkozást a web.xml fájlból.
4. Adja hozzá az Axis adminisztrációs szervleteket a web.xml fájlhoz. A web.xml fájl példái: Speciális telepítés: Axis hozzáadása saját webapphoz az Apache weboldalán.
5. Állítsa elő újra a világhálós szolgáltatásokat a WSDL fájlból a következő parancs használatával:

      java -cp <AXIS LIBRARIES> org.apache.axis.wsdl.WSDL2Java -t    java -cp <AXIS LIBRARIES> org.apache.axis.wsdl.WSDL2Java -t -s -o <Output directory> <WSDL file>

   A paranccsal kapcsolatos további információk: WSDL2Java leírás az Apache weboldalán.

6. Hozzon létre egy Axis telepítésleírót egy server-config.wsdd nevű XML fájl létrehozásával a WEB-INF könyvtárban.

   A WSDD konfigurációs elemekkel kapcsolatos további információk: Telepítés (WSDD) leírása az Apache weboldalán.

7. Módosítsa az ügyfélkódot, hogy megfeleljen az új környezetnek. Mivel a kiszolgáló nem kerül felhasználásra tárolóként, nincsenek használatban JNDI hivatkozások. A JNDI hivatkozásokat el kell távolítani, és le kell cserélni a közvetlen URL hivatkozásra.

   Például a következő módszer tartalmaz egy JNDI kikeresést:

   
   public DemoType getService() throws Exception {
   
   javax.naming.InitialContext ctx = new javax.naming.InitialContext();
   
   DemoService service = (DemoService)ctx.lookup("java:comp/env/service/Demo");
   
   return service.getDemoService();
   }

   A kikeresést le kell cserélni:

   private com.ibm.demo.webservices.server.DemoType getService() throws Exception {
   
   com.ibm.demo.webservices.server.DemoService_ServiceLocator service = new com.ibm.demo.webservices.server.DemoService_ServiceLocator();
   
   com.ibm.demo.webservices.server.DemoType demoType = service.getDemoService();
   
   return demoType;
   
   }

Használjon hagyományos WebSphere Application Server kiszolgálót annak natív JAX-RPC alrendszerével

Ha a WebSphere Application Server JAX-RPC alrendszert szeretné használni, akkor hagyományos WebSphere Application Server kiszolgálót kell használnia. A Liberty nem támogatja a JAX-RPC alrendszert. Ha Liberty kiszolgálót szeretne használni, akkor a többi lehetőség egyikét kell választania.