Nyheter i Juno (JDT)

Här beskrivs en del av de mer intressanta och viktiga ändringarna av Java-utvecklingsverktygen för Juno-releasen av Eclipse (3.8 och 4.2). De är följande:

Se även Nytt i Java 7 för funktioner som lagts för Java 7.

Se även dokumentet Eclipse-plattformen: Nyheter, som innehåller information om ändringar av plattformen.


Java-redigerare

CamelCase i Snabbdispositionen Snabbdispositionen (Ctrl+O) och Snabbhierarkin (Ctrl+T) i Javaredigeraren hanterar nu camelCase-matchning för elementnamn, liknande dialogrutan Öppna typ och Innehållshjälp.

Snabbdispositionen med StyledText med mönstret 'gCa'

* och ? fungerar förstås.
Snabbhjälpen för att konvertera en enhanced for-loop Har du någon gång stött på en enhanced for-loop och behövt öppna Iteratorn eller loop-index? Nu kan du använda Snabbhjälp (Ctrl+1) för att konvertera loopen:

Skärmbild av Snabbhjälpen för nyckelordet 'for' i en enhanced 'for'-loop

  • Konvertering till indexerad 'for'-loop finns för uttryck av matris- och List-baserade typer.
  • Konvertering till iterator-baserad 'for'-loop finns för uttryck av typen itererbar.
Förbättrad hakparentesmatchning i Javaredigeraren Java-redigeraren hanterar nu markering av omslutande hakparenteser.

Omslutande hakparenteser

Du konfigurerar detta så här: Java> Redigerare.

Inställningar för markering av parenteser

Nu fungerar också Navigera > Gå till > Matchande hakparentes (Ctrl+Skift+P) överallt i en fil. Om något parentestecken inte är markerat markerar kommandot det närmaste slutparentestecknet. Nästa gång markeras startparentesen. Tredje gången återställs den ursprungliga markeringen.

Hittills har den matchande parentesen hittats när markören stod direkt efter parentesen. Nu hittas den matchande parentesen oavsett om markören står omedelbart före eller efter parentesen.

Matchande parenteser - exempel

Du kan hovra över en avslutande klammerparentes och se källan nära den matchande inledande klammerparentesen. Bra när du vill se början av koden i ett långt kodblock. Du får också se antalet rader i kodblocket.

Hovring, exempel 1

Bra också när du tillfälligt vill 'markera' ett kort kodblock.

Hovring, exempel 2

Javadoc-hovring visar parameterannoteringar Javadoc-hovring visar nu annoteringar för metodparametrar:

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

Filtypen '*.class without source' Den nya filtypen *.class without source kan associera en intern eller extern redigerare till klassfiler som inte har någon klass anknuten. Detta medger till exempel att man öppnar klassfilen i en dekompilator:

Skärmbild av inställningssidan 'Filassociationer'

Standardimplementationer för rättningsförslag­­­­ JDT har nu följande Standardimplementationer för rättningsförslag som kan användas för snabbhjälper och snabbfixar.
  • org.eclipse.jdt.ui.text.java.correction.ChangeCorrectionProposal
  • org.eclipse.jdt.ui.text.java.correction.CUCorrectionProposal
  • org.eclipse.jdt.ui.text.java.correction.ASTRewriteCorrectionProposal
Detta gör det lättare att implementera snabbhjälper/-rättningar i .java-filer och använda en ASTRewrite.
Innehållshjälp i package-info.java Innehållshjälp (Ctrl+mellanslag) finns nu i package-info.java för att deklarera annoteringar på paketnivå samt Javadocs.

Innehållshjälpruta för annoteringar på paketnivå i paketdeklaraioner

Java-kompilator

Ignorera fel/varningar selektivt ftån källmappar Du kan nu konfigurera JDT att ignorera valfria fel/varningar från vissa källmappar. Projektegenskaper > Java byggsökväg > Kompilator > Källa.

Sidan Java byggsökväg med 'Ignorera valfria kompileringsproblem' markerat

Om du väljer Ja kommer JDT att undertrycka fel/varningar som angetts på sidan Inställningar > Java > Kompilator > Fel/varningar. Bra för källmappar som innehåller autogenererade klasser eller tester.

Förbättrad diagnostik av ofullsändiga växelsatser JDTs analys avseende ofullständiga växelsatser är nu starkare och kan konfigureras i närmare detalj. Se här för mer information.

Kompilatorn kontrollerar nu separat två kriterier för om en växelsats ska anses komplett:

  • En växelsats för ett enum ska definiera en case-sats före vart och ett av enums konstanter
  • Varje växelsats ska, oberoende av typ, definiera ett standard-case.

