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_do_aplikacji > Dalej > Szczegółowa - wyświetl wszystkie opcje i parametry instalacji > Dalej > Dalej lub Kontynuuj > Prekompiluj pliki stron JavaServer Pages > Dalej > 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 powiązań i rozszerzeń IBM® rozszerzenie nazwy pliku (.xmi lub .xml) różni się w zależności od tego, czy używana jest aplikacja lub moduł w wersji Java EE wcześniejszej niż 5, czy też aplikacja lub moduł w wersji Java EE 5 lub nowszej. Plik rozszerzeń lub powiązań IBM ma nazwę ibm-*-ext.xmi lub ibm-*-bnd.xmi, gdzie * to typ pliku rozszerzeń lub powiązań, na przykład app, application, ejb-jar bądź web. Zastosowanie mają następujące warunki:

W przypadku aplikacji lub modułu korzystającego z platformy Java EE w wersji wcześniejszej niż 5 nazwa pliku musi mieć rozszerzenie .xmi.
W przypadku aplikacji lub modułu korzystającego z platformy Java EE w wersji 5 lub nowszej nazwa pliku musi mieć rozszerzenie .xml. Jeśli do aplikacji lub modułu są włączone pliki .xmi, produkt je ignoruje.

Moduł platformy Java EE w wersji 5 lub nowszej może jednak istnieć w ramach aplikacji zawierającej pliki platformy Java EE w wersji wcześniejszej niż 5 i korzystającej z rozszerzenia nazwy pliku .xmi.

Pliki ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi i ibm-portlet-ext.xmi nadal korzystają z rozszerzeń .xmi.

sptcfg

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ę dla kompilatora JSP do wykorzystania 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 klasy jest używana tylko w celu identyfikacji zasobów znajdujących się poza aplikacją, potrzebnych do kompilacji JSP i zidentyfikowanych w inny sposób (np. jako 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:

Na liście modułów WWW zaznacz pole wyboru Zaznacz znajdujące się obok każdego modułu WWW używanego przez daną ścieżkę klasy.
Rozwiń pole Zastosuj wiele odwzorowań.
Określ żądaną ścieżkę klasy.
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.

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

Poziom źródła JDK

Służy do określania poziomu źródła, na jakim kompilator Java kompiluje źródła JSP Java. Poprawne wartości to: 13, 14, 15, 16 i 17. Wartość domyślna wynosi 13 w przypadku modułów WWW w wersjach wcześniejszych niż Java EE 5 (oznacza określenie poziomu źródła na 1.3) oraz 16 w przypadku modułów WWW w wersji Java EE 5 i nowszych.

Wyłącz kompilację środowiska wykonawczego JSP

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ą istnieć, aby wczytanie plików klas było możliwe. 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.

Nazwa pliku: uweb_jspcompile.html