Co nowego w wersji Juno (JDT)

Poniżej opisano niektóre ciekawsze i ważniejsze zmiany wprowadzone w narzędziach programistycznych Java dla wersji Juno (3.8 i 4.2) środowiska Eclipse. Zostały one podzielone na następujące sekcje:

Zobacz również temat Co nowego w środowisku Java 7, aby zapoznać się z funkcjami dodanymi w celu obsługi języka Java 7.

Zmiany dla platformy zostały również opisane w dokumencie Platforma Eclipse - co nowego.


Edytor Java

Zapis CamelCase w widoku szybkiego schematu Widoki Szybki schemat (Ctrl+O) i Szybka hierarchia (Ctrl+T) w edytorze Java teraz obsługują też dopasowywanie nazwy elementu do zapisu camelCase, podobnie jak w oknie dialogowym Otwieranie typu i w aktywnej obsłudze treści.

Szybki schemat elementu StyledText ze wzorcem „gCa”

Znaki zmiany znaczenia * i ? oczywiście również działają.
Szybka asysta konwersji rozszerzonej pętli for Czy w rozszerzonych pętlach for potrzebujesz uzyskiwać dostęp do obiektu Iterator lub indeksu pętli? Teraz za pomocą szybkiej asysty (Ctrl+1) możesz przekształcić funkcję:

Zrzut ekranu funkcji szybkiej asysty dla słowa kluczowego „for” rozszerzonej pętli „for”

  • Opcja Przekształć w indeksowaną pętlę „for” jest dostępna dla wyrażeń opartych na tablicach i typie List.
  • Opcja Przekształć w pętlę „for” opartą na iteratorze jest dostępna dla wyrażeń opartych na typie Iterable.
Ulepszone dopasowanie nawiasów w edytorze Java Edytor Java obsługuje teraz podświetlanie obejmujących nawiasów.

Nawiasy obejmujące

Tę opcję można skonfigurować na stronie preferencji Java > Edytor.

Preferencje podświetlania nawiasów

Oprócz tego opcja Nawigacja > Idź do > Zgodny nawias (Ctrl+Shift+P) działa teraz w każdym miejscu w pliku. Jeśli przed wywołaniem tej akcji nawias nie jest zaznaczony, akcja powoduje przejście do najbliższego zamykającego nawiasu. Po kolejnym wywołaniu akcji przechodzi do odpowiadającego nawiasu otwierającego. Przy trzecim wywołaniu jest odtwarzane pierwotne zaznaczenie.

Do tej pory zgodne nawiasy były znajdowane tylko wtedy, gdy kursor był umieszczany bezpośrednio za nawiasem. Teraz zgodny nawias jest znajdywany po umieszczeniu kursora za lub przed nawiasem.

Przykłady zgodnych nawiasów

Po umieszczeniu wskaźnika myszy nad zamykającym nawiasem klamrowym można wyświetlić źródło w okolicy otwierającego nawiasu w przypiętym okienku. Ta opcja jest pomocna, gdy chcesz wyświetlić kod na początku długiego bloku kodu. W przypiętym okienku znajduje się również liczba wierszy kodu.

Przykład 1 przypiętego okienka nawiasu klamrowego

Przypięte okienko przydaje się też do tymczasowego „podświetlenia” krótkiego bloku kodu.

Przykład 2 przypiętego okienka nawiasu klamrowego

Umieszczenie wskaźnika myszy nad dokumentacją Javadoc powoduje wyświetlenie adnotacji parametrów Po umieszczeniu wskaźnika myszy nad dokumentacją Javadoc są teraz wyświetlane adnotacje parametrów metody:

org.eclipse.User.User(@NonNull String name, int uid, @Nullable String email)

Typ pliku „Plik *.class bez źródła” Nowy typ pliku Plik *.class bez źródła pozwala powiązać wewnętrzny lub zewnętrzny edytor z plikami klas bez dołączonego źródła. Pozwala to na przykład otwierać plik klas w dekompilatorze:

Zrzut ekranu strony preferencji „Powiązania plików”

