Doporučení: Zvažte přechod na JAX-WS
Pokud již provádíte změny ve svých webových službách JAX-RPC v rámci migrace nebo modernizace, důrazně doporučujeme zvážit přechod na systém JAX-RPC JAX-WS ( Java API for XML Web Services).

JAX-WS je nástupcem JAX-RPC a nabízí několik výhod:

Přechod na JAX-WS nyní může snížit budoucí technický dluh a sladit vaši aplikaci s aktuálními standardy webových služeb Java.

Pokyny k migraci z JAX-RPC na JAX-WS naleznete ve scénářích migrace webových služeb: JAX-RPC na JAX-WS a dokumentaci k JAXB.

Nepoužívat deskriptor implementace webových služeb JBoss
Toto pravidlo značí všechny existující soubory webservices.xml, aby zjistily přítomnost souboru deskriptoru implementace webových služeb J2EE pro JBoss.

Generování webových služeb JAX-RPC na základě deskriptorů nasazení webových služeb JBoss Java Platform, Enterprise Edition ( Java EE ), automatická oprava vytvoří Ant skript, který používá příslušné IBM Ant úlohy. To zahrnuje kontrolu nasazení webových služeb a konfiguraci skriptu Ant pro generování požadovaných artefaktů.


Podmínky pro spouštění pravidla:
Toto pravidlo zjistí přítomnost webových služeb JAX-RPC na základě následujících kritérií:
a. Přítomnost souboru popisovače nasazení webových služeb J2EE webservices.xml
b. Binární skener zjistí, že vygenerovaný soubor IBM Ant ještě neexistuje v kořenové složce projektu.

Vlastnosti pravidla:
Je třeba zadat správné hodnoty vlastností pravidla. Chcete-li změnit hodnoty vlastností pro toto pravidlo, vyberte pravidlo v okně Konfigurace analyzátoru softwaru. Poté použijte pole na kartě Vlastnosti. Vlastnosti pro toto pravidlo jsou:
  • Název vygenerovaného skriptu Ant : 
    Toto je název nového skriptu Ant, který bude vygenerován.  Soubor musí být platný název souboru.  Hodnota nesmí obsahovat žádná lomítka vpřed ani vzad.  Vygenerovaný soubor bude v kořenové složce souboru projektu.
    Výchozí hodnota: build-ibm-ws.xml

  • Název složky generování:
    Jedná se o název složky, do které jsou umístěny vygenerované artefakty.   Hodnota nesmí obsahovat žádná lomítka vpřed ani vzad.  Generování se nachází v kořenové složce projektu.
    Výchozí hodnota: ibm-ws-gen

Cesta ke třídě Ant:
Cesta k třídě mravenců se vypočítá z projektu Eclipse.  Je důležité ověřit, zda jsou všechny prvky potřebné pro jsou na cestě k třídě Eclipse.

Služby JAX-RPC definované v souboru webservices.xml
Na základě informací a typu služeb definovaných v souboru webservices.xml je skript Ant vygenerován pro reprodukci souboru JAXRPC.

  • Cíle vygenerovaného skriptu Ant:
    Vygenerovaný skript Ant obsahuje cíle pro generování souboru WSDL a služby JAX-RPC.
    Cíl generování WSDL se generuje pouze v případě, že nelze najít soubor WSDL definovaný v prvku <wsdl-soubor>.
    Tagret pro generování WSDL (pokud je vytvořen) má hodnotu název: genWSDL_ssss, kde ssss je název služby, jak je definován v elementu <webservice-description-name>.
    Cíle generování služeb mají název, genService_pppp, kde pppp je název portu definovaný v příkazu elementu <název-komponenty-portu>.

Úlohy Ant serveru IBM WebSphere Application Server
Produkt IBM WebSphere(R) Application Server zahrnuje úlohy Ant jako java2wsdl a wsdl2java ke generování nezbytných artefaktů pro služby JAX-RPC.  Generovaný skript Ant používá tyto úlohy k sestavení služby. Další informace o těchto úlohách lze získat z dokumentace k produktu WebSphere Application Server.

Spuštění skriptu Ant
Poté, co automatická oprava vygeneruje skript Ant, zkontrolujte jej a přidejte potřebné úpravy. Pokyny pro přizpůsobení naleznete v dokumentaci k webu WebSphere Application Server IBM Ant úkolů. Skript je nutné spustit pomocí nástrojů Ant, které poskytuje IBM, což jsou tyto nástroje součástí IBM WebSphere Application Server   Skript IBM Ant lze spustit z:
  • WAS_HOME\bin\ws_ant.bat v operačních systémech Windows(R)
  • WAS_HOME\bin\ws_ant.sh v operačních systémech UNIX(R)
Příklad: c:\IBM\AppServer\bin\ws_ant.bat -f c:\eclipse\MyProject\ibm-ws-gen.xml genService_TestService

Když jsou spuštěny cíle Ant, vytvořené artefakty se nacházejí na adrese ve složce generování.  Vygenerované artefakty si můžete prohlédnout kód, deskriptory nasazení a poté tyto artefakty přidat do svých moduly.