Ustawienia metadanych dla modułu

Na tej stronie można skonfigurować ignorowanie adnotacji określających informacje o wdrażaniu przez deskryptor wdrażania komponentu EJB środowiska Java EE (Java Platform, Enterprise Edition), deskryptor wdrażania modułu WWW lub moduł archiwum adaptera zasobów JCA (RAR).

Aby wyświetlić tę stronę Konsoli administracyjnej, należy kliknąć opcję Aplikacje > Typy aplikacji > Aplikacje korporacyjne WebSphere > nazwa_aplikacji > Metadane dla modułów. Jest to ta sama strona, co strona Metadane dla modułów znajdująca się w kreatorach instalacji i aktualizacji aplikacji.

Jeśli aplikacja zawiera moduły Java EE 5 lub nowsze, na stronie Metadane dla modułów można zablokować deskryptor wdrażania jednego lub wielu modułów. W przypadku zaznaczenia pola wyboru Atrybut metadata-complete (ustawienia atrybutu metadata-complete na wartość true) i zablokowania deskryptorów wdrażania produkt zapisze w formacie XML cały deskryptor wdrażania modułu (w tym informacje o wdrożeniu z adnotacji).

Adnotacje są standardowym mechanizmem dodawania metadanych do klas Java. Metadanych można użyć w celu uproszczenia procesu programowania i wdrażania artefaktów Java EE w wersji 5 lub nowszych. Przed wprowadzeniem adnotacji języka Java deskryptory wdrażania były standardowym mechanizmem używanym przez komponenty Java EE. Te deskryptory wdrażania były odwzorowywane na format XML, co utrwaliło korzystanie z nich. W przypadku zablokowania deskryptorów wdrażania produkt scala metadane oparte na adnotacjach środowiska Java EE z opartymi na formacie XML metadanymi istniejących deskryptorów wdrażania i utrwala wynik.

Jeśli aplikacja zawiera wiele klas Java, czas przetwarzania wdrożenia dla adnotacji może ulec wydłużeniu. Aby zminimalizować wpływ na wydajność, można użyć jednej z następujących metod:

Określ, czy moduł wymaga platformy Java EE 5 lub 6. Jeśli nie wymaga, adnotacje w ramach klas Java nie zostaną przeskanowane.
Jeśli moduł używa platformy Java EE 5 lub nowszej i nie zawiera żadnych adnotacji, użyj w deskryptorze modułu atrybutu Atrybut metadata-complete. Za jego pomocą można wyłączyć przetwarzanie adnotacji dla modułu, zachowując mimo tego możliwość umieszczania modułów platformy Java EE 5 lub nowszych w pliku deskryptora. Ta wartość atrybutu jest przydatna podczas migrowania aplikacji, gdy nie są dodawane adnotacje.
Jeśli narzędziowe pliki archiwum Java (JAR) nie zawierają informacji o adnotacjach, przeprowadź restrukturyzację aplikacji i umieść pliki JAR w bibliotekach współużytkowanych. Tej metody można użyć, jeśli nie jest możliwe ustawienie atrybutu Atrybut metadata-complete.
Przenieś pliki JAR znajdujące się w katalogu WEB-INF/lib do katalogu głównego pliku archiwum korporacyjnego (EAR). Z powodu wielokrotnej kompresji archiwa zagnieżdżone, takie jak plik JAR umieszczony w archiwum WWW (WAR), które znajduje się z kolei w pliku EAR, są trudne do przeszukiwania.

Moduł

Określa nazwę modułu w zainstalowanej (lub wdrożonej) aplikacji.

Informacje	Wartość
Typ danych	Łańcuch

Identyfikator URI

Określa położenie modułu względem katalogu głównego pliku EAR.

Informacje	Wartość
Typ danych	Łańcuch

Atrybut metadata-complete

Określa, czy zapisywać cały deskryptor wdrażania modułu, włącznie z informacją o wdrożeniu z adnotacji, do formatu XML.

Domyślnie pole wyboru Atrybut metadata-complete nie jest zaznaczone i produkt nie zapisuje danych adnotacji w deskryptorze wdrażania modułu.

Jeśli używane moduły nie zawierają atrybutu metadata-complete lub atrybut metadata-complete ustawiono na wartość false, można zaznaczyć pole wyboru i określić, że produkt ma zapisać dane adnotacji w deskryptorze wdrażania modułu.

Unikanie problemów: Jeśli aplikacja Java EE w wersji 5 lub nowszej używa adnotacji i biblioteki współużytkowanej, nie należy wybierać atrybutu metadata-complete. Jeśli aplikacja używa adnotacji i biblioteki współużytkowanej, ustawienie atrybutu metadata-complete na wartość true powoduje, że adnotacja @EJB, znajdująca się w deskryptorze wdrażania, jest przez produkt niepoprawnie reprezentowana jako <ejb-ref> (zamiast <ejb-local-ref>). W przypadku modułów WWW ustawienie atrybutu metadata-complete na wartość true może spowodować wystąpienie błędów InjectionException. Jeśli zaznaczenie pola wyboru Atrybut metadata-complete (ustawienie wartości true dla atrybutu metadata-complete) jest konieczne, można uniknąć błędów, rezygnując z używania biblioteki współużytkowanej, umieszczając bibliotekę współużytkowaną w katalogu classes albo lib lub w pełni określając metadane w deskryptorach wdrażania.gotcha

Po zaznaczeniu pola wyboru nie można usunąć jego zaznaczenia i moduł nie będzie już wyświetlany na liście modułów na tej stronie. Jeśli zostaną zaznaczone wszystkie pola wyboru, odsyłacz do tej strony nie będzie już wyświetlany na stronie ustawień aplikacji korporacyjnej.

Informacje	Wartość
Typ danych	Wartość boolowska
Wartość domyślna	false (brak zaznaczenia)

Nazwa pliku: urun_rapp_metadata_lockdd.html