blob: 6aea8ccabbdc4cead8fd6d51641886f02ae42bdd [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (1.8.0_181) on Fri Sep 14 11:38:53 BST 2018 -->
<title>Overview (Java Source)</title>
<meta name="date" content="2018-09-14">
<link rel="stylesheet" type="text/css" href="javadoc.css" title="Style">
<script type="text/javascript" src="script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="Overview (Java Source)";
}
}
catch(err) {
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li class="navBarCell1Rev">Overview</li>
<li>Package</li>
<li>Class</li>
<li>Use</li>
<li><a href="overview-tree.html">Tree</a></li>
<li><a href="deprecated-list.html">Deprecated</a></li>
<li><a href="index-files/index-1.html">Index</a></li>
<li><a href="help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage">org.netbeans.modules.java.source 0.166.1 32</div>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev</li>
<li>Next</li>
</ul>
<ul class="navList">
<li><a href="index.html?overview-summary.html" target="_top">Frames</a></li>
<li><a href="overview-summary.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<div class="header">
<h1 class="title">Java Source<br/><span style='font-style:normal; font-size:medium; font-weight:normal; background-color:#e0a0a0;'><a href='http://wiki.netbeans.org/API_Stability#Friend' target='_blank'>Friend, Private or Third Party</a></span></h1>
</div>
<div class="header">
<p>See: <a href="#overview.description">Description</a></p>
</div>
<div class="contentContainer">
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Java Source table, listing packages, and an explanation">
<caption><span>Java Source</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Package</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor">
<td class="colFirst"><a href="org/netbeans/api/java/loaders/package-summary.html">org.netbeans.api.java.loaders</a></td>
<td class="colLast">&nbsp;</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="org/netbeans/api/java/source/package-summary.html">org.netbeans.api.java.source</a></td>
<td class="colLast">&nbsp;</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="org/netbeans/api/java/source/support/package-summary.html">org.netbeans.api.java.source.support</a></td>
<td class="colLast">&nbsp;</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="org/netbeans/spi/java/loaders/package-summary.html">org.netbeans.spi.java.loaders</a></td>
<td class="colLast">&nbsp;</td>
</tr>
</tbody>
</table>
</div>
<div class="contentContainer"><a name="overview.description">
<!-- -->
</a>
<div class="block"><p>
<p>
Provides Java Model API access.
ensure.built.source.roots
When the <code>ensure.built.source.roots</code> property is set during ant script execution,
the <code>javac</code> task will not actually build the classfiles from scratch, but rather copy classfiles
produced by the Java infrastructure into the output folder. The content of the property will
be interpreted as list of source roots, for which the artifacts should be copied.
</p>
</p>
<h3>What is New (see <a href="apichanges.html">all changes</a>)?</h3>
<ul>
<!--Search for dates that are later or equal to 1997-09-01 in
.-->
<!--Checking date 2014-7-15 with count of newer 0--><!--year ok-->
<li>Jul 15 '14 <a href="apichanges.html#RemoteJavadocPolicy">Added a possibility to specify remote javadoc handling policy</a>
<p>
Added a possibility to specify remote javadoc handling policy in <code>JavadocHelper</code>
</p>
</li>
<!--Checking date 2014-7-10 with count of newer 1--><!--year ok-->
<li>Jul 10 '14 <a href="apichanges.html#nodeReplacemenHints">Added API to preserve comments and whitespaces in transformations</a>
<p>
If a transformation moves a Tree node elsewhere, or produces a replacement of it, it can now mark the new tree as a 'replacement' for the old one,
which causes whitespaces (most notably comments) to attach to the replacement node.
</p>
</li>
<!--Checking date 2014-4-30 with count of newer 2--><!--year ok-->
<li>Apr 30 '14 <a href="apichanges.html#server.is.free">Desktop independent parts of the Java Source module extracted</a>
<p>
<p>
Runtime compatibility remains, compile time compatibility is
mostly preserved too. It is however recommended to upgrade
dependencies of client modules. Try running
<code>ant fix-dependencies</code> in your Ant module.
</p>
</p>
</li>
<!--Checking date 2014-4-14 with count of newer 3--><!--year ok-->
<li>Apr 14 '14 <a href="apichanges.html#newUtilityMethods">Added couple of new utility methods to TreeUtilities, ElementUtilities, and SourceUtils.</a>
<p>
Added new utility methods getPathElementOfKind and getUninitializedFields to TreeUtilities.
Added new utility methods getElementName, findOverridableMethods, hasGetter and hasSetter to ElementUtilities.
Added new utility methods resolveCapturedType and getForwardReferences to SourceUtils.
</p>
</li>
<!--Checking date 2013-11-19 with count of newer 4--><!--year ok-->
<li>Nov 19 '13 <a href="apichanges.html#findLabelSpan">Added utility methods to find span of a Label's name in the source.</a>
<p>
Added utility methods to find span of a Label's name in the source.
Returns starting and ending offset of the label's name in the source code that was parsed
(ie. CompilationInfo.getText()), which may differ from the positions in the source
document if it has been already altered.
</p>
</li>
<!--Checking date 2013-8-20 with count of newer 5--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2013-5-27 with count of newer 6--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2013-5-16 with count of newer 7--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2013-5-3 with count of newer 8--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2013-4-30 with count of newer 9--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2013-4-12 with count of newer 10--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2013-3-22 with count of newer 11--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2013-2-28 with count of newer 12--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2013-2-13 with count of newer 13--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-12-31 with count of newer 14--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-4-11 with count of newer 15--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-4-5 with count of newer 16--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-3-13 with count of newer 17--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-3-13 with count of newer 17--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-3-13 with count of newer 17--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-2-21 with count of newer 20--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-1-26 with count of newer 21--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2012-1-26 with count of newer 21--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-11-30 with count of newer 23--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-11-7 with count of newer 24--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-10-26 with count of newer 25--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-10-20 with count of newer 26--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-8-29 with count of newer 27--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-8-26 with count of newer 28--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-8-1 with count of newer 29--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-7-13 with count of newer 30--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-6-22 with count of newer 31--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-6-1 with count of newer 32--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-4-26 with count of newer 33--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2011-1-21 with count of newer 34--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-12-10 with count of newer 35--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-11-12 with count of newer 36--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-10-12 with count of newer 37--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-9-27 with count of newer 38--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-9-16 with count of newer 39--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-9-8 with count of newer 40--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-7-13 with count of newer 41--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-3-2 with count of newer 42--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2010-2-24 with count of newer 43--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2009-10-27 with count of newer 44--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2009-8-14 with count of newer 45--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2009-8-12 with count of newer 46--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2009-8-6 with count of newer 47--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2009-5-7 with count of newer 48--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2009-3-31 with count of newer 49--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2008-11-24 with count of newer 50--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2008-8-13 with count of newer 51--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2008-7-7 with count of newer 52--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2008-6-25 with count of newer 53--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2008-5-6 with count of newer 54--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2008-3-25 with count of newer 55--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2008-3-15 with count of newer 56--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2008-1-25 with count of newer 57--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-12-21 with count of newer 58--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-12-14 with count of newer 59--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-11-26 with count of newer 60--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-6-15 with count of newer 61--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-6-15 with count of newer 61--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-6-15 with count of newer 61--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-6-15 with count of newer 61--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-6-13 with count of newer 65--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-6-5 with count of newer 66--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-4-24 with count of newer 67--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-4-19 with count of newer 68--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-4-13 with count of newer 69--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-4-4 with count of newer 70--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-3-26 with count of newer 71--><!--Skipped as the amount of changes is too big-->
<!--Checking date 2007-3-18 with count of newer 72--><!--Skipped as the amount of changes is too big-->
</ul>
<h3>Use Cases</h3>
<answer id="arch-usecases">
<p>
XXX no answer for arch-usecases
</p>
</answer>
<h3>Exported Interfaces</h3>
This table lists all of the module exported APIs
with
defined stability classifications. It is generated
based on answers to questions about the architecture
of the module. <a href="architecture-summary.html">Read them all</a>...
<a name="group-systemproperty">
<h5>Group of systemproperty interfaces</h5>
</a>
<table cellpadding="1" cellspacing="0" border="0" class="tablebg" width="100%">
<tr>
<td>
<table border="0" cellpadding="3" cellspacing="1" width="100%">
<tr class="tablersh">
<td align="CENTER" width="25%"><span class="titlectable">Interface Name</span></td><td align="CENTER" width="10%"><span class="titlectable">In/Out</span></td><td align="CENTER" width="10%"><span class="titlectable">Stability</span></td><td align="CENTER"><span class="titlectable">Specified in What Document?</span></td>
</tr>
<tr class="tabler">
<td>ensure.built.source.roots</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Devel">Under Development</a></td><td><a name="systemproperty-ensure.built.source.roots">
<p></p>
When the <code>ensure.built.source.roots</code> property is set during ant script execution,
the <code>javac</code> task will not actually build the classfiles from scratch, but rather copy classfiles
produced by the Java infrastructure into the output folder. The content of the property will
be interpreted as list of source roots, for which the artifacts should be copied.
<p></p>
</a></td>
</tr>
</table>
</td>
</tr>
</table>
<p></p>
<a name="group-java">
<h5>Group of java interfaces</h5>
</a>
<table cellpadding="1" cellspacing="0" border="0" class="tablebg" width="100%">
<tr>
<td>
<table border="0" cellpadding="3" cellspacing="1" width="100%">
<tr class="tablersh">
<td align="CENTER" width="25%"><span class="titlectable">Interface Name</span></td><td align="CENTER" width="10%"><span class="titlectable">In/Out</span></td><td align="CENTER" width="10%"><span class="titlectable">Stability</span></td><td align="CENTER"><span class="titlectable">Specified in What Document?</span></td>
</tr>
</table>
</td>
</tr>
</table>
<p></p>
<a name="group-lookup">
<h5>Group of lookup interfaces</h5>
</a>
<table cellpadding="1" cellspacing="0" border="0" class="tablebg" width="100%">
<tr>
<td>
<table border="0" cellpadding="3" cellspacing="1" width="100%">
<tr class="tablersh">
<td align="CENTER" width="25%"><span class="titlectable">Interface Name</span></td><td align="CENTER" width="10%"><span class="titlectable">In/Out</span></td><td align="CENTER" width="10%"><span class="titlectable">Stability</span></td><td align="CENTER"><span class="titlectable">Specified in What Document?</span></td>
</tr>
<tr class="tabler">
<td>org.openide.loaders.CreateFromTemplateAttributesProvider</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Official">Official</a></td><td><a name="lookup-org.openide.loaders.CreateFromTemplateAttributesProvider">
<p></p>
Attributes provider is registered in <code>META-INF/services</code>. It provides
<code>package</code>, <code>javaSourceLevel</code> and <code>java15style</code> attributes for java templates using scripting support.
<p></p>
</a></td>
</tr>
</table>
</td>
</tr>
</table>
<p></p>
<a name="group-property">
<h5>Group of property interfaces</h5>
</a>
<table cellpadding="1" cellspacing="0" border="0" class="tablebg" width="100%">
<tr>
<td>
<table border="0" cellpadding="3" cellspacing="1" width="100%">
<tr class="tablersh">
<td align="CENTER" width="25%"><span class="titlectable">Interface Name</span></td><td align="CENTER" width="10%"><span class="titlectable">In/Out</span></td><td align="CENTER" width="10%"><span class="titlectable">Stability</span></td><td align="CENTER"><span class="titlectable">Specified in What Document?</span></td>
</tr>
<tr class="tabler">
<td>package</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Official">Official</a></td><td><a name="property-package">
<p></p>
<code>package</code> attribute contains java package as <code>String</code> for newly created
templates using scripting.
<p></p>
</a></td>
</tr>
<tr class="tabler">
<td>javaSourceLevel</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Official">Official</a></td><td><a name="property-javaSourceLevel">
<p></p>
<code>javaSourceLevel</code> attribute contains java source level as <code>String</code> (e.g. "1.5") for newly created
templates using scripting.
<p></p>
</a></td>
</tr>
<tr class="tabler">
<td>java15style</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Official">Official</a></td><td><a name="property-java15style">
<p></p>
<code>java15style</code> attribute is defined for newly created
templates using scripting only if java source level is 1.5 or later.
Useful to conditionally generate code with java 1.5 features (generics, annotations, etc.).
<p></p>
</a></td>
</tr>
</table>
</td>
</tr>
</table>
<p></p>
<h3>Implementation Details</h3>
<h5>Where are the sources for the module?</h5>
<p>
<p>
The sources for the module are in the
<a href="http://hg.netbeans.org/" shape="rect">NetBeans Mercurial repositories</a>.
</p>
</p>
<h5>What do other modules need to do to declare a dependency on this one, in addition to or instead of a plain module dependency?</h5>
<p>
XXX no answer for deploy-dependencies
</p>
<p>
Read more about the implementation in the <a href="architecture-summary.html">answers to
architecture questions</a>.
</p></div>
</div>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li class="navBarCell1Rev">Overview</li>
<li>Package</li>
<li>Class</li>
<li>Use</li>
<li><a href="overview-tree.html">Tree</a></li>
<li><a href="deprecated-list.html">Deprecated</a></li>
<li><a href="index-files/index-1.html">Index</a></li>
<li><a href="help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage">org.netbeans.modules.java.source 0.166.1 32</div>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev</li>
<li>Next</li>
</ul>
<ul class="navList">
<li><a href="index.html?overview-summary.html" target="_top">Frames</a></li>
<li><a href="overview-summary.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small><span class="footnote">Built on September 14 2018.&nbsp;&nbsp;|&nbsp;&nbsp; Copyright &#169; 2017-2018 Apache Software Foundation. All Rights Reserved.</span></small></p>
</body>
</html>