Som standard varnar kompilatorn för en enum-växel där båda kriterierna bryts:

Varning vid växel för enum då standardskiftläge saknas

Varningen styrs av Inställningar > Java > Kompilator > Fel/Varningar > Ofullständiga 'switch'-skiftlägen för enum. Detta alternativ kan stärkas av det nya underalternativet Signalera även om 'default'-case finns. Då flaggar JDT växelsatser över en enum-typ som kan ha ett enum-värde som omfattas endast av en standardsats, men inte direkt av en case-sats. När nya enum-konstanter läggs till kan detta alternativ hjälpa till att upptäcka de växelsatser som inte inbegriper det nya värdet.

Varning avseende växel med saknat enum-värde trots att standardvärde finns

Inställningssidan Kompileringsfel/varningar med de nya diagnosalternativen markerade.

Ytterligare ett tillägg i samma avsnitt av kompilatorinställningarna, 'switch' saknar 'default'-case, styr om JDT ska flagga växelsatser med saknat standard-case eftersom en sådan växelsats hoppas över helt vid körning om ett oväntat värde inträffar.

Varning avseende växel med saknat standardskiftvärde

Observera att i fall som ovanstående kan varningen bidra till förståelse rörande ett annat fel i sista satsent:
"Lokal variabel printString kanske inte har initierats" rapporteras eftersom klienterna ju inte kan anropa metoden print(Color) med ett enum-värde som inte är känt när denna metod kompileras.

Nya alternativ för att hitta resursläckor Kompilatorn kan nu detektera resursläckor, dvs. lokala varaiabler av typen java.lang.AutoCloseable (compliance >= 1.7) och java.io.Closeable (compliance <= 1.6). Se här för mer information.

Sidan Fel/varningar med 'Resursläckor' markerat

När alternativet Resursläcka på sidan Java > Kompilator > Fel/varningar är valt ger kompilatorn ett fel eller en varning om metoden close() inte anropas lokalt för en resurs.

Resursläcka, exempel

När alternativet Potentiell resursläcka på sidan Java > Kompilator > Fel/varingar är valt ger kompilatorn ett fel eller en varning om metoden close() inte anropas lokalt för en resurs på alla körsökvägar.

Potentiell resursläcka, exempel

Denna analys är mindre aggressiv om en metod delas mellan metoder, kanske via ett fält där någon part som får åtkomst till resursen möjligen kan utfärda det önskade anropet close(). I vissa fall (exempel: skickade visare som argument till annan metod) kommer varningen att mjukas upp och rapportera enbart en potentiell läcka, i andra fall (lagrat i ett fält) kommer analysen att vara helt tyst.

Dessutom känner analysen igen vissa fall som oviktiga i praktiken. Exempel på fall där avsaknad av close()-anrop inte ger fel/varninar ges nedan:

  • Resurslösa implementeringsfunktioner för Closeable, t.ex. StringReader.

    ingen resursläcka rapporteras om den resurslösa implementeringsfunktionen Closeable inte är stängd.

  • Wrappande implementeringsfunktioner för Closeable, t.ex. BufferedReader, som helt enkelt wrappar en resurslös Closeable, direkt eller indirekt.

    ingen resursläcka rapporteras när den resurslösa implementeringsfunktionen Closeable inte är stängd.

  • Wrappade resurser där någon resurs i kedjan (potentiellt) är stängd.

    potentiell resursläcka rapporteras när någon resurs i kedjan av wrappande resurser stängs på någon körsökväg.

Nya varningsalternativ för batchkompilering Två nya varningsalternativ för batchkompilering finns för konfigurering av varningar vid kompileringen:
  • -warn:all aktiverar samtliga kompileringsvarninger
  • -warn:resource aktiverar varningar om resursläckor
Nytt alternativ som varnar när en källmapps utdataplats överlappar en annan källmapp. JDT ger nu ett byggsökvägsfel när en källmapps utdataplats överlappar en annan källmapp. Konfigureras på sidan Java > Kompilator> Bygga > Utdataplats överlappar källplats.

Byggsökvägsfel när en källmapps utdataplats överlappar en annan källmap

Annoteringsbaserad null-analys JDT kan nu konfigureras att använda annoteringar som anges som nullannoteringar för att utföra interprocedurell nullanalys. Aktiveras här: Inställningar > Java > Kompilator > Fel/varningar> Nullanalys:

Sidan Fel/varningar med 'Aktivera annoteringsbaserad nullanalys'

Du kan använda standardannoteringarna i JDT eller egna annoteringar som nullannoteringar. Annoteringarna ska finnas i Javas byggsökväg i projektet. Standardannoteringarna finns iorg.eclipse.jdt.annotation JAR i katalogen plugins som kan användas som OSGi-paket eller JAR.

