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. W skanerze kodu źródłowego szybka poprawka generuje skrypt Ant ze specyficznymi zadaniami narzędzia IBM Ant. Zadania te generują usługi Web Service JAX-RPC na podstawie deskryptorów wdrażania usług WWW JBoss Java Platform, Enterprise Edition (Java EE). Szybka poprawka skanuje deskryptory wdrażania usług WWW, a następnie generuje skrypt narzędzia Ant.

Warunki wyzwalające regułę:
Ta reguła wykrywa obecność usług WWW JAX-RPC na postawie następujących kryteriów:
a. Istnieje plik deskryptora wdrażania usług WWW J2EE webservices.xml.
b. Skaner kodu źródłowego wykrywa, że plik wygenerowany przez narzędzie IBM Ant nie istnieje jeszcze w folderze głównym projektu.

Właściwości reguły:
Właściwości w tej regule mają wpływ tylko na szybką poprawkę. 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. Nazwa musi być poprawną nazwą pliku.  Wartość nie może zawierać żadnych ukośników ani ukośników odwrotnych. Wygenerowany plik będzie się znajdował w folderze głównym projektu.
    Wartość domyślna: build-ibm-ws.xml.

  • Nazwa folderu generowania:
    Jest to nazwa folderu, w którym zostają umieszczone wygenerowane artefakty.   Wartość nie może zawierać żadnych ukośników ani ukośników odwrotnych. Folder generowania znajduje się w folderze głównym projektu.
    Wartość domyślna: ibm-ws-gen.

Ścieżka klas narzędzia Ant:
Ścieżka klas ant jest obliczana na podstawie projektu Eclipse. Ważne jest sprawdzenie, czy wszystkie elementy niezbędne do kompilacji znajdują się w ś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.
    Element docelowy WSDL zostaje wygenerowany tylko wtedy, gdy szybka poprawka nie może znaleźć pliku WSDL zdefiniowanego w elemencie <wsdl-file>.
    Wygenerowany docelowy plik WSDL (jeśli zostanie utworzony) ma nazwę genWSDL_ssss, gdzie ssss to nazwa usługi zdefiniowanej w elemencie <webservice-description-name>.
    Elementy docelowe generowania Service mają nazwy genService_pppp, gdzie pppp to nazwa portu zdefiniowana przez 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 wygenerowaniu przez szybką poprawkę skryptu Ant należy wyświetlić ten skrypt i w razie potrzeby wprowadzić odpowiednie zmiany. Zapoznaj się z dokumentacją serwera WebSphere Application Server, aby uzyskać dodatkowe informacje na temat dostosowywania zadań IBM Ant. Skrypt należy uruchomić za pomocą narzędzi Ant udostępnionych przez firmę IBM, które są dołączane do serwera 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 elementów docelowych narzędzia Ant wygenerowane artefakty znajdą się w folderze generowania. Można przeanalizować wygenerowany kod i deskryptory wdrażania, a następnie dodać te artefakty do odpowiednich modułów.