blob: a9b8674e4e302f2966470c89de0e21991871f9dc [file] [log] [blame]
<html>
<!-- Generated from apichanges.xml -->
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Change History for the Java SE Projects API</title>
<link rel="stylesheet" href="prose.css" type="text/css">
</head>
<body>
<p class="overviewlink">
<a href="overview-summary.html" shape="rect">Overview</a>
</p>
<h1>Introduction</h1>
<p>This document lists changes made to the <a href="overview-summary.html" shape="rect">Java SE Projects API</a>.</p>
<!-- The actual lists of changes, as summaries and details: -->
<hr>
<h1>
<a name="list-all-apis">Index of APIs</a>
</h1>
<ul>
<li>
<a href="#jseprojects">Java SE Projects API</a>
</li>
</ul>
<h1>
<a name="incompat-by-date">Incompatible changes by date</a>
</h1>
<p>Fuller descriptions of all changes can be found below (follow links).</p>
<p>Not all deprecations are listed here, assuming that the deprecated
APIs continue to essentially work. For a full deprecation list, please
consult the
<a href="deprecated-list.html">Javadoc</a>.</p>
<ul></ul>
<h1>
<a name="all-by-date">All changes by date</a>
</h1>
<ul>
<li>(Oct 4 '16) <a href="#J2SEProjectBuilder-DefaultModuleProperties">Added a method to create default module properties</a>
</li>
<li>(Sep 24 '13) <a href="#J2SEBuildPropertiesProvider">Added SPI to allow J2SE Project extensions to supply additional build properties</a>
</li>
<li>(Sep 24 '13) <a href="#J2SERuntimePlatformProvider">Added SPI to allow J2SE Project extensions to provide allowed runtime java platforms</a>
</li>
<li>(May 2 '13) <a href="#J2SEProjectPlatform">Added API to allow J2SE Project extension to get and set active project platform</a>
</li>
<li>(Mar 21 '13) <a href="#J2SECategoryExtensionProvider"></a>
</li>
<li>(Feb 25 '13) <a href="#GeneratedFilesInterceptor"></a>
</li>
<li>(Aug 17 '11) <a href="#issue-200691">Enable correct handling of properties in Project Property dialog of an extension of JSE Project</a>
</li>
<li>(Aug 17 '11) <a href="#issue-200704">Enable extending existing JSE Project category panels in Project Properties dialog</a>
</li>
<li>(Jan 4 '07) <a href="#issue-89457">Added class for accessing PropertyEvaluator for given JSE Project</a>
</li>
</ul>
<h1>
<a name="all-by-version">Changes by version</a>
</h1>
<p>
These API specification versions may be used to indicate that a module
requires a certain API feature in order to function. For example, if you
see here a feature you need which is labelled <samp>1.20</samp>, your
manifest should contain in its main attributes the line:
</p>
<pre>OpenIDE-Module-Module-Dependencies: org.netbeans.modules.java.j2seproject/1 &gt; 1.20</pre>
<ul>
<li>
(1.85) <a href="#J2SEProjectBuilder-DefaultModuleProperties">Added a method to create default module properties</a>
</li>
<li>
(1.71) <a href="#J2SEBuildPropertiesProvider">Added SPI to allow J2SE Project extensions to supply additional build properties</a>
</li>
<li>
(1.70) <a href="#J2SERuntimePlatformProvider">Added SPI to allow J2SE Project extensions to provide allowed runtime java platforms</a>
</li>
<li>
(1.63) <a href="#J2SEProjectPlatform">Added API to allow J2SE Project extension to get and set active project platform</a>
</li>
<li>
(1.60) <a href="#J2SECategoryExtensionProvider"></a>
</li>
<li>
(1.58) <a href="#GeneratedFilesInterceptor"></a>
</li>
<li>
(1.46) <a href="#issue-200691">Enable correct handling of properties in Project Property dialog of an extension of JSE Project</a>
</li>
<li>
(1.46) <a href="#issue-200704">Enable extending existing JSE Project category panels in Project Properties dialog</a>
</li>
<li>
(1.10) <a href="#issue-89457">Added class for accessing PropertyEvaluator for given JSE Project</a>
</li>
</ul>
<h1>
<a name="all-by-class">Changes by affected class</a>
</h1>
<h2>
<a name="org.netbeans.modules.java.j2seproject.api.J2SEBuildPropertiesProvider"><code><span style="color:gray">org.netbeans.modules.java.j2seproject.api.</span>J2SEBuildPropertiesProvider</code></a>
</h2><ul><li>(Sep 24 '13) <a href="#J2SEBuildPropertiesProvider">Added SPI to allow J2SE Project extensions to supply additional build properties</a>
</li></ul><h2>
<a name="org.netbeans.modules.java.j2seproject.api.J2SECategoryExtensionProvider"><code><span style="color:gray">org.netbeans.modules.java.j2seproject.api.</span>J2SECategoryExtensionProvider</code></a>
</h2><ul><li>(Mar 21 '13) <a href="#J2SECategoryExtensionProvider"></a>
</li>
<li>(Aug 17 '11) <a href="#issue-200704">Enable extending existing JSE Project category panels in Project Properties dialog</a>
</li></ul><h2>
<a name="org.netbeans.modules.java.j2seproject.api.J2SECustomPropertySaver"><code><span style="color:gray">org.netbeans.modules.java.j2seproject.api.</span>J2SECustomPropertySaver</code></a>
</h2><ul><li>(Aug 17 '11) <a href="#issue-200691">Enable correct handling of properties in Project Property dialog of an extension of JSE Project</a>
</li></ul><h2>
<a name="org.netbeans.modules.java.j2seproject.api.J2SEProjectBuilder"><code><span style="color:gray">org.netbeans.modules.java.j2seproject.api.</span>J2SEProjectBuilder</code></a>
</h2><ul><li>(Oct 4 '16) <a href="#J2SEProjectBuilder-DefaultModuleProperties">Added a method to create default module properties</a>
</li></ul><h2>
<a name="org.netbeans.modules.java.j2seproject.api.J2SEProjectPlatform"><code><span style="color:gray">org.netbeans.modules.java.j2seproject.api.</span>J2SEProjectPlatform</code></a>
</h2><ul><li>(May 2 '13) <a href="#J2SEProjectPlatform">Added API to allow J2SE Project extension to get and set active project platform</a>
</li></ul><h2>
<a name="org.netbeans.modules.java.j2seproject.api.J2SEPropertyEvaluator"><code><span style="color:gray">org.netbeans.modules.java.j2seproject.api.</span>J2SEPropertyEvaluator</code></a>
</h2><ul><li>(Jan 4 '07) <a href="#issue-89457">Added class for accessing PropertyEvaluator for given JSE Project</a>
</li></ul><h2>
<a name="org.netbeans.modules.java.j2seproject.api.J2SERuntimePlatformProvider"><code><span style="color:gray">org.netbeans.modules.java.j2seproject.api.</span>J2SERuntimePlatformProvider</code></a>
</h2><ul><li>(Sep 24 '13) <a href="#J2SERuntimePlatformProvider">Added SPI to allow J2SE Project extensions to provide allowed runtime java platforms</a>
</li></ul><hr>
<h1>
<a name="details-by-api">Details of all changes by API and date</a>
</h1>
<hr style="width:50%">
<h2>
<a name="jseprojects">Java SE Projects API</a>
</h2>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="J2SEProjectBuilder-DefaultModuleProperties">Added a method to create default module properties</a>
</h3>
<em>Oct 4 '16; API spec. version: 1.85; affected top-level classes: <a href="./org/netbeans/modules/java/j2seproject/api/J2SEProjectBuilder.html"><code>J2SEProjectBuilder</code></a>; made by: tzezula</em>
<br>
Added a method into the <code>J2SEProjectBuilder</code> to create default module properties for J2SEProject.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="J2SEBuildPropertiesProvider">Added SPI to allow J2SE Project extensions to supply additional build properties</a>
</h3>
<em>Sep 24 '13; API spec. version: 1.71; affected top-level classes: <a href="./org/netbeans/modules/java/j2seproject/api/J2SEBuildPropertiesProvider.html"><code>J2SEBuildPropertiesProvider</code></a>; made by: tzezula</em>
<br>
Added SPI to allow J2SE Project extensions to supply additional build properties.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="J2SERuntimePlatformProvider">Added SPI to allow J2SE Project extensions to provide allowed runtime java platforms</a>
</h3>
<em>Sep 24 '13; API spec. version: 1.70; affected top-level classes: <a href="./org/netbeans/modules/java/j2seproject/api/J2SERuntimePlatformProvider.html"><code>J2SERuntimePlatformProvider</code></a>; made by: tzezula</em>
<br>
Added J2SERuntimePlatformProvider SPI to allow J2SE Project extensions to provide allowed runtime java platforms
to J2SE Project customizer.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="J2SEProjectPlatform">Added API to allow J2SE Project extension to get and set active project platform</a>
</h3>
<em>May 2 '13; API spec. version: 1.63; affected top-level classes: <a href="./org/netbeans/modules/java/j2seproject/api/J2SEProjectPlatform.html"><code>J2SEProjectPlatform</code></a>; made by: tzezula; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=229085">
#229085</a></em>
<br>
Added a new friend API to allow J2SE Project extension to obtain and set active project platform.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="J2SECategoryExtensionProvider"></a>
</h3>
<em>Mar 21 '13; API spec. version: 1.60; affected top-level classes: <a href="./org/netbeans/modules/java/j2seproject/api/J2SECategoryExtensionProvider.html"><code>J2SECategoryExtensionProvider</code></a>; made by: psomol; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=218422">
#218422</a></em>
<br>
<code>J2SECategoryExtensionProvider</code> so far restricted the possibility to extend
panels in Project Properties dialog to Run and Package panels only. Now it is possible
to extend also Application panel.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="GeneratedFilesInterceptor"></a>
</h3>
<em>Feb 25 '13; API spec. version: 1.58; made by: tzezula; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=226433">
#226433</a></em>
<br>
The J2SEProject calls all the instances of the <code>GeneratedFilesInterceptor</code>
registered in the project <code>Lookup</code> when a a build script file has been updated
or created.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="issue-200691">Enable correct handling of properties in Project Property dialog of an extension of JSE Project</a>
</h3>
<em>Aug 17 '11; API spec. version: 1.46; affected top-level classes: <a href="./org/netbeans/modules/java/j2seproject/api/J2SECustomPropertySaver.html"><code>J2SECustomPropertySaver</code></a>; made by: psomol; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=200691">
#200691</a></em>
<br>
Added interface <code>J2SECustomPropertySaver</code> with method <code>save()</code>
to enable correct saving of properties added by JSE Project extending modules.
If a JSE Project extending module adds/modifies panels in Project Property
panels, then a mechanism is needed to ensure that all user-modified properties
are correctly stored in project.properties and private.properties when OK pressed.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="issue-200704">Enable extending existing JSE Project category panels in Project Properties dialog</a>
</h3>
<em>Aug 17 '11; API spec. version: 1.46; affected top-level classes: <a href="./org/netbeans/modules/java/j2seproject/api/J2SECategoryExtensionProvider.html"><code>J2SECategoryExtensionProvider</code></a>; made by: psomol; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=200704">
#200704</a></em>
<br>
Replace the existing <code>J2SERunConfigProvider</code> interface by
<code>J2SECategoryExtensionProvider</code>. The old interface was hardwired
to enable extension of Run panel only with one extension panel only. The
new interface provides this mechanism for any category and allows
multiple extension panels per category. The new functionality is needed
for JavaFX 2.0 support module, but is not limited to it.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="issue-89457">Added class for accessing PropertyEvaluator for given JSE Project</a>
</h3>
<em>Jan 4 '07; API spec. version: 1.10; affected top-level classes: <a href="./org/netbeans/modules/java/j2seproject/api/J2SEPropertyEvaluator.html"><code>J2SEPropertyEvaluator</code></a>; made by: mkubec; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=89457">
#89457</a></em>
<br>
Added class <code>J2SEPropertyEvaluator</code> with method <code>evaluator()</code> for
accessing PropertyEvaluator for given JSE Project. PropertyEvaluator resolves property
values for properties defined in project.properties and private.properties.
<hr>
<p><span class="footnote">Built on September 14 2018.&nbsp;&nbsp;|&nbsp;&nbsp; Copyright &#169; 2017-2018 Apache Software Foundation. All Rights Reserved.</span></p>
</body>
</html>