När annoteringsbaserad nullanalys är aktiv använder JDT nya diagnostikfunktioner som baseras på nullness i en variabel eller metodreturtyp som anges av en nullannotering.

	public void foo(@NonNull Object o1) {¶		System.out.println(o1.toString()); // OK: o1 cannot be null¶	}¶	¶	@NonNull Object bar(@Nullable String s1) {¶		foo(null); // cannot pass null argument¶		@NonNull String s= null; // cannot assign null value ¶		@NonNull String t= s1; // cannot assign potentially null value ¶		return null; // cannot return null value¶	}

Liknande diagnostik används även när det värde som tilldelats/returnerats kan vara null eller har en okänd nullness.

Åsidosättande metoder kontrolleras också huruvida de är korrekta:

class Base {¶	@NonNull Object method(@Nullable Object o) {¶		return new Object();¶	}¶}¶¶class Sub extends Base {¶	@Override            // method parameter must allow null¶	@Nullable Object method(@NonNull Object o) {¶		return new Object();¶	}¶}

Du kan också använda annoteringen @NonNullByDefault för att ange ett globalt standardvärde för ett element (paket, typ, metod) för alla inneslutna element.

@NonNullByDefault¶class MyClass {¶	// redundant @NonNull annotations:¶	public @NonNull Object foo(@NonNull Object o) {¶		return o;¶	}¶	¶	@NonNullByDefault(false) // cancels the default¶	Object bar(@NonNull Object o) {¶		return o;¶	}¶}

Till följd av annotering av metodsignaturer ger intraprocedurell nullanalys ännu mer information och bättre resultat tack vare användarspecificerade annoteringar. I exemplet nedan skulle kompilatorn inte ha klarat att evaluera nullstatus för parametern 'obj' utan nullannoteringen (alternativet Redundant null-kontroll måste vara aktiverad för att se varningen).

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

Den nya diagnostiken klassificeras i tre kategorier:

  • Regelbrott mot null-specifikation
    Alternativet ger varningen ¶			'Nulltyp stämmer inte: ska vara '@NonNull String' men värdet är angett som @Nullable'

    Här är 'in' inte ett giltigt returvärde pga. annoteringen @Nullable i deklarationen.

  • Konflikt mellan null-annoteringar och null-slutsats
    Alternativet ger varningen ¶			'Nulltyp stämmer inte: ska vara '@NonNull String' men värdet beräknas som @Nullable'

    Här är 'local' ett ogiltigt returvärde eftersom flödesanalysen för den icke-annoterade variabeln 'local' beräknar att den kan vara null i någon sökväg.

  • Okontrollerad konvertering från icke-annoterad typ till @NonNull-typ
    Alternativet ger varningen¶			'Nulltypssäkerhet: Uttrycket av typen String  behöver konverteras okontrollerat för att vara i enlighet med @NonNull String'

    Här är returvärdet från 'getLegacyValue()' kanske inte kompatibelt med '@NonNull String'. På samma sätt som vid konvertering av en äldre rå typ till en generisk typ saknas även här viktig typinformation eftersom 'getLegacyValue()' inte har någon @NonNull- eller @Nullable-annotering.

Anm: Detta är den första versionen av denna funktion. Vi arbetar på att göra den enklare att använda i Java-projekt. De implementerade funktionerna är färdiga och testade, men funktionerna för annotering av fält eller APIer från tredje part saknas för närvarande. En första uppsättning snabbfixar medföljer och komemr att förbättras ytterligare i framtiden.

Se också here för bakgrundsinformation.

Batchkompilatoralternativ för användande av nullannoteringar Du kan nu konfigurera batchkompilatorn att använda annoteringar för nullanalys genom att skicka token nullAnnot(nullable|nonnull|nonnullbydefault) till alternativet -warn där nullable, nonnull och nonnullbydefault är fullständiga namn på annoteringstyperna för nullanalys. Du kan använda nullAnnot ensamt för att använda JDTs standardannoteringar.

Dessutom kan du använda token -nonNullByDefault för att globalt ha nonnull som standardvärde när annoteringsdbaserad nullanalys är igång. Detta betyder att alla typer av metodsignaturer utan nullannotering anses vara angivna som non-null.

Detektering av saknad standard-nullness-annotering För att göra non-null till standardvärde för icke-annoterade typer i metodsignaturer kan du använda annoteringen '@NonNullByDefault' på alla paket. För att säkerställa full täckning av alla paket kan du konfigurera JDT för att detektera en saknad standard-nullness-annotering. När Inställningar > Java > Kompilator > Fel/varningar > Nullanalys > Saknad '@NonNullByDefault'-annotering för paket är aktivt ger JDT ett fel-/varningsmeddelande i följande fall:
  • När ett paket inte innehåller någon '@NonNullByDefault'-annotering i package-info.java:

    Varningsmeddelandet Saknad @NonNullByDefault-annotering för paket

  • När en typ i ett standardpaket inte innehåller någon standard-nullness-annotering.

    Varningsmeddelandet Saknad @NonNullByDefault-annotering för typ

Nullanalys behandlar org.​eclipse.​core.​runtime.​-assert som Java-assert Eftersom org.eclipse.core.runtime.Assert ofta används som Java-nyckelordet assert ser JDTs nullanalys det booleska uttrycket som skickats till det förra alltid som true efter Assert-referensen eftersom om villkoret visar sig vara false kommer kontrollflödet aldrig att komma längre än till org.eclipse.core.runtime.Assert-referensen.

Kodstycke som visar att det booleska uttrycket som skickas till org.eclipse.core.runtime.Assert.isLegal(..) anses vara true efter anropet

Snabbare sökning med färdiga index Anm: Funktion främst avsedd för insticksprogram som implementerar sin egen klassökvägsbehållere, och inte för användare.

Du kan nu instruera JDT att söka med de färdiga indexen i stället för att låta kompilatorn generera indexen första gången en JAR läggs in i klassökvägen. Det förhindrar att indexering görs i användarens dator vilket ger snabbare sökresultat.

Du kan ange indexfilen som klassökvägsattribut IClasspathAttribute.INDEX_LOCATION_ATTRIBUTE_NAME för biblioteket.

Se Hjälp > Utvecklarhandbok för JDT-insticksprogram > JDT Programmerarhandbok > JDT Core > Index för Java-sökning.

Java-vyer och dialogrutor

Kodning för källbilagor Du kan nu ange kodning för källbilagor för bibliotek: Byggsökväg > Bibliotek > Expandera biblioteket > Källbilaga > Redigera

Dialogruta för att ange kodning för källbilagor.

Markera på inställningssidorna för Fel/varningar På inställningssidorna för Fel/varningar kan det vara svårt att se vad man valt, särkilt om man gått via knappen "Konfigurera allvarlighetsgrader för problem".

Konfigurera allvarlighetsgrader för problem

Nu visar en pil vad man valt och en annan pil visar objektet under musen.

Markering på inställningssidor

Markeringarna fungerar också på inställningssidorna för PDE- och API-verktygen.

Egenskapsfilsredigerare

Snabbhjälpar för omorganisering av egenskapsnycklar Om du använder externaliseade strängar av Eclipse-typ kan följande snabbhjälpar underlätta omorganisering av nycklar i Egenskapsfilsredigeraren.
  • Ändra namn i arbetsytan - byter namn på nyckeln i egenskapsfilen och uppdaterar alla referenser
  • Skapa fält i '...' - skapar motsvarande fält i åtkomstfunktionsklassen för resurspaketet
  • Ta bort egenskap - tar bort egenskapen från egenskapsfältet och fältet från åtkomstfunktionsklassen för resurspaketet
  • Ta bort egenskaper - tar bort valda egenskaper från egenskapsfältet och fälten från åtkomstfunktionsklassen för resurspaketet

Felsökning

Exportera detaljformateringsfunktion Detaljformateringsfunktioner (som t.ex. används för att rendera objekt i Variabel-vyn) kan nu exporteras som separata inställningar. Tidigare fick man lov att exportera samtliga inställningar.

Exportera detaljformateringsfunktioner

Standardinställning för visning av övervakare Standardinställning för visning av övervakningsinformation i Felsökningsvy är nu på. Ändringen berör endast nya arbetsytor och ändrar inga befintliga inställningar.

Funktionen kan slås av/på med Java > Visa övervakare i Felsökningsvyn.

Modifieringstangenter för växling av brytpunkt på/av Det finns nu funktioner för modifieringstangenter när du växlar brytpunkt på/av i Java-redigeraren:
  • Håll ned Ctrl när du dubbelklickar på en brytpunkt (växlar) så öppnas dialogrutan Egenskaper för brytpunkten (i Mac: Command)

  • Om du håller ned Alt när du dubbelklickar (växlar) aktiverer/avaktiverar du brytpunkten
Om det inte finns någon brytpunkt så sker en normal brytpunktsväxling även om du inte trycker ned någon modifieringstangent.

JUnit

JUnit 4.10 JUnit 4-versionen till Eclipse har uppdaterats till 4.10.