Zalecenie: Rozważ migrację do JAX-WS
Jeśli już wprowadzasz zmiany w swoich usługach internetowych JAX-RPC w ramach migracji lub modernizacji, zdecydowanie zalecamy ocenę przejścia na JAX-WS ( Java API for XML Web Services).

JAX-WS jest następcą JAX-RPC i oferuje kilka korzyści:

Migracja do JAX-WS już teraz może zmniejszyć przyszły dług techniczny i dostosować aplikację do aktualnych standardów usług sieciowych Java.

Wskazówki dotyczące migracji z JAX-RPC do JAX-WS można znaleźć w scenariuszach migracji usług sieciowych: dokumentacji JAX-RPC do JAX-WS i JAXB.

Nie należy używać deskryptora wdrażania usług WWW serwera JBoss
Ta reguła powoduje oznaczenie istniejącego pliku webservices.xml w celu sprawdzenia obecności pliku deskryptora wdrażania usług WWW J2EE dla serwera JBoss.

Aby wygenerować usługi sieci Web JAX-RPC w oparciu o deskryptory wdrożenia usług sieci Web JBoss Java Platform, Enterprise Edition ( Java EE ), zautomatyzowana poprawka utworzy skrypt Ant, który wykorzystuje odpowiednie zadania IBM Ant. Obejmuje to skanowanie deskryptorów i skonfigurowanie skryptu Ant do generowania wymaganych artefaktów.


Warunki wyzwalające regułę:
Ta reguła wykrywa obecność usług WWW JAX-RPC na postawie następujących kryteriów:
a. Obecność pliku deskryptora wdrożenia usług internetowych J2EE webservices.xml
b. Skaner binarny wykrywa, że wygenerowany plik IBM Ant nie istnieje jeszcze w folderze głównym projektu.

Właściwości reguły:
Należy podać poprawne wartości właściwości reguły. Aby zmienić wartości właściwości dla tej reguły, należy wybrać regułę w oknie Konfiguracje analizatora oprogramowania. Następnie należy użyć tych pól na karcie Właściwości. Właściwości dla tej reguły są następujące:
  • Nazwa generowanego skryptu Ant: 
    Jest to nazwa nowego skryptu Ant, który zostanie wygenerowany musi być prawidłową nazwą pliku.  Wartość nie może zawierać żadnych ukośników do przodu ani do tyłu.  Wygenerowany plik będzie znajdował się w folderze głównym projektu projektu.
    Wartość domyślna: build-ibm-ws.xml.

  • Nazwa folderu generowania:
    Jest to nazwa folderu, w którym umieszczane są wygenerowane artefakty. wartość nie może zawierać żadnych ukośników do przodu ani do tyłu znajduje się w folderze głównym projektu.
    Wartość domyślna: ibm-ws-gen.

Ścieżka klas narzędzia Ant:
Ścieżka klasy mrówki jest obliczana na podstawie projektu Eclipse; Ważne jest, aby sprawdzić, czy wszystkie elementy niezbędne do kompilacji znajdują się na ścieżce klas Eclipse.

Usługi JAX-RPC zdefiniowane w pliku webservices.xml
Na podstawie informacji i typu usług zdefiniowanych w pliku webservices.xml generowany jest skrypt Ant odtwarzający usługę JAX-RPC.

  • Generowane elementy docelowe narzędzia Ant:
    Wygenerowany skrypt Ant zawiera cele umożliwiające wygenerowanie pliku WSDL i usługi JAX-RPC.
    Cel generowania WSDL jest generowany tylko wtedy, gdy nie można zlokalizować pliku WSDL zdefiniowanego w elemencie <wsdl-file>.
    Znacznik generowania WSDL (jeśli został utworzony) ma nazwę: genWSDL_ssss, gdzie ssss to nazwa usługi zdefiniowana w elemencie w elemencie <webservice-description-name>.
    Cele generowania usług mają nazwę, genService_pppp, gdzie pppp jest nazwą portu zdefiniowaną przez element element, <port-component-name>.

Zadania Ant serwera IBM WebSphere Application Server
Serwer IBM WebSphere(R) Application Server zawiera zadania Ant, takie jak java2wsdl i wsdl2java, służące do generowania wymaganych artefaktów dla usług JAX-RPC.   Wygenerowany skrypt Ant używa tych zadań do zbudowania usługi. Dodatkowe informacje na temat tych zadań można uzyskać w dokumentacji serwera WebSphere Application Server.

Uruchamianie skryptu Ant
Po tym, jak automatyczna poprawka wygeneruje skrypt Ant, przejrzyj go i dodaj wszelkie niezbędne dostosowania. Wskazówki dotyczące dostosowywania zadań można znaleźć w dokumentacji WebSphere Application Server IBM Ant zadań. Skrypt należy uruchomić przy użyciu narzędzi Ant dostarczonych przez IBM, które są dołączone do IBM WebSphere Application Server   Skrypt IBM Ant można uruchomić z:
  • WAS_HOME\bin\ws_ant.bat w systemach operacyjnych Windows(R)
  • WAS_HOME\bin\ws_ant.sh w systemach operacyjnych UNIX(R)
Przykład: c:\IBM\AppServer\bin\ws_ant.bat -f c:\eclipse\MyProject\ibm-ws-gen.xml genService_TestService

Po uruchomieniu celów Ant, wygenerowane artefakty znajdują się w folderze generowania.  Możesz sprawdzić wygenerowany kod, deskryptory wdrożenia, a następnie dodać te artefakty do swoich modułów modułów.