blob: c834701ae602001ea59013769d675e9920997bae [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:34:40 BST 2018 -->
<title>Overview (Execution API)</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 (Execution API)";
}
}
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><a href="org/openide/execution/package-summary.html">Package</a></li>
<li>Class</li>
<li>Use</li>
<li><a href="org/openide/execution/package-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.openide.execution 9.5.1 </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">Execution API<br/><span style='font-style:normal; font-size:medium; font-weight:normal; background-color:#ffffff;'><a href='http://wiki.netbeans.org/API_Stability#Official' target='_blank'>Official</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="&lt;a href="org/openide/execution/doc-files/api.html"&gt;Execution API&lt;/a&gt; table, listing packages, and an explanation">
<caption><span><a href="org/openide/execution/doc-files/api.html">Execution API</a></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/openide/execution/package-summary.html">org.openide.execution</a></td>
<td class="colLast">
<div class="block">NetBeans uses a small interface to describe the <em>execution</em>
of Java-based classes together with arguments.</div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="contentContainer"><a name="overview.description">
<!-- -->
</a>
<div class="block"><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 2012-1-20 with count of newer 0--><!--year ok-->
<li>Jan 20 '12 <a href="apichanges.html#NbClassLoader.no.FileStateInvalidException"><code>NbClassLoader(FileObject[], ...)</code> does not throw <code>FileStateInvalidException</code></a>
<p>
<p>
<code>NbClassLoader(FileObject[], ClassLoader, InputOutput)</code> does not throw <code>FileStateInvalidException</code> any more.
</p>
</p>
</li>
<!--Checking date 2006-7-19 with count of newer 1--><!--year ok-->
<li>Jul 19 '06 <a href="apichanges.html#automatic-request-of-engine-impl"> No need to require ExecutionEngine token anymore</a>
<p>
<p>If your module depends on <code>org.openide.execution &gt; 1.9</code> or higher
there is no need to specify that it also requires an implementation of
the API by use of <code>OpenIDE-Module-Requires: org.openide.execution.ExecutionEngine</code>,
this token will be requested automatically by the <code>org.openide.execution</code>
module itself.
</p>
</p>
</li>
<!--Checking date 2004-3-16 with count of newer 2--><!--year ok-->
<li>Mar 16 '04 <a href="apichanges.html#version-1.2">Execution of <code>Startup</code> folder removed</a>
<p>
<p>
Previously it was possible to place objects with an
<code>ExecCookie</code> into the <code>Startup</code> folder
of the system filesystem, and they would be run during
startup.
</p>
<p>
In NetBeans 4.0 there is no such cookie any more, and that
old style of execution is no longer supported. Modules may
continue to use <code>ModuleInstall.restored</code> for
startup hooks, possibly providing special modes for user
customization, but there is no generic infrastructure for
this.
</p>
</p>
</li>
<!--Checking date 2004-3-16 with count of newer 2--><!--year ok-->
<li>Mar 16 '04 <a href="apichanges.html#NbClassLoader-constructors"><code>NbClassLoader</code> constructors deprecated</a>
<p>
<p>
All of the existing constructors of
<code>NbClassLoader</code> were deprecated since they used
Filesystems to refer to the classpath; one new classpath-safe
constructor was added instead.
</p>
<p>
For similar reasons, a number of static methods in the class
were deprecated as well.
</p>
</p>
</li>
<!--Checking date 2004-3-16 with count of newer 2--><!--year ok-->
<li>Mar 16 '04 <a href="apichanges.html#split">Execution API split into deprecated and nondeprecated halves</a>
<p>
<p>
As part of the NetBeans 4.0 build system, the Execution API
was split into two halves. The first half continues to be
used as before. The second half is now deprecated and lives
in a separate module.
</p>
</p>
</li>
</ul>
<h3>Use Cases</h3>
<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-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>
<tr class="tabler">
<td>ExecutionAPI</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Official">Official</a></td><td><a name="java-ExecutionAPI"><a href="../org-openide-execution/org/openide/execution/doc-files/api.html">
.../org/openide/execution/doc-files/api.html</a>
<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>NetBeansAttrExecutor</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Private">Private</a></td><td><a name="property-NetBeansAttrExecutor"></a></td>
</tr>
<tr class="tabler">
<td>NetBeansAttrArguments</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Private">Private</a></td><td><a name="property-NetBeansAttrArguments"></a></td>
</tr>
<tr class="tabler">
<td>readOnlyAttrs</td><td>Exported</td><td><a href="http://wiki.netbeans.org/API_Stability#Private">Private</a></td><td><a name="property-readOnlyAttrs"></a></td>
</tr>
</table>
</td>
</tr>
</table>
<p></p>
<h3>Implementation Details</h3>
<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><a href="org/openide/execution/package-summary.html">Package</a></li>
<li>Class</li>
<li>Use</li>
<li><a href="org/openide/execution/package-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.openide.execution 9.5.1 </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>