Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-->
<!DOCTYPE apichanges PUBLIC"-//NetBeans//DTD API changes list 1.0//EN""../../nbbuild/javadoctools/apichanges.dtd">
<apichanges>
<apidefs>
<apidef name="JavaHintsSPI">Java Hints SPI</apidef>
</apidefs>
<changes>
<change id="UsedDetector">
<api name="JavaHintsSPI"/>
<summary>Added UsedDetector SPI to mark an arbitrary elements as used</summary>
<version major="1" minor="56"/>
<date day="2" month="8" year="2023"/>
<compatibility addition="yes"/>
<description>
<p>
The SPI to mark an arbitrary element as used was added.
Allows to suppress the standard NetBeans unused element detection
and to prevent the "unused" hint being displayed on given elements.
Can be used by various framework libraries that sometimes honor
annotations (i.e. injections or bindings) even on private methods.
</p>
</description>
<class package="org.netbeans.spi.java.hints.unused" name="UsedDetector" link="no" />
</change>
<change id="openRefactoringUI">
<api name="JavaHintsSPI"/>
<summary>Added utility methods and SPI to open UI for hints</summary>
<version major="1" minor="53"/>
<date day="17" month="3" year="2021"/>
<compatibility addition="yes"/>
<description>
<p>
Internal helper method added to open refactoring UI with selected hints.
Added SPI that
can be implemented by UI module(s) to actually provide the UI implementation.
</p>
</description>
<class package="org.netbeans.modules.java.hints.spiimpl" name="HintsRefactoringFactory" link="no" />
<class package="org.netbeans.modules.java.hints.spiimpl" name="Utilities" link="no"/>
</change>
<change id="JavaFixUtilities.isPrimary">
<api name="JavaHintsSPI"/>
<summary>Added JavaFixUtilities.isPrimary() utility</summary>
<version major="1" minor="31"/>
<date day="15" month="1" year="2018"/>
<compatibility addition="yes"/>
<description>
<p>
The utility method JavaFixUtilities.isPrimary() was added.
This API checks whether a specified tree can be used in
places where a Primary expression is required.
</p>
</description>
</change>
<change id="Hint.minSourceVersion">
<api name="JavaHintsSPI"/>
<summary>Hint can specify minimum source version for operation</summary>
<version major="1" minor="28"/>
<date day="24" month="5" year="2015"/>
<author login="sdedic"/>
<compatibility addition="yes"/>
<description>
<p>
Certain hints generate source code following newer language specifications.
A hint may declare <code>minSourceVersion</code> in its <code>@Hint</code>
annotation to specify a minimum source version. Such hint will be never
invoked for files configured for earlier source level.
</p>
</description>
</change>
<change id="TriggerOptions">
<api name="JavaHintsSPI"/>
<summary>Hint can choose to trigger for guarded code</summary>
<version major="1" minor="27"/>
<date day="27" month="7" year="2015"/>
<author login="sdedic"/>
<compatibility addition="yes"/>
<description>
<p>
Hints triggered by Tree.Kind are not invoked for Trees which are
protected from editing (i.e. Form Builder guarded blocks). Hint implementor
can opt to be triggered even for such code, in order to e.g. collect
data.
</p>
</description>
</change>
<change id="EnhancedJavaFix">
<api name="JavaHintsSPI"/>
<summary>Added ability to specify sort text for JavaFix</summary>
<version major="1" minor="18"/>
<date day="14" month="7" year="2013"/>
<author login="jlahoda"/>
<compatibility addition="yes"/>
<description>
<p>
Adding to new constructors to <code>JavaFix</code> to define
the sort text for the fix.
</p>
</description>
</change>
<change id="ProjectHintsJava">
<api name="JavaHintsSPI"/>
<summary>Defining system filesystem folder for per-project Java hints customizers</summary>
<version major="1" minor="16"/>
<date day="24" month="4" year="2013"/>
<author login="jlahoda"/>
<compatibility addition="yes"/>
<description>
<p>
Defining <code>Project/hints/java-based</code> folder, where provider for
hints customizers for Java-based projects should be stored.
</p>
</description> <!-- <issue number="227959"/>-->
</change>
<change id="IntegerOption">
<api name="JavaHintsSPI"/>
<summary>Added support for integer options. Hints can be declared to appear only in inspect & transform</summary>
<version major="1" minor="14"/>
<date day="3" month="4" year="2013"/>
<author login="sdedic"/>
<compatibility addition="yes"/>
<description>
<p>
Added declarative support for integer options. <code>@IntegerOption</code> can
be used with option name field, similar to <code>@BooleanOption</code>.
</p>
<p>
An option was added to <code>Hint.Options</code>, so that hint can declare
to be only shown in Inspect & transform dialog. Useful for computation-intensive
hints, which should only run on demand.
</p>
</description>
<class package="org.netbeans.spi.java.hints" name="IntegerOption"/>
<class package="org.netbeans.spi.java.hints" name="Hint"/>
<issue number="227822"/>
<issue number="227959"/>
</change>
<change id="ErrorDescriptionFactory.forSpan">
<api name="JavaHintsSPI"/>
<summary>Introducing ErrorDescriptionFactory.forSpan.</summary>
<version major="1" minor="9"/>
<date day="19" month="12" year="2012"/>
<author login="jlahoda"/>
<compatibility addition="yes"/>
<description>
<p>
Added ErrorDescriptionFactory.forSpan to create the correct
Java-enhanced ErrorDescription from a span.
</p>
</description>
<class package="org.netbeans.spi.java.hints" name="ErrorDescriptionFactory"/>
<issue number="223723"/>
</change>
<change id="TransformationSupport">
<api name="JavaHintsSPI"/>
<summary>Added support for using jackpot patterns from other modules (e.g. refactoring).</summary>
<version major="1" minor="1"/>
<date day="29" month="3" year="2012"/>
<author login="jbecicka"/>
<compatibility addition="yes"/>
<description>
<p>
Added support for using jackpot patterns from other modules (e.g. refactoring).
</p>
</description>
<class package="org.netbeans.spi.java.hints.support" name="TransformationSupport"/>
<issue number="210262"/>
</change>
</changes>
<htmlcontents>
<head>
<title>Change History for the Java Hints SPI</title>
<link rel="stylesheet"href="prose.css"type="text/css"/>
</head>
<body>
<p class="overviewlink">
<a href="overview-summary.html">Overview</a>
</p>
<h1>Introduction</h1>
<p>This document lists changes made to the Java Hints SPI.</p>
<!-- The actual lists of changes, as summaries and details: -->
<hr/>
<standard-changelists module-code-name="$codebase"/>
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.