Domyślne implementacje propozycji poprawek W narzędziach JDT są teraz udostępnione następujące domyślne implementacje propozycji poprawek, których można użyć do wnoszenia szybkich poprawek i szybkiej asysty.
  • org.eclipse.jdt.ui.text.java.correction.ChangeCorrectionProposal
  • org.eclipse.jdt.ui.text.java.correction.CUCorrectionProposal
  • org.eclipse.jdt.ui.text.java.correction.ASTRewriteCorrectionProposal
Ułatwia to implementowanie funkcji szybkich poprawek i szybkiej asysty działających na plikach .java i korzystających z interfejsu ASTRewrite.
Aktywna obsługa treści w pliku package-info.java Aktywna obsługa treści (Ctrl+Spacja) jest teraz dostępna w pliku package-info.java służącym do deklarowania adnotacji i dokumentacji Javadoc na poziomie pakietu.

Element wywoływany aktywnej obsługi treści do dodawania adnotacji na poziomie pakietu w deklaracji pakietu

Kompilator Java

Selektywnie ignoruj błędy/ostrzeżenia z folderów źródłowych Teraz można skonfigurować narzędzia JDT tak, aby ignorowały opcjonalne błędy/ostrzeżenia z niektórych folderów źródłowych. Właściwości projektu > Ścieżka budowania Java > Kompilator > Źródło.

Strona Ścieżka budowania Java z podświetloną opcją „Ignoruj opcjonalne problemy kompilacji”

Po wybraniu wartości Tak narzędzia JDT będą ignorować błędy/ostrzeżenia skonfigurowane na stronie Preferencje > Java > Kompilator > Błędy/ostrzeżenia. Może to być przydatne w przypadku folderów źródłowych zawierających generowane automatycznie klasy lub testy.

Rozszerzona diagnostyka wykrywania niekompletnych instrukcji switch Analiza narzędzi JDT dotycząca niekompletnych instrukcji switch jest teraz skuteczniejsza i można ją skonfigurować bardziej szczegółowo. Więcej informacji można znaleźć tutaj.

Teraz kompilator sprawdza osobno dwa kryteria pozwalające stwierdzić kompletność instrukcji switch:

  • Instrukcja switch działająca na wyliczeniu powinna definiować po jednej instrukcji case dla każdej stałej wyliczenia.
  • Każda instrukcja switch niezależnie od typu powinna definiować przypadek default.

Domyślnie kompilator ostrzega w przypadku instrukcji switch działającej na wyliczeniu, w przypadku której są naruszone oba kryteria:

Ostrzeżenie dla instrukcji switch działającej na wyliczeniu, w której brakuje przypadku default

Tym ostrzeżeniem można sterować za pomocą opcji Preferencje > Java > Kompilator > Błędy/ostrzeżenia > Niekompletne przypadki instrukcji „switch” w wyliczeniu. Tę opcję można rozszerzyć, wybierając nową podopcję Sygnalizuj, nawet gdy przypadek default istnieje - narzędzia JDT oznaczą wówczas instrukcje switch działające na typie wyliczeniowym, które mają wartości wyliczenia pokryte tylko przez instrukcję default, a nie bezpośrednio przez instrukcję case. Po dodaniu nowej stałej wyliczeniowej dzięki tej opcji będzie można wykryć instrukcje switch niepokrywające nowej wartości.

Ostrzeżenie o instrukcji switch z brakującą instrukcją case dla wartości wyliczeniowej nawet w przypadku obecności przypadku default

Strona preferencji błędów/ostrzeżeń kompilatora z podświetlonymi nowymi opcjami diagnostyki instrukcji switch

Drugą podopcją w tej sekcji ustawień kompilatora jest Brak przypadku default w instrukcji switch - steruje ona tym, czy narzędzia JDT oznaczą instrukcje switch z brakującym przypadkiem default, ponieważ takie instrukcje switch mogą zostać całkowicie pominięte w czasie wykonywania, gdy wystąpi nieoczekiwana wartość.

Ostrzeżenie o instrukcji switch z brakującym przypadkiem default

W przypadku takim jak powyższy ostrzeżenie pozwala też zrozumieć inny błąd związany z ostatnią instrukcją:
„Zmienna lokalna printString mogła nie zostać zainicjowana”: błąd jest zgłaszany, ponieważ klienty mogłyby wywoływać metodę print(Color) z wartością wyliczenia nieznaną w czasie kompilowania tej metody.

