Migracja programów J2C z poziomu wiersza komend

Migrację programów z produktu WebSphere Studio Application Developer Integration Edition do narzędzi programistycznych Rational można przeprowadzić z poziomu wiersza komend.

Aby uruchomić narzędzie migracji J2C w wierszu komend:

Przejdź do katalogu zawierającego pliki J2CMigration.bat i J2CMigration.sh:
- Domyślny katalog instalacyjny narzędzia migracji J2C to napęd_systemowy: %PROGRAMFILES%IBM\SDP70Shared\plugins\com.ibm.j2c.migration.wsadie_7.0.0.
- Domyślny katalog instalacyjny narzędzia migracji J2C to: /opt/IBM/SDP70Shared\plugins\com.ibm.j2c.migration.wsadie_7.0.0.
Zmodyfikuj plik J2CMigration.bat lub J2CMigration.sh.
1. Znajdź miejsce w pliku, w którym ustawiane są zmienne:
  ECLIPSE_ROOT: Jest to katalog, w którym znajdują się pliki eclipse.exe i eclipse.ini. W przypadku produktów programistycznych Rational domyślny katalog to %PROGRAMFILES%\IBM\SDP70.
  - ECLIPSE_ROOT= %PROGRAMFILES%\IBM\SDP70 - ustaw katalog, który odpowiada konfiguracji używanego środowiska.
  - SET ECLIPSE_ROOT=/opt/IBM/SDP70
  JDK_HOME: Jest to katalog, w którym znajduje się plik java.exe.
  - Domyślna ścieżka to %ECLIPSE_ROOT%\jdk\jre\bin
  - SET JDK_HOME=%ECLIPSE_ROOT%/jdk/jre/bin
  .
  rarsVarPath: Jest to ścieżka do folderu adapterów zasobów.
  - SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters.
  - SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters.
  was.runtime: Jest to ścieżka do folderu środowiska wykonawczego WAS.
  - SET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
  - SET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
Zapisz i zamknij plik. Przejdź do katalogu J2CMigration znajdującego się w folderze instalacyjnym produktu i uruchom plik J2CMigration.bat lub J2CMigration.sh.
Gdy narzędzie migracji uruchamiane jest z poziomu wiersza komend, nie można wskazać środowiska wykonawczego serwera dla projektu po migracji. Tak działa narzędzie migracji. Jeśli dostępne jest środowisko wykonawcze serwera WAS 5.1, wówczas jest ono wybierane domyślnie dla projektów Java, EJB i WWW poddawanych migracji. Jeśli środowisko WAS 5.1 jest niedostępne, wówczas wybierane jest pierwsze środowisko wykonawcze na liście. Najprawdopodobniej będzie to serwer WAS 6.1, chociaż zależy to od konfiguracji danej instalacji.

Wprowadź odpowiednią komendę i opcje, zgodnie z opisem w poniższych tabelach:

Tabela 1. Komendy uruchamiające narzędzie migracji J2C
Komenda w systemie Windows	Komenda w systemie Linux	Opis
J2CMigration.bat [opcje]	./J2CMigration.sh [opcje]	Użyj tej komendy, aby uruchomić narzędzie migracji J2C. Dozwolone są dwa wzorce składni: Składnia: J2CMigration.bat -w źródło_wsdl -d obszar_roboczy [-p projekt] [-t typ] [-o opcja] [-s podsumowanie] J2CMigration.bat -f plik_wejściowy_migracji
J2CMigration [opcje]		Opcje -w źródło_wsdl: Pełna ścieżka do pliku WSDL usługi lub pełna ścieżka do folderu zawierającego jeden lub więcej plików WSDL usługi. -f plik_wejściowy_migracji: Plik migracji zawierający wszystkie powyższe opcje, które mają zostać przekazane do narzędzia migracji wywołanego w wierszu komend. Ta metoda przydaje się wówczas, gdy opcje wpisywane w wierszu komend powodują przekroczenie dopuszczalnej długości komendy. Przykładowy plik, SampleMigration.txt, można znaleźć w sekcji Przykładowy plik wejściowy migracji. -d obszar_roboczy: Obszar roboczy, w którym generowane są pliki wyjściowe. [-p projekt] : Nazwa projektu, w którym będą generowane artefakty po migracji. Nie należy podawać ścieżki, a tylko samą nazwę projektu. Można wybrać utworzenie projektu WWW, Java lub EJB. Jeśli projekt nie zostanie określony, zostanie utworzony domyślny projekt Java. Jeśli opcja -p zostanie pominięta, wówczas artefakty po migracji będą generowane w projekcie określonym w pliku WSDL usługi. [-t typ]: Typ projektu wyjściowego: WEB EJB JAVA [-o opcja] databindingonly: Po określeniu tej opcji w procesie migracji będą generowane jedynie komponenty bean wiązania danych. Po wprowadzeniu opcji databindingonly opcja commandbean jest ignorowana. commandbean: Po określeniu tej opcji generowany jest komponent bean komendy. [-s podsumowanie]: Nazwa pliku, w którym ma zostać zapisane podsumowanie migracji (bez rozszerzenia .xml). Jeśli nie zostanie określona, zostanie wygenerowany plik o nazwie domyślnej - j2cmigration_datownik.xml. Jeśli plik z podsumowaniem o podanej nazwie już istnieje, podsumowanie zostanie zapisane w pliku summary_datownik.xml. W przypadku określenia położenia, na przykład d:\folderPodsumowania\podsumowanie, katalog folderPodsumowania musi już istnieć. Jeśli położenie nie zostanie określone, podsumowanie zostanie wygenerowane w katalogu bieżącym.

