Uwagi do wydania modułu modelowania domen Java

© Copyright International Business Machines Corporation 2006. Wszelkie prawa zastrzeżone. Ograniczone prawa na rzecz rządu Stanów Zjednoczonych - używanie produktów, tworzenie ich duplikatów oraz ujawnianie informacji o nich podlega zastrzeżeniom zawartym w umowie GSA ADP Schedule zawartej z firmą IBM Corp.

Uwagi do wydania

1.0 Ograniczenia
2.0 Znane problemy oraz sposoby ich obejścia
   2.1 Refaktoryzacja i powiązania typu kolekcji

1.0 Ograniczenia

Brak

2.0 Znane problemy oraz sposoby ich obejścia

2.1 Refaktoryzacja i powiązania typu kolekcji

Podczas określania powiązań typu kolekcji dla elementów Java na diagramie należy użyć opcji "użyj kolekcji ogólnych". Ta opcja jest dostępna, jeśli typ należy do projektu J2SE w wersji 5.0, tzn. ustawienia kompilatora dla projektu są ustawione na J2SE 5.0 i używane jest środowisko JRE J2SE 5.0. Przykładem tego pola jest:

private List<MojaKlasa> listaMoichKlas;

Podczas refaktoryzacji (przenoszenia lub zmiany nazwy) celu tego powiązania (MojaKlasa) powiązania na diagramie będą automatycznie refaktoryzowane.

Jeśli kolekcje ogólne nie są wykorzystywane (z powodu preferencji użytkownika lub jeśli projekt nie jest projektem J2SE w wersji 5.0), informacje typu kolekcji są zapisywane w adnotacjach w dokumentacji javadoc dla pola, na przykład: 
  /**                                                                             
   * @uml.annotations  for <code>class21</code>
                collection_type="mojPakiet.MojaKlasa"
   */
  private List<MojaKlasa> listaMoichKlas;

W tym przypadku, jeśli dla klasy MojaKlasa przeprowadzana jest refaktoryzacja przenoszenia, informacje typu kolekcji zostaną przerwane, ponieważ informacje w dokumentacji javadoc nie zostaną poddane refaktoryzacji. Użytkownik będzie musiał ręcznie zmienić pełną nazwę klasy w adnotacji dokumentacji javadoc.

W przypadku refaktoryzacji zmiany nazwy, aby zapewnić, że refaktoryzacja obejmuje adnotację, zaznaczona musi być opcja "aktualizuj wystąpienia tekstowe w komentarzach i łańcuchach" w kreatorze Refaktoryzacja. Jeśli ta opcja pozostanie niezaznaczona, ponownie informacje typu kolekcji zostaną przerwane i użytkownik będzie musiał ręcznie zmienić pełną nazwę klasy w adnotacji dokumentacji javadoc.