Nowe opcje wykrywania wycieku zasobów Kompilator może teraz wykrywać wycieki zasobów, tj. zmiennych lokalnych typu java.lang.AutoCloseable (zgodność z wersją >= 1.7) i java.io.Closeable (zgodność z wersją <= 1.6). Więcej informacji można znaleźć tutaj.

Strona Błędy/ostrzeżenia z podświetloną opcją „Wycieki zasobów”

Po włączeniu opcji Wyciek zasobów na stronie preferencji Java > Kompilator > Błędy/ostrzeżenia kompilator zgłosi błąd lub ostrzeżenie, jeśli metoda close() nie zostanie wywołana lokalnie na zasobie.

Przykład wycieku zasobów

Po włączeniu opcji Potencjalny wyciek zasobów na stronie preferencji Java > Kompilator > Błędy/ostrzeżenia kompilator zgłosi błąd lub ostrzeżenie, jeśli metoda close() nie zostanie wywołana lokalnie na zasobie we wszystkich ścieżkach wykonania.

Przykład potencjalnego wycieku zasobów

Ta analiza jest mniej agresywna, gdy zasób jest współużytkowany przez metody (często za pośrednictwem pola) i każda strona uzyskująca dostęp do zasobu może wywołać żądaną metodę close(). W niektórych przypadkach (np. przekazanie jako argument do innej metody) to ostrzeżenie będzie złagodzone do zgłoszenia jedynie potencjalnego wycieku, a w innych przypadkach (zapisanie w polu) analiza w ogóle nie będzie zgłaszać ostrzeżeń.

Oprócz tego analiza rozpoznaje pewne przypadki jako w praktyce nieistotne. Poniżej przedstawiono przykłady sytuacji, w których brak wywołania metody close() nie powoduje zgłoszenia błędu/ostrzeżenia:

  • Elementy implementujące interfejs Closeable bez zasobów, np. StringReader.

    Wyciek zasobów nie jest zgłaszany, jeśli element implementujący interfejs Closeable nie zostanie zamknięty

  • Pośrednie lub bezpośrednie opakowywanie elementów implementujących interfejs Closeable, np. BufferedReader, które nie zawierają zasobów.

    Wyciek zasobów nie jest zgłaszany, jeśli zasób opakowujący element implementujący interfejs Closeable bez zasobu nie zostanie zamknięty

  • Opakowane zasoby i potencjalne zamknięcie jednego zasobu w łańcuchu.

    Jest zgłaszany potencjalny wyciek zasobów, gdy dowolny zasób w łańcuchu opakowań jest zamykany w pewnej ścieżce wykonania.

Nowe opcje ostrzeżeń kompilatora wsadowego Są teraz dostępne dwie nowe opcje kompilatora wsadowego na potrzeby konfigurowania ostrzeżeń w czasie kompilacji:
  • Opcja -warn:all może zostać użyta do włączenia wszystkich ostrzeżeń
  • Opcja -warn:resource może zostać użyta do włączenia ostrzeżeń o wycieku zasobów
Nowe opcje ścieżki budowania do ostrzegania o nakładaniu się położenia wyjściowego folderu źródłowego na inny folder źródłowy Narzędzia JDT wyświetlają teraz błąd ścieżki budowania w przypadku nakładania się położenia wyjściowego folderu źródłowego na inny folder źródłowy. Ten błąd można skonfigurować na stronie preferencji Java > Kompilator > Budowanie > Położenie wyjściowe nakłada się na położenie źródłowe.

Błąd ścieżki budowania w przypadku nakładania się położenia wyjściowego folderu źródłowego na inny folder źródłowy

Analiza wartości NULL oparta na adnotacjach Narzędzia JDT można teraz skonfigurować do korzystania z adnotacji wartości NULL w celu wykonywania rozszerzonej analizy wartości NULL wewnątrz procedur. Tę funkcję można włączyć na stronie Preferencje > Java > Kompilator > Błędy/ostrzeżenia > Analiza wartości NULL:

Strona preferencji Błędy/ostrzeżenia z podświetloną opcją „Włącz analizę wartości NULL opartą na adnotacjach”