Przykłady migracji przeprowadzanej w wierszu komend

J2CMigration.bat -d "d:\obszarroboczy" -w "d:\plikwsdl.wsdl" -p "ProjektWyjsciowy"

./J2CMigration.sh -d /home/obszarroboczy -w /home/plikwsdl.wsdl -p ProjektWyjsciowy

Wprowadzenie tej komendy spowoduje przeprowadzenie migracji pojedynczej usługi zdefiniowanej w pliku d:\plikwsdl.wsdl. Artefakty po migracji zostaną wygenerowane w projekcie Java, któremu zostanie nadana nazwa "ProjektWyjsciowy" i który zostanie umieszczony w obszarze roboczym d:\obszarroboczy. Zostaną wygenerowane następujące pliki:

plik interfejsu w języku Java
plik proxy (implementacji) w języku Java
plik wiązania danych w języku Java
plik j2cmigration_datownik.xml (podsumowanie migracji zostanie zapisane w katalogu bieżącym)

J2CMigration.bat  -w "d:\mojFolderWsdl" -p "ProjektWyjsciowy" -s "RaportZMigracji"

./J2CMigration.sh -w /home/mojFolderWsdl -p ProjektWyjsciowy -s /home/obszarroboczy/RaportZMigracji

Ta komenda spowoduje przeprowadzenie migracji wszystkich usług z folderu d:\mojFolderWsdl lub ze wszystkich podfolderów tego folderu. Artefakty po migracji (dla wszystkich usług) zostaną wygenerowane w pojedynczym projekcie Java o nazwie "ProjektWyjsciowy". Zostaną wygenerowane następujące pliki:

plik interfejsu w języku Java
plik proxy (implementacji) w języku Java
plik wiązania danych w języku Java
plik RaportZMigracji.xml (podsumowanie migracji zostanie zapisane w katalogu bieżącym)

J2CMigration.bat -w "d:\mojfolder" -o databindingonly

./J2CMigration.sh -w /home/mojfolder -o databindingonly

Ta komenda spowoduje przeprowadzenie migracji wszystkich usług z folderu d:\mojfolder lub ze wszystkich podfolderów tego folderu. Zostaną wygenerowane następujące pliki:

plik wiązania danych w języku Java
plik j2cmigration_datownik.xml (podsumowanie migracji zostanie zapisane w katalogu bieżącym)

J2CMigration.bat -w "d:\mojfolder" -o commandbean -t EJB

./J2CMigration.sh -w /home/mojfolder -o commandbean -t EJB

Ta komenda spowoduje przeprowadzenie migracji wszystkich usług z folderu d:\mojfolder lub ze wszystkich podfolderów tego folderu. Artefakty po migracji zostaną wygenerowane w projektach EJB o nazwach zaczerpniętych z definicji WSDL. Zostaną wygenerowane następujące pliki i artefakty:

plik interfejsu w języku Java
plik proxy (implementacji) w języku Java
pliki wiązania danych w języku Java
komponent bean komendy
plik j2cmigration_datownik.xml (podsumowanie migracji zostanie zapisane w katalogu bieżącym)

J2CMigration.bat -f "d:\PrzykladowaMigracja.txt"

./J2CMigration.sh  -f /home/PrzykladowaMigracja.txt"

Przeprowadzenie migracji zgodnie z opcjami podanymi w pliku wejściowym migracji.