Określanie opcji kompilacji ustawień JSP (JavaServer Pages)

Ta strona służy do określenia opcji używanych przez kompilator plików JavaServer Pages (JSP).

Ta strona Konsoli administracyjnej jest wyświetlana w kreatorach instalowania i aktualizowania aplikacji. Aby wyświetlić tę stronę, należy zaznaczyć opcję Prekompiluj pliki JavaServer Pages na stronie Wybierz opcje instalacji. Dlatego aby wyświetlić tę stronę, należy kliknąć opcję Aplikacje > Nowa aplikacja > Nowa aplikacja korporacyjna > ścieżka_aplikacji > Następny > Szczegółowe-Wyświetl wszystkie opcje i parametry instalacji > Następny > Następny lub Kontynuuj > Prekompiluj pliki stron JavaServer Pages > Następny > Krok: Określ opcje na potrzeby kompilacji plików JSP.

Na tej stronie można określić opcje kompilatora plików JSP tylko podczas instalowania lub aktualizowania aplikacji zawierającej moduły WWW. Po zainstalowaniu aplikacji należy zmodyfikować parametry konfiguracyjne mechanizmu JSP pliku modułu WWW WEB-INF/ibm-web-ext.xmi, aby zmienić opcje kompilatora JSP.

Obsługiwane konfiguracje: W przypadku plików rozszerzeń i powiązań IBM® : Rozszerzenie nazwy pliku .xmi lub .xml jest inne w zależności od tego, czy używana jest aplikacja lub moduł w wersji wcześniejszej niżJava™ EE 5, czy też aplikacja lub moduł Java EE 5 lub nowsza. Plik rozszerzenia lub powiązania IBM ma nazwę ibm-*-ext.xmi lub ibm-*-bnd.xmi , gdzie * jest typem pliku rozszerzenia lub powiązania, takim jak app, application, ejb-jarlub web. Obowiązują następujące warunki:
  • W przypadku aplikacji lub modułu, który używa wersji Java EE wcześniejszej niż wersja 5, rozszerzenie pliku musi mieć wartość .xmi.
  • W przypadku aplikacji lub modułu, który używa środowiska Java EE w wersji 5 lub nowszej, rozszerzenie pliku musi mieć wartość .xml. Jeśli pliki produktu .xmi są dołączone do aplikacji lub modułu, produkt zignoruje pliki .xmi .

Jednak moduł Java EE 5 lub nowszy może istnieć w aplikacji, która zawiera pliki w wersji wcześniejszej niżJava EE 5, i korzysta z rozszerzenia nazwy pliku .xmi .

Pliki ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmii ibm-portlet-ext.xmi nadal korzystają z rozszerzeń plików .xmi .

Moduł WWW

Określa nazwę modułu wewnątrz aplikacji.

Identyfikator URI

Służy do określania położenia modułu względem katalogu głównego aplikacji (plik EAR).

Ścieżka klasy JSP

Określa tymczasową ścieżkę klasy dla kompilatora JSP, który ma być używany podczas kompilowania plików JSP podczas instalowania aplikacji. Ta ścieżka klasy nie jest zapisywana po zakończeniu instalowania aplikacji i nie będzie wykorzystywana po uruchomieniu aplikacji. Ta ścieżka klas jest używana tylko do identyfikowania zasobów poza aplikacją, które są niezbędne do kompilacji plików JSP i są identyfikowane za pomocą innych środków, takich jak biblioteki współużytkowane, po zainstalowaniu aplikacji. W konfiguracjach wdrożenia sieci ta ścieżka klasy jest specyficzna dla komputera, na którym uruchomiono menedżer wdrażania.

Aby wiele modułów WWW używało tej samej ścieżki klasy:

  1. Na liście modułów WWW zaznacz pole wyboru Wybierz dla każdego modułu WWW, dla którego ma być używana konkretna ścieżka klasy.
  2. Rozwiń pole Zastosuj wiele odwzorowań.
  3. Określ ścieżkę klasy, która ma zostać określona.
  4. Kliknij przycisk Zastosuj.

Użyj pełnych nazw pakietów

Określa, czy mechanizm JSP generuje i ładuje klasy JSP za pomocą pełnych nazw pakietów.

Jeśli używane są pełne nazwy pakietów, prekompilowane nazwy klasy JSP mogą zostać skonfigurowane jako serwlety w pliku web.xml bez potrzeby użycia atrybutu jsp-file. Jeśli pełne nazwy pakietów nie są używane, wszystkie klasy JSP są generowane w tym samym pakiecie, posiadającym krótsze ścieżki do systemu plików.

Jeśli opcje useFullPackageNames oraz disableJspRuntimeCompilation są ustawione na true, pojedynczy program ładujący klasy jest używany w celu ładowania wszystkich klas JSP nawet w przypadku, jeśli pliki JSP nie zostały skonfigurowane jako serwlety w pliku web.xml.

Ta opcja jest taka sama, jak w przypadku parametru mechanizmu JSP produktu useFullPackageNames .

Poziom źródła JDK

Określa poziom źródła, na którym kompilator Java kompiluje źródła JSP Java. Poprawne wartości to 13, 14, 15, 16, 17i 18.

  • Dla modułu WWW 2.5, jdkSourceLevel ma wartość 1.5
  • Dla modułu WWW w wersji 3.0, pakiet jdkSourceLevel ma wartość 1.6
  • W przeciwnym razie jest to 1.3
Po zastosowaniu poprawki z raportu APAR PI99486, można użyć właściwości systemowej com.ibm.websphere.management.application.client.JSPCompile.javaEE.jdkSourceLevel . Jeśli ta właściwość jest ustawiona na wartość true, zachowanie jest następujące:
  • Dla modułu WWW 2.5, jdkSourceLevel ma wartość 1.5
  • Dla modułu WWW w wersji 3.0, pakiet jdkSourceLevel ma wartość 1.6
  • W przypadku modułu WWW w wersji 3.1 i nowszych pakiet jdkSourceLevel ma wartość 1.7.
  • W przeciwnym razie pakiet jdkSourceLevel ma wartość 1.3

Wyłącz kompilację stron JSP w czasie wykonywania

Określa, czy plik JSP nie powinien być przekształcany lub kompilowany podczas uruchomienia, nawet jeśli plik klasa .class nie istnieje.

Jeśli ta opcja jest ustawiona na true, silnik JSP nie przekształci i nie skompiluje plików JSP podczas uruchomienia; mechanizm JSP wczytuje tylko prekompilowane pliki klas. Pliki źródłowe JSP nie muszą być obecne w plikach klas ładowania. Można zainstalować aplikację bez źródła JSP, ale musi ona posiadać prekompilowane pliki klas.

Jeśli pojedynczy program ładujący klasy aplikacji WWW ma wczytać wszystkie klasy JSP, ta opcja kompilatora oraz opcja Użyj pełnych nazw pakietu musi mieć wartość true.

Jest to ta sama opcja, co parametr disableJspRuntimeCompilation mechanizmu JSP.