Korzystać można albo z domyślnych adnotacji dostarczonych w pakiecie narzędzi JDT, albo własnych adnotacji określających wartości NULL. Oprócz włączenia analizy wartości NULL adnotacje należy dodać do ścieżki budowania Java projektu. Domyślne adnotacje znajdują się w pliku JAR org.eclipse.jdt.annotation w katalogu plugins i mogą zostać użyte jako pakunek OSGi lub zwykły plik JAR.

Po włączeniu analizy wartości NULL opartej na adnotacjach narzędzia JDT wykonują nowe funkcje diagnostyczne określające wartość NULL zmiennej lub typu zwracanej wartości metody zgodnie z określonymi adnotacjami.

	public void foo(@NonNull Object o1) {¶		System.out.println(o1.toString()); // OK: o1 nie może mieć wartości NULL¶	}¶	¶	@NonNull Object bar(@Nullable String s1) {¶		foo(null); // nie można przekazać argumentu o wartości NULL¶		@NonNull String s= null; // nie można przypisać wartości NULL ¶		@NonNull String t= s1; // nie można przypisać potencjalnej wartości NULL ¶		return null; // nie można zwrócić wartości NULL¶	}

Podobną diagnostykę można wykonywać w przypadku potencjalnej przypisanej lub zwracanej wartości NULL lub nieznanego stanu wartości NULL.

Poprawność jest sprawdzana również w przypadku przesłonionych metod:

class Base {¶	@NonNull Object method(@Nullable Object o) {¶		return new Object();¶	}¶}¶¶class Sub extends Base {¶	@Override            // parametr metody musi zezwalać na wartość NULL¶	@Nullable Object method(@NonNull Object o) {¶		return new Object();¶	}¶}

Na potrzeby ustawiania globalnej wartości domyślnej elementu (pakietu, typu lub metody) stosowanej dla wszystkich znajdujących się w nim elementów można użyć adnotacji @NonNullByDefault.

@NonNullByDefault¶class MyClass {¶	// nadmiarowe adnotacje @NonNull:¶	public @NonNull Object foo(@NonNull Object o) {¶		return o;¶	}¶	¶	@NonNullByDefault(false) // anuluje wartość domyślną¶	Object bar(@NonNull Object o) {¶		return o;¶	}¶}

W wyniku dodania przez użytkownika adnotacji do sygnatur metod istniejące analizy wartości NULL wewnątrz procedur dysponują jeszcze większą ilością informacji i zwracają dokładniejsze wyniki. W poniższym przykładzie kompilator nie mógłby wartościować statusu wartości NULL parametru „obj” bez adnotacji wartości NULL (aby to ostrzeżenie było wyświetlane, opcja Nadmiarowe sprawdzanie wartości NULL musi być włączona).

public void foo(@NonNull Object obj) {¶		if (obj == null) { }¶	}

Nowe funkcje diagnostyki są sklasyfikowane w trzech kategoriach:

  • Naruszenie specyfikacji wartości NULL
    Ta opcja zwraca ostrzeżenie¶			„Niezgodność typu wartości NULL: wymagano typu '@NonNull String', ale udostępniona wartość jest określona jako @Nullable”

    W tym przypadku wartość „in” nie jest poprawną wartością zwracaną, ponieważ zawiera adnotację @Nullable w swojej deklaracji.

  • Konflikt między adnotacjami wartości NULL a ustalaniem wartości NULL
    Ta opcja zwraca ostrzeżenie¶			„Niezgodność typu wartości NULL: wymagano typu @NonNull String, ale udostępniona wartość jest ustalana jako @Nullable”

    W tym przypadku wartość „local” nie jest poprawną wartością zwracaną, ponieważ analiza przepływu dla zmiennej „local” bez adnotacji ustaliła, że może mieć ona wartość NULL w pewnej ścieżce.

  • Niesprawdzona konwersja z typu bez adnotacji do typu z adnotacją @NonNull
    Ta opcja zwraca ostrzeżenie¶			„Bezpieczeństwo typu wartości NULL: Wyrażenie typu String wymaga niesprawdzonej konwersji w celu zapewnienia zgodności z typem @NonNull String”

    W tym przypadku wartość zwracana metody „getLegacyValue()” może być zgodna/niezgodna z typem „@NonNull String”. Podobnie jak w przypadku konwersji wcześniejszego surowego typu do typu ogólnego, brakuje tutaj ważnej informacji, ponieważ wartość zwracana metody „getLegacyValue()” nie ma adnotacji @NonNull ani @Nullable.

Uwaga: To jest pierwsza wersja tej opcji. Pracujemy nad ułatwieniem jej stosowania w konfiguracjach projektów Java. Zaimplementowane opcje są kompletne i przetestowane, ale brak jest na przykład obsługi adnotacji pól lub interfejsów API zewnętrznych bibliotek. Dołączono początkowy zestaw szybkich poprawek i w przyszłości będzie on ulepszany.

Więcej informacji można też znaleźć tutaj.

Opcje kompilatora wsadowego na potrzeby korzystania z adnotacji wartości NULL Kompilator wsadowy można teraz skonfigurować do korzystania z adnotacji analizy wartości NULL, przekazując token nullAnnot(nullable|nonnull|nonnullbydefault) w opcji -warn, gdzie wartości nullable, nonnull i nonnullbydefault to w pełni kwalifikowane nazwy typów adnotacji używanych na potrzeby analizy wartości NULL. Wartość nullAnnot służy do określania domyślnych adnotacji narzędzi JDT.

Oprócz tego można korzystać z tokenu -nonNullByDefault w celu ustawienia globalnej wartości domyślnej oznaczającej brak wartości NULL po włączeniu analizy wartości NULL opartej na adnotacjach. Powoduje to traktowanie wszystkich typów w sygnaturach metody bez adnotacji wartości NULL jako określających brak wartości NULL.

Wykrywanie brakujących domyślnych adnotacji wartości NULL Aby adnotacja braku wartości NULL była domyślna sygnaturach metod typów bez adnotacji, można użyć adnotacji „@NonNullByDefault” we wszystkich pakietach. W celu zapewnienia pełnego pokrycia wszystkich pakietów można skonfigurować narzędzia JDT do wykrywania brakujących domyślnych adnotacji wartości NULL. Po włączeniu opcji Preferencje > Java > Kompilator> Błędy/ostrzeżenia > Analiza wartości NULL > Brak adnotacji „@NonNullByDefault” w pakiecie narzędzia JDT zgłoszą błąd/ostrzeżenie w następujących przypadkach:
  • Gdy pakiet nie zawiera adnotacji „@NonNullByDefault” w pliku package-info.java:

    Ostrzeżenie o braku adnotacji @NonNullByDefault w pakiecie

  • Gdy typ w pakiecie domyślnym nie zawiera domyślnej adnotacji o obecności wartości NULL.

    Ostrzeżenie o braku adnotacji @NonNullByDefault typu

Analiza wartości NULL traktuje asercję org.​eclipse.​core.​runtime.​Assert tak jak asercję Java Ponieważ pakiet org.eclipse.core.runtime.Assert jest często używany w taki sposób, jak słowo kluczowe assert języka Java, analiza wartości NULL narzędzi JDT interpretuje wyrażenie boolowskie jako mające zawsze wartość true po odwołaniu do obiektu Assert, ponieważ gdyby warunek był wartościowany do wartości false, przepływ sterowania nigdy nie przekroczyłby miejsca wywołania pakietu org.eclipse.core.runtime.Assert.

Fragment kodu prezentujący wyrażenie boolowskie przekazane do metody org.eclipse.core.runtime.Assert.isLegal(..), które jest interpretowane jako wartość true po wywołaniu

Szybsze wyszukiwanie dzięki wstępnie zbudowanym indeksom Uwaga: Ta funkcja jest przeznaczona głównie na potrzeby wtyczek implementujących własny kontener ścieżki klas, a nie dla użytkownika końcowego.

Teraz można zażądać od funkcji wyszukiwania narzędzi JDT użycia wstępnie zbudowanych indeksów zamiast generowania przez kompilator indeksów przy pierwszym dodawaniu pliku JAR do ścieżki klas. Pozwala to uniknąć indeksowania na komputerze użytkownika i szybciej wyświetlić wyniki pierwszego wyszukiwania.

Plik indeksu można określić jako atrybut ścieżki klas IClasspathAttribute.INDEX_LOCATION_ATTRIBUTE_NAME biblioteki.

Aby uzyskać więcej informacji, zobacz temat Pomoc > Podręcznik programisty wtyczek narzędzi JDT > Podręcznik programisty > Podstawowy moduł narzędzi JDT > Indeksy wyszukiwania Java.

Widoki i okna dialogowe Java

Kodowanie załączników z kodem źródłowym Teraz można określić kodowanie załączników z kodem źródłowym: w oknie Ścieżka budowania > Biblioteki > należy rozwinąć bibliotekę i wybrać opcję > Załącznik z kodem źródłowym > Edytuj...

Okno dialogowe do określania kodowania załączników z kodem źródłowym.

Podświetlenie na stronach preferencji błędów/ostrzeżeń Na stronach preferencji błędów/ostrzeżeń czasem trudno dostrzec, który element jest zaznaczony, szczególnie po otwarciu okna dialogowego za pośrednictwem przycisku „Konfiguruj istotność problemu”.

Przycisk Konfiguruj istotność problemu w podpowiedzi dotyczącej problemu edytora Java

Teraz wybrany element jest podświetlany za pomocą strzałki, a druga strzałka podświetla element pod wskaźnikiem myszy.

Podświetlanie na stronach preferencji

Podświetlenie działa też na stronach preferencji środowiska PDE i narzędzi interfejsu API.

Edytor plików właściwości

Szybka asysta na potrzeby rozpoznawania kluczy właściwości W przypadku korzystania z eksternalizowanych łańcuchów w stylu Eclipse, następująca nowa funkcja szybkiej asysty upraszcza rozpoznawanie kluczy w edytorze plików właściwości:
  • Zmień nazwę w obszarze roboczym - zmienia nazwę klucza w pliku właściwości i aktualizuje wszystkie odwołania
  • Utwórz pole w „...” - tworzy odpowiadające pole w klasie obiektu korzystającego pakunku zasobów
  • Usuń właściwość - usuwa właściwość z pliku właściwości i pole z klasy obiektu korzystającego pakunku zasobów
  • Usuń właściwości - usuwa wybrane właściwości z pliku właściwości i pola z klasy obiektu korzystającego pakunku zasobów

Debugowanie

Eksportowanie formaterów szczegółów Formatery szczegółów (używane na przykład do renderowania obiektów w widoku Zmienne) można teraz wyeksportować jako osobne preferencje. Wcześniej jedynym sposobem na udostępnienie formaterów szczegółów było wyeksportowanie wszystkich ustawień obszaru roboczego.

Formatery szczegółów w oknie dialogowym eksportowania

Opcja Pokaż monitory domyślnie włączona Domyślnym ustawieniem wyświetlania informacji monitora w widoku Debugowanie jest teraz Włączone. Ta zmiana wpływa tylko na nowe obszary robocze i nie zmienia istniejących ustawień.

Pokazywanie informacje monitora można włączyć lub wyłączyć za pomocą akcji widoku Java > Pokaż monitory w widoku Debugowanie.

Klawisze modyfikujące przełączanie punktu zatrzymania Teraz jest dostępna obsługa klawiszy modyfikujących w czasie przełączania punktu zatrzymania w edytorze Java:
  • Przytrzymanie klawisza Ctrl w czasie dwukrotnego kliknięcia (przełączania) punktu zatrzymania spowoduje wyświetlenie okna dialogowego właściwości tego punktu zatrzymania (na komputerach Mac należy użyć klawisza Command)

  • Przytrzymanie klawisza Alt w czasie dwukrotnego kliknięcia (przełączania) punktu zatrzymania spowoduje włączenie/wyłączenie tego punktu zatrzymania
Jeśli nie ma istniejącego punktu zatrzymania, następuje normalne przełączenie punktu zatrzymania, nawet gdy jest przytrzymany klawisz modyfikujący.

JUnit

JUnit 4.10 Wersja środowiska JUnit 4 dostarczona ze środowiskiem Eclipse została zaktualizowana do 4.10.