blob: 3519fc51d8e5f0bf682dddb6973017156fff1497 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
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
http://www.apache.org/licenses/LICENSE-2.0
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.
-->
<?xml-stylesheet type="text/xml" href="../../nbbuild/javadoctools/apichanges.xsl"?>
<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../../nbbuild/javadoctools/apichanges.dtd">
<!--
INFO FOR PEOPLE ADDING CHANGES:
Check the DTD (apichanges.dtd) for details on the syntax. You do not
need to regenerate the HTML, as this is part of Javadoc generation; just
change the XML. Rough syntax of a change (several parts optional):
<change>
<api name="compiler"/>
<summary>Some brief description here, can use <b>XHTML</b></summary>
<version major="1" minor="99"/>
<date day="13" month="6" year="2001"/>
<author login="jrhacker"/>
<compatibility addition="yes"/>
<description>
The main description of the change here.
Again can use full <b>XHTML</b> as needed.
</description>
<class package="org.openide.compiler" name="DoWhatIWantCompiler"/>
<issue number="14309"/>
</change>
Also permitted elements: <package>, <branch>. <version> is API spec
version, recommended for all new changes. <compatibility> should say
if things were added/modified/deprecated/etc. and give all information
related to upgrading old code. List affected top-level classes and
link to issue numbers if applicable. See the DTD for more details.
Changes need not be in any particular order, they are sorted in various
ways by the stylesheet anyway.
Dates are assumed to mean "on the trunk". If you *also* make the same
change on a stabilization branch, use the <branch> tag to indicate this
and explain why the change was made on a branch in the <description>.
Please only change this file on the trunk! Rather: you can change it
on branches if you want, but these changes will be ignored; only the
trunk version of this file is important.
Deprecations do not count as incompatible, assuming that code using the
deprecated calls continues to see their documented behavior. But do
specify deprecation="yes" in <compatibility>.
This file is not a replacement for Javadoc: it is intended to list changes,
not describe the complete current behavior, for which ordinary documentation
is the proper place.
-->
<apichanges>
<!-- First, a list of API names you may use: -->
<apidefs>
<apidef name="j2eeserver">J2EE Server API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.plugins -->
<apidef name="plugins">Server Integration Plugin API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.devmodules -->
<apidef name="devmodules">J2EE Module Development API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.common -->
<apidef name="common">J2EE Server Common API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.profiler -->
<apidef name="profiler">J2EE Server Common API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.plugins.spi.support -->
<apidef name="support">Server Integration Plugin SPI Support</apidef>
</apidefs>
<!-- ACTUAL CHANGES BEGIN HERE: -->
<changes>
<change id="profileAndDebuggingInfo">
<api name="devmodules"/>
<summary>
Public API to ask the server about profile and debug support.
</summary>
<version major="1" minor="103"/>
<date day="21" month="8" year="2013"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Provides additional methods to query for support for debugging and profiling.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<issue number="202587"/>
</change>
<change id="beforeDeploymentHook">
<api name="devmodules"/>
<summary>
Provide a way to execute custom code just before actual deployment.
</summary>
<version major="1" minor="102"/>
<date day="16" month="8" year="2013"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Additional Callable parameter allows execution of
custom code just before the actual deployment.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<issue number="234194"/>
</change>
<!-- not used for 7.3
<change id="deployOnSaveListeners">
<api name="devmodules"/>
<summary>
Allows listening for deploy on save operations.
</summary>
<version major="1" minor="91"/>
<date day="1" month="2" year="2012"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Client can add/remove listeners which will be notified on
deploy on save event.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<issue number="207724"/>
</change> -->
<change id="commonServerBridge">
<api name="j2eeserver"/>
<summary>
Added CommonServerBridge utility class to provide mapping of
instance url to common api server instance.
</summary>
<version major="1" minor="88"/>
<date day="13" month="1" year="2012"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added CommonServerBridge utility class to provide mapping of
instance url to common api server instance.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="CommonServerBridge"/>
</change>
<change id="nonPersistentServer">
<api name="j2eeserver"/>
<summary>
Adds helper method to create server instance which is not persistent.
</summary>
<version major="1" minor="83"/>
<date day="24" month="8" year="2011"/>
<author login="dkonecny"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Adds helper method to create server instance which is not persistent.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
</change>
<change id="allowInstanceSpecificModuleConfiguration">
<api name="plugins"/>
<summary>
Adds ModuleConfigurationFactory2 which can use the knowledge
of the server instance id to create the ModuleConfiguration.
</summary>
<version major="1" minor="74"/>
<date day="20" month="12" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The ModuleConfiguration2 enhance the old ModuleConfiguration
with new method to which the server instance id is passed
in addition to J2eeModule. The creation code can be more
instance specific.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ModuleConfigurationFactory2"/>
<issue number="193255"/>
</change>
<change id="disableDeployOnSave">
<api name="plugins"/>
<summary>
Method to disable Deploy part of Deploy on Save and performing only
Compile on Save.
</summary>
<version major="1" minor="73"/>
<date day="19" month="11" year="2010"/>
<author login="dkonecny"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
In order to support JRebel and similar technologies it is
desirable to be able to turn on Compile on Save but disable
Deploy on Save. That is achieved by newly introduced method.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<issue number="188361"/>
</change>
<change id="platformRoots">
<api name="plugins"/>
<summary>
Methods to obtain server, domain and middleware home.
</summary>
<version major="1" minor="72"/>
<date day="27" month="10" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
So far there was just J2eePlatform.getPlatformRoots() with unclear
semantics. Now there are explicit getServerHome(), getDomainHome()
and getMiddlewareHome() methods in the API. The corresponding SPI
has been added - J2eePlatformImpl2.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="J2eePlatformImpl2"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
<issue number="190387"/>
</change>
<change id="required-librariers">
<api name="plugins"/>
<summary>
Implement support for deployment of standalone EE modules.
</summary>
<version major="1" minor="70"/>
<date day="2" month="8" year="2010"/>
<author login="dkonecny"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Implemented both SPI and API for communication of requires libraries
from EE module to deployment server.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="DeploymentContext"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="DeploymentManager2"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="IncrementalDeployment2"/>
<issue number="186331"/>
</change>
<change id="deploymentDescriptorConfiguration">
<api name="j2eeserver"/>
<summary>
Added SPI interface through which plugin may indicate it requires
deployment descriptor.
</summary>
<version major="1" minor="69"/>
<date day="28" month="7" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The SPI interface DeploymentDescriptorConfiguration may be
implemented by the server plugin in order to indicate the
server needs deployment descriptor.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="DeploymentDescriptorConfiguration"/>
<issue number="189012"/>
</change>
<change id="serverLibraries">
<summary>
Implemented support for handling the server libraries.
</summary>
<version major="1" minor="68"/>
<date day="9" month="6" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Implemented both SPI and API to provide support for server
libraries management.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="Version"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ServerLibrary"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ServerLibraryDependency"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerLibraryFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerLibraryImplementation"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerLibraryManager"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ServerLibraryConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.support" name="ProxyOptionalFactory"/>
<issue number="182282"/>
</change>
<change id="optionalFactoryProxy">
<api name="support"/>
<summary>
Added class proxying the OptionalDeploymentManagerFactory and adding
the optional noInitializationFinish attribute.
</summary>
<version major="1" minor="66"/>
<date day="25" month="2" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added class ProxyOptionalFactory which delegates all calls
to configured delegate. Via noInitializationFinish it
is possible to supress finishInitialization() method when
it is not required by the plugin.
</p>
<p>
Designed to be used from XML Layer.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.support" name="ProxyOptionalFactory"/>
<issue number="180893"/>
</change>
<change id="deploymentFactoryProxy">
<api name="support"/>
<summary>
Added class proxying the DeploymentFactory and adding
the optional urlPattern attribute.
</summary>
<version major="1" minor="65"/>
<date day="22" month="2" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added class ProxyDeploymentFactory which delegates all calls
to configured delegate. Via urlPattern it is possible to do
precheck of server instance uri. The uri has to mach the pattern
otherwise the instance is rejected as not supported but
the factory.
</p>
<p>
Designed to be used from XML Layer.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.support" name="ProxyDeploymentFactory"/>
<issue number="148177"/>
</change>
<change id="resourceChangeReporter">
<api name="devmodules"/>
<summary>
Added API/SPI for signalling change in resources deployed to
server (via DeploymentChangeDescriptor).
</summary>
<version major="1" minor="63"/>
<date day="10" month="11" year="2009"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added API/SPI to check for changes in resources deployed to
server. Such changes are flagged in DeploymentChangeDescriptor
and delivered to server plugin.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ResourceChangeReporter"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="ResourceChangeReporterFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="ResourceChangeReporterImplementation"/>
<issue number="175539"/>
</change>
<change id="filter">
<api name="devmodules"/>
<summary>
DeployOnSaveClassInterceptor added.
</summary>
<version major="1" minor="56"/>
<date day="15" month="5" year="2009"/>
<author login="mkleint"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
DeployOnSaveClassInterceptor class added + gettter in J2eeModuleProvider.
to allow processing Artifact instances coming from java infrastructure.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<issue number="165045"/>
</change>
<change id="undeploy">
<api name="devmodules"/>
<summary>
Programmatic undeploy for the project.
</summary>
<version major="1" minor="52"/>
<date day="15" month="9" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Provides a way to programmatic undeploy of the deployed app
(project represented by J2eeModuleProvider).
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<issue number="83122"/>
</change>
<change id="finishServerInitialization">
<api name="plugins"/>
<summary>
Provide a way for a plugin to perform post initialization action.
</summary>
<version major="1" minor="51"/>
<date day="31" month="7" year="2008"/>
<author login="vkraemer"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
OptionalDeploymentManagerFactory gets a new stub, that plugin
implementations would override. The Plugin author can assume
that the ServerRegistry is initialized to the point where it
can support the creation on instances.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerInitializationException"/>
<issue number="141427"/>
</change>
<change id="lookupProvider">
<api name="plugins"/>
<summary>
LookupProvider support for J2eePlatform lookup.
</summary>
<version major="1" minor="50"/>
<date day="23" month="7" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Server plugins will use this static method in J2eePlatformImpl.getLookup()
method to enable registration of additional Lookup Providers in layer.xml files.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="LookupProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.support" name="LookupProviderSupport"/>
<issue number="140219"/>
</change>
<change id="deployOnSaveAPI">
<api name="plugins"/>
<summary>
Provide a way for project to figure out whether deploy on save
is supported.
</summary>
<version major="1" minor="49"/>
<date day="15" month="7" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Server instance class provides method isDeployOnSaveSupported
in order to fugure out whether deploy on save is supported.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<issue number="138476"/>
</change>
<change id="deployOnSaveSPI">
<api name="plugins"/>
<summary>
Support methods to allow plugin to implement deploy on save.
</summary>
<version major="1" minor="47"/>
<date day="4" month="7" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
SPI is enhanced by two methods isDeployOnSaveSupported and
deployOnSave in order to allow plugin to provide deploy on
save functionality.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="IncrementalDeployment"/>
<issue number="138476"/>
</change>
<change id="deploymentChangeDescriptor">
<api name="plugins"/>
<summary>
Added final class describing the changes during the incremental deployment.
</summary>
<version major="1" minor="47"/>
<date day="4" month="7" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added final class describing the changes during the incremental deployment.
New class DeploymentChangeDescriptor implements old interface (AppChangeDescriptor)
and should be used in any new API.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="DeploymentChangeDescriptor"/>
<issue number="138476"/>
</change>
<change id="serverInstanceDescriptor">
<api name="plugins"/>
<summary>
API providing information about server host, port and flag
indicating local installation.
</summary>
<version major="1" minor="46"/>
<date day="30" month="5" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
API for querying server host, port and flag indicating
local installation. This is replacement for terrible hacks
querying (leaking) InstanceProperties directly.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerInstanceDescriptor"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<issue number="133751"/>
</change>
<change id="serverInstanceAPI">
<api name="plugins"/>
<summary>
There should be server instance representation in the API.
</summary>
<version major="1" minor="45"/>
<date day="29" month="5" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
API server instance in the API with clear indication that
instance was removed should be used in favor of Deployment
facade.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="InstanceRemovedException"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<issue number="135324"/>
</change>
<change id="j2eePlatformLookup">
<api name="plugins"/>
<summary>
Add Lookup to J2eePlatformImpl to make it extensible.
</summary>
<version major="1" minor="44"/>
<date day="6" month="5" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
J2eePlatform should provide Lookup containing support for
other technologies the server can provide (such as web services).
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="J2eePlatformImpl"/>
<issue number="133853"/>
</change>
<change id="removeDefaultServerAPI">
<api name="j2eeserver"/>
<summary>
Default server API residues removed.
</summary>
<version major="1" minor="42"/>
<date day="17" month="4" year="2008"/>
<author login="phejl"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible"/>
<description>
<p>
In the past, before the J2EE support was added to NetBeans the default server
concept had been used. This concept was then abandoned since it did not work
anymore. The problem could occur for example if the default server was Tomcat
then the EJB project which was set to use the default server could not be
deployed to it, etc.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="InstanceListener"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
<issue number="83934"/>
</change>
<change id="removeInstance">
<api name="j2eeserver"/>
<summary>
Provides a way to remove server without need to invoke UI action.
</summary>
<version major="1" minor="41"/>
<date day="5" month="3" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Method provides a way to remove server instance for plugins
which don't use the j2eeserver UI.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
</change>
<change id="createLibrary">
<api name="plugins"/>
<summary>
Method that creates the library based on content of the platform.
</summary>
<version major="1" minor="40"/>
<date day="21" month="2" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Methods allows creation of the library form the platform all
required files are copied to the new location. Requirement
introduced by java ee sharability.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
</change>
<change id="isCommonUIRequired">
<api name="j2eeserver"/>
<summary>
OptionalDeploymentManagerFactory declares whether j2eeserver
should provide common UI (like wizard for example).
</summary>
<version major="1" minor="38"/>
<date day="1" month="2" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
OptionalDeploymentManagerFactory declares whether j2eeserver
should provide common UI (like wizard for example). This
should be done with Common Server API for every new plugin.
InstantiatingIterator from OptionalDeploymentManagerFactory
will serve only to j2eeserver specific purposes if
isCommonUIRequired will return the false (the true is the default).
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<issue number="126010"/>
</change>
<change id="createInstancePropertiesWithoutUI">
<api name="j2eeserver"/>
<summary>
Provides a way how can plugin register instance to j2eeserver
without any UI.
</summary>
<version major="1" minor="37"/>
<date day="11" month="1" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Provides a way how can plugin register instance to j2eeserver
without any UI. SPI provided by Common Server should be used
for UI integration.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
<issue number="122885"/>
</change>
<change id="fixedProfilerAPIConstants">
<api name="profiler"/>
<summary>
Fixing state constants to be real (final) constants.
</summary>
<version major="1" minor="36"/>
<date day="11" month="12" year="2007"/>
<author login="phejl"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="no"/>
<description>
<p>
State constants used in the profiler API were not constants
in real - they were just public static variables. This change
makes them final.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.profiler.api" name="ProfilerSupport"/>
<issue number="122430"/>
</change>
<change id="createInstanceProperties">
<api name="j2eeserver"/>
<summary>
Adding InstanceProperties.createInstanceProperties(String, String,
String, String, Map&lt;String, String&gt;) method.
</summary>
<version major="1" minor="35"/>
<date day="27" month="11" year="2007"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The InstanceProperties.createInstanceProperties(String, String, String, String)
method does not provide any way how to pass other initial properties
required by the plugin. This is usually needed and workarounded
in many plugins. New method provides additional parameter containing
the any plugin required properties.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
<issue number="120379"/>
</change>
<change id="findJndiNameForEjb2">
<api name="j2eeserver"/>
<summary>
Adding J2eeModuleProvider.findJndiNameForEjb method.
</summary>
<version major="1" minor="33"/>
<date day="29" month="8" year="2007"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The J2eeModuleProvider.bindEjbReference and J2eeModuleProvider.bindEjbReferenceForEjb methods
need to pass an EJB JNDI name instead of EJB name to the plugin. The new J2eeModuleProvider.findJndiNameForEjb
method will allow to obtain the EJB JNDI name.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<issue number="108198"/>
</change>
<change id="isRunning">
<api name="j2eeserver"/>
<summary>
Adding Deployment.isRunning() method.
</summary>
<version major="1" minor="32"/>
<date day="29" month="8" year="2007"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Adding a method which will tell whether the given server is running or not.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<issue number="113023"/>
</change>
<change id="findJndiNameForEjb">
<api name="j2eeserver"/>
<summary>
Adding EjbResourceConfiguration.findJndiNameForEjb method.
</summary>
<version major="1" minor="31"/>
<date day="26" month="7" year="2007"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
The EjbResourceConfiguration.bindEjbReference and EjbResourceConfiguration.bindEjbReferenceForEjb methods
need to pass an EJB JNDI name instead of EJB name to the plugin. The new EjbResourceConfiguration.findJndiNameForEjb
method will allow to obtain the EJB JNDI name.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="EjbResourceConfiguration"/>
<issue number="108198"/>
</change>
<change id="setCMPResource">
<api name="j2eeserver"/>
<summary>
Replacing ensureResourceDefinedForEjb with setCMPResource.
</summary>
<version major="1" minor="30"/>
<date day="15" month="6" year="2007"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
Removing J2eeModuleProvider.ConfigSupport.ensureResourceDefinedForEjb and
EjbResourceConfiguration.ensureResourceDefined methods and replacing them
with J2eeModuleProvider.ConfigSupport.setCMPResource and MappingConfiguration.setCMPResource.
</p>
<p>
The main reason for this change is that the ComponentInterface parameter can
no longer be used since the metadata model was introduced, other reason is that
the old name was confusing.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="EjbResourceConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="MappingConfiguration"/>
<issue number="99217"/>
</change>
<change id="MetadataModel">
<api name="j2eeserver"/>
<summary>
Renaming getDeploymentDescriptor to getMetadataModel.
</summary>
<version major="1" minor="29"/>
<date day="12" month="6" year="2007"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
Renaming J2eeModule's and J2eeModuleImplementation's getDeploymentDescriptor method to getMetadataModel.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeModule"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleImplementation"/>
<issue number="99217"/>
</change>
<change id="AddServerWizard">
<api name="j2eeserver"/>
<summary>
Adds a method for displaying the Add server instance wizard.
</summary>
<version major="1" minor="28"/>
<date day="7" month="6" year="2007"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Adds a method for displaying the Add server instance wizard.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerManager"/>
<issue number="105403"/>
</change>
<change id="ExposeFileDeploymentCapabilityToProjects">
<api name="j2eeserver"/>
<summary>
Add a method that will allow Java EE project to determine if
they are being targeted at a server which will support directory-
based deployment.
</summary>
<version major="1" minor="27"/>
<date day="8" month="5" year="2007"/>
<author login="vkraemer"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Expose the directory deployment capabilities that a target server may
have which would allow the build script for a project to be
optimized to delay or eliminate unnecessary steps
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<issue number="89439"/>
</change>
<change id="ResourceApiRedesignCallEjbAction">
<api name="j2eeserver"/>
<summary>
Adding an API for Call EJB action
</summary>
<version major="1" minor="26"/>
<date day="15" month="4" year="2007"/>
<author login="lkotouc"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
API for Call EJB action.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="EjbResourceConfiguration"/>
<issue number="89439"/>
</change>
<change id="ResourceApiRedesign">
<api name="j2eeserver"/>
<summary>
Adding an API for working with data sources, message-driven beans and JMS messages
</summary>
<version major="1" minor="25"/>
<date day="5" month="4" year="2007"/>
<author login="lkotouc"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
API for working with data sources, message-driven beans and JMS messages.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="MessageDestination"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="MessageDestinationDeployment"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="DatasourceConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="MessageDestinationConfiguration"/>
<issue number="89439"/>
</change>
<change id="jdbcDriverDeployment">
<api name="j2eeserver"/>
<summary>
Adding an API for JDBC driver deployment.
</summary>
<version major="1" minor="24"/>
<date day="28" month="3" year="2007"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
API for JDBC driver deployment.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="JDBCDriverDeployer"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<issue number="89439"/>
</change>
<change id="ddbeanRemoval">
<api name="j2eeserver"/>
<summary>
Removing dependency of configuration releated part of the J2EE Server API on JSR-88.
Splitting up the plugin API to API and SPI.
</summary>
<version major="1" minor="23"/>
<date day="11" month="3" year="2007"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
The initial motivation for the J2EE Server API changes is migration to Retouche, a new
NetBeans Java infrastructure. The new Java infrastructure does not supply the old deployment
descriptor model with fine-grained change notification events anymore and thus a new Merged
deployment descriptor model infrastructure was created instead.
</p>
<p>
Since the architecture of the new Merged deployment descriptor model is essentially different
from the old deployment descriptor model infrastructure, the model can no longer be wrapped in
the JSR-88 DDBean wrapper, which was a basis of all the server specific deployment configuration
APIs, the deployment configuration related part of the J2EE Server API had to be redesigned.
</p>
<p>
Because the redesign already introduced big incompatible changes, we took advantage of it to
fix couple of API issues, which required incompatible changes. First, the server plug-in part
of the API was split into API and SPI. So far, there was no clear distinction between API and
SPI and it was not obvious what a server plug-in writer is required to implement. Second,
throws ConfigurationException clause was added to all the server-specific configuration
related methods to inform the client about a problem which might have occurred when reading or
writing to server-specific configuration files.
</p>
<p>
For further description refer to the issue.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="ConfigurationException"/>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="SourceFileMap"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeApplication"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeModule"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeModuleContainer" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeApplicationImplementation"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeApplicationProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeAppProvider" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleImplementation"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ConfigurationSupport" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="FileJ2eeModuleQuery"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="DatasourceManager" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="IncrementalDeployment"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ContextRootConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="DatasourceConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="DeploymentPlanConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="EjbResourceConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="MappingConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ModuleConfigurationFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ModuleConfiguration"/>
<issue number="99217"/>
</change>
<change id="settableTimeouts">
<api name="plugins"/>
<summary>
New static fields on InstanceProperties
</summary>
<version major="1" minor="22"/>
<date day="22" month="3" year="2007"/>
<author login="vkraemer"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Eliminate completely hard-code timeout for startup, shutdown
and deployment operations. Current hard-coded timeouts
remain the default for plugins that do not provide
per-instance settings.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
<issue number="98089"/>
</change>
<change id="ensureResourceDefinedUpdate">
<api name="j2eeserver"/>
<summary>
Passing JNDI name for the resource definition callback
</summary>
<version major="1" minor="20"/>
<date day="11" month="8" year="2006"/>
<author login="lkotouc"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Plugin needs to know JNDI name of the resource which the resource being
defined is coming from.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ConfigurationSupport" link="no"/>
<issue number="82476"/>
</change>
<change id="serverIcons">
<api name="plugins"/>
<summary>
Added support for getting the default server icons.
</summary>
<version major="1" minor="19"/>
<date day="9" month="4" year="2006"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added support for getting the default server icons for
EAR, EJB, WAR archives and their respective containers (folders).
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="UISupport"/>
</change>
<change id="antDeployment">
<api name="j2eeserver"/>
<summary>
Added support for Ant (headless) deployment.
</summary>
<version major="1" minor="18"/>
<date day="4" month="4" year="2006"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Ant deployment support allows to generate Ant deployment build
scripts that can be used to deploy j2ee modules to the
server. The generated deployment build script can run in a headless
mode - without the IDE. The IDE does not even have to be installed.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="AntDeploymentHelper"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="AntDeploymentProvider" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="OptionalDeploymentManagerFactory" link="no"/>
</change>
<change id="j2eeSpecVersionPerModule">
<api name="j2eeserver"/>
<summary>
Added support for getting J2EE version per module.
</summary>
<version major="1" minor="17"/>
<date day="4" month="4" year="2006"/>
<author login="pbuzek"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Some for servers support different versions of j2ee for different modules.
For example JBoss 4.0.3 supports EJB 3.0 in ejb module, but only servlet api 2.4
in web module.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="J2eePlatformImpl" link="no"/>
</change>
<change id="j2eePlatformTools">
<api name="j2eeserver"/>
<summary>
Added support for getting the tool properties, added constants for
tools and tool properties.
</summary>
<version major="1" minor="16"/>
<date day="22" month="3" year="2006"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Many tools need properties like main class or JVM options,
the getToolProperty method allows to get those properties
now, so far these properties had to be hardcoded.
</p>
<p>
The constats for the tools and the tool properties were added
to avoid problems that might occur if the tool string changes.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="J2eePlatformImpl" link="no"/>
</change>
<change id="DatasourceManagementAPI">
<api name="j2eeserver"/>
<summary>DS management API allows clients to access and manipulate the data sources</summary>
<version major="1" minor="15"/>
<date day="17" month="3" year="2006"/>
<author login="lkotouc"/>
<compatibility addition="yes"/>
<description>
<p>
DS management API allows clients to access and manipulate the data sources.
Data sources are created in the module and deployed when the module deployment begins.
Data sources are accessed at two places - at the modules where they are stored after creation
and on the module's target server.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="Datasource"/>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="DatasourceAlreadyExistsException"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ConfigurationSupport" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="DatasourceManager" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="OptionalDeploymentManagerFactory" link="no"/>
</change>
<change id="resourceDirUpdate">
<api name="j2eeserver"/>
<summary>
Support for updating module enterprise resource directory added.
</summary>
<version major="1" minor="12"/>
<date day="10" month="10" year="2005"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
Plugins need to be notified when the module enterprise resource
directory changes.
</p>
<p>
Property PROP_ENTERPRISE_RESOURCE_DIRECTORY and property change
listener added to J2eeModuleProvider.
</p>
<p>
Abstract method updateResourceDir(DeploymentConfiguration config, File resourceDir)
added to ConfigurationSupport.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ConfigurationSupport" link="no" />
</change>
<change id="profilerSupport">
<api name="j2eeserver"/>
<summary>
Profiler support added.
</summary>
<version major="1" minor="9"/>
<date day="15" month="9" year="2005"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
Profiler support extension of the j2eeserver API allows Profiler to profile Web and other
J2EE project types in a comfortable and reliable way.
</p>
<p>
Profiler SPI, the Profiler is required to implement and register into the default
Lookup, allows to obtain information about current profiling session status, settings
required for starting a server in profiling mode and to stop profiled server.
</p>
<p>
Profiler API, which defines class encapsulating settings required for
starting a server in profiling mode and provides support for reading current
state of Profiler registered in the default Lookup.
</p>
<p>
Extension of StartServer that allows the j2eeserver to check whether the given
server supports profiling and allows to start it if it does.
</p>
<p>
Extension of J2eePlatform that allows the Profiler to check if the Java
platform specified for the server is acceptable for profiling. If not, the
Profiler is able to check if other platform which can be used for profiling is
acceptable for running the server.
</p>
<p>
Ant task 'nbstartprofiledserver' that may stop other server being profiled
and prepare the target server for profiling - this means (re)starting the
server using provided settings or no action if the server is already running
with correct configuration.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="J2eePlatformImpl" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="StartServer" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.profiler.api" name="ProfilerServerSettings" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.profiler.api" name="ProfilerSupport" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.profiler.spi" name="Profiler" link="no"/>
<issue number="56032"/>
</change>
<change id="serverConfigurationRedesign">
<api name="j2eeserver"/>
<summary>
The common server specific deployment descriptor data loader has been
removed from the j2eeserver. The plugins are no longer required to
use the DConfigBean based model.
</summary>
<version major="1" minor="8"/>
<date day="22" month="8" year="2005"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
The common server specific deployment descriptor data loader has
been removed. Each plugin should now register its own data loader,
if needed. The j2eeserver does no longer control saving of the
server specific deployment descriptors, it is plugin responsibility
now. With the removal of the common data loader, the plugins are
no longer required to use the DConfigBean based model.
</p>
<p>
Plugins should implement the ConfigurationSupport abstract class
in order to provide support for their server specific deployment
descriptors.
</p>
<p>
Removed: DConfigBeanProperties, DConfigBeanUIFactory, DeploymentPlanSplitter.
Modified: ConfigurationSupport interface was modified and turned into
an abstract class.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="DConfigBeanProperties" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="DConfigBeanUIFactory" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="DeploymentPlanSplitter" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ConfigurationSupport" link="no"/>
<issue number="56032"/>
</change>
<change id="J2eeModule-UISupport">
<api name="j2eeserver"/>
<summary>ServerManager and UISupport classes added. Added method supportsStartDebugging()
to the StartServer class.</summary>
<version major="1" minor="7"/>
<date day="9" month="8" year="2005"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The <code>ServerManager</code> class allows other modules to display the Server Manager dialog.
The <code>UISupport</code> class provides server plugins with an InputOutput instance with
the server state management actions: start, debug, restart, stop and refresh.
The <code>supportsStartDebugging()</code> method says whether the <code>startDebugging()</code>
method is supported, it is analogous to the <code>supportsStartDeploymentManager()</code>
and <code>startDeploymentManager()</code> methods.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerManager"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="UISupport"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="StartServer" link="no"/>
<issue number="55640"/>
</change>
<change id="J2eeModule-J2EE15-constant">
<api name="j2eeserver"/>
<summary>Added setServerInstanceID method into J2eeModuleProvider.</summary>
<version major="1" minor="6"/>
<date day="18" month="4" year="2005"/>
<author login="pbuzek"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Add a constant for J2EE 1.5 specification level.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
</change>
<change id="J2eeModuleProvider-setServerInstanceID">
<api name="j2eeserver"/>
<summary>Added setServerInstanceID method into J2eeModuleProvider.</summary>
<version major="1" minor="6"/>
<date day="14" month="3" year="2005"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
When adding module to j2ee application the target server needs
to be set to the same as for the app. To make this possible we
need to add setServerInstanceID method into J2eeModuleProvider.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
</change>
<change id="StartServer-stopDontWait">
<api name="j2eeserver"/>
<summary>Added stopDontWait and canStopDontWait methods into StartServer.</summary>
<version major="1" minor="6"/>
<date day="10" month="3" year="2005"/>
<author login="pbuzek"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
These methods allow plugins to stop the server silently when the IDE is being
shutdown. This addresses the problem filed as 52978 - Shutdown of appserver at
IDE shutdown is unresponsive.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="StartServer" link="no" />
</change>
<change id="Deployment-addInstanceListener">
<api name="j2eeserver"/>
<summary>Added addInstanceListener and removeInstanceListener methods to Deployment class.</summary>
<version major="1" minor="6"/>
<date day="9" month="2" year="2005"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added <code>addInstanceListener</code> and <code>removeInstanceListener</code> methods to the
<code>Deployment</code> class. This will allow registration of <code>InstanceListener</code>s
that will listen to server instances changes (addition, removal, etc.) also for modules that do
not implement the <code>J2eeModuleProvider</code> which was currently the only place where
<code>InstanceListener</code>s could be registered.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
</change>
<change id="InstanceListener-and-Deployment-getSrvInstIDs">
<api name="j2eeserver"/>
<summary>Added InstanceListener. Added Deployment.getServerInstancesIDs methods for getting server instances based on some requirements.</summary>
<version major="1" minor="6"/>
<date day="25" month="1" year="2005"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added <code>InstanceListener</code> that will allow listening to server instance changes (addition,
removal, etc.). Methods for <code>InstanceListener</code> registration were added to <code>J2eeModuleProvider</code>.
To the <code>Deployment</code> class were added <code>getServerInstanceIDs</code> methods for listing
registered server instances based on some requirements - supported module types, J2EE specification
versions and tools.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="InstanceListener"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
</change>
<change id="Add-StartServer-needsRestart">
<api name="plugins"/>
<summary>StartServer.needsRestart tells j2eeserver a state of the server</summary>
<version major="1" minor="6"/>
<date day="20" month="1" year="2005"/>
<author login="nnguyen"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
This optional method allow plugin to communicate with
j2eeserver about the need to restart the server before
deployment so that last changes to server configuration
would take effect.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="StartServer" link="no"/>
<issue number="53721"/>
</change>
<change id="Add-ModuleChangeDescriptor-getChangedFiles">
<api name="plugins"/>
<summary>Method getChangedFiles allows plugin code to access all
the changes in current deployment.</summary>
<version major="1" minor="6"/>
<date day="18" month="1" year="2005"/>
<author login="nnguyen"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The summary of changes provided by current
ModuleChangeDescriptor is not sufficient in many cases for
plugin code to ensure the incrementally deployed
application available. This new method getChangedFiles
would serve as a 'catch-all' for plugin code to examine
details of the changes.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ModuleChangeDescriptor"/>
<issue number="53539"/>
</change>
<change id="StartServer-Services-for-Target">
<api name="plugins"/>
<summary>StartServer methods call to manage states for target server instances</summary>
<version major="1" minor="6"/>
<date day="10" month="1" year="2005"/>
<author login="nnguyen"/>
<compatibility binary="compatible" source="compatible" semantic="incompatible" addition="yes"/>
<description>
<p>
J2eeserver should be able to start target managed server instances
which are not identical with admin server instance.
Methods supportsStartTarget, isRunning, startTarget, stopTarget
are added as optional to StartServer abstract class plugin SPI.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="StartServer" link="no"/>
<issue number="53010"/>
</change>
<change id="J2eePlatform-Icon">
<api name="j2eeserver"/>
<summary>Added J2EE Platform icon</summary>
<version major="1" minor="6"/>
<date day="6" month="1" year="2005"/>
<author login="abadea"/>
<compatibility binary="incompatible" source="incompatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added methods for the J2EE Platform to be able to specify an icon. The new methods are
<code>J2eePlatform.getIcon()</code> and <code>J2eePlatformImpl.getIcon()</code>.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="J2eePlatformImpl" link="no"/>
<issue number="52993"/>
</change>
<change id="J2eePlatform">
<api name="j2eeserver"/>
<summary>Added J2EE Platform</summary>
<version major="1" minor="5"/>
<date day="13" month="12" year="2004"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="incompatible" addition="yes"/>
<description>
<p>
J2EE Platform extends the current j2eeserver module of description of a target environment J2EE
applications are build against and subsequently deployed to.
</p>
<ul>
<li>platform describes the target environment</li>
<li>platform provides compilation classpath which projects should be build against</li>
<li>platform provide sources and javadocs for classpath entries</li>
<li>platform provide basic tool support (e.g. wscompile)</li>
</ul>
<p>
Constants for the J2EE specification version added to the <code>J2eeModule</code> class.<br/>
To the <code>Deployment</code> class was added method <code>getJ2eePlatform(String serverInstanceID)</code>
which returns <code>J2eePlatform</code> instance for the given <code>serveInstanceID</code>.<br/>
Added new classes: <code>J2eeLibraryTypeProvider</code>, <code>J2eePlatform</code>,
<code>J2eePlatformFactory</code>, <code>J2eePlatformImpl</code>.<br/>
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="J2eeLibraryTypeProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeModule"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="J2eePlatformFactory" link="no" />
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="J2eePlatformImpl" link="no"/>
<issue number="52167"/>
</change>
<change id="CMP-Mapping-and-Auto-Resources.devmodules">
<api name="devmodules"/>
<summary>Added directory access methods</summary>
<version major="1" minor="5"/>
<date day="5" month="12" year="2004"/>
<author login="nnguyen"/>
<compatibility addition="yes"/>
<description>
<p>
Added methods on <code>J2eeModuleProvider</code> for dev modules to
expose some its project directory structure part to
integration plugin. The added methods are: <code>File
getEnterpriseResourceDirectory()</code> and
<code>FileObject[] getSourceRoots()</code>
</p>
<p>
Added methods on
<code>J2eeModuleProvider.ConfigSupport</code> for dev
modules to push configuration data to plugin or request
plugin to ensure resources are defined on creation of
EJBs. The added methods are: <code>void
setCMPMappingInfo(String ejbname, OriginalCMPMapping
mapping)</code> and <code>void
ensureResourceDefinedForEjb(String ejbname, String
ejbtype)</code>
</p>
<p>
See Javadoc for details.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
</change>
<change id="CMP-Mapping-and-Auto-Resources.common">
<api name="common"/>
<summary>Added SourceFileMap access methods</summary>
<version major="1" minor="5"/>
<date day="5" month="12" year="2004"/>
<author login="nnguyen"/>
<compatibility addition="yes"/>
<description>
<p>
Expand usage of <code>SourceFileMap</code> by a set of methods
to allow plugin access source, descriptor files. Also added
static lookup methods to locate the right
<code>SourceFileMap</code> object.
</p>
<p>
See Javadoc for details.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="SourceFileMap"/>
</change>
<change id="CMP-Mapping-and-Auto-Resources.plugins">
<api name="plugins"/>
<summary>Added configuration support services</summary>
<version major="1" minor="5"/>
<date day="5" month="12" year="2004"/>
<author login="nnguyen"/>
<compatibility addition="yes"/>
<description>
<p>
Added Integration plugin SPI <code>ConfigurationSupport</code>
for plugin to provide services like create CMP/CMR mapping
from generic mapping info acquired by devmodule
wizards. This SPI also allow development modules to notify
plugin on making sure default resources might needs to be
generated for new components.
</p>
<p>
See Javadoc for details.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ConfigurationSupport" link="no" />
</change>
<change id="Deprecating-DeploymentPlanSplitter.getDeploymentPlanFileNames">
<api name="plugins"/>
<summary>Deprecates DeploymentPlanSplitter.getDeploymentPlanFileNames</summary>
<version major="1" minor="5"/>
<date day="20" month="12" year="2004"/>
<author login="nnguyen"/>
<compatibility addition="yes"/>
<description>
<p>
The reason for deprecating is that plugin SPI method
<code>DeploymentPlanSplitter.getDeploymentPlanFileNames</code>
has become exact duplicate with layer.xml entries declaration:
<code>J2EE/DeploymentPlugins/plugin-name/DeploymentFileNames</code>
J2EE Server Registry code has now been consolidated
and is no longer depends on this method call;
the require layer.xml entries are used instead.
</p>
<p>
See Javadoc for details.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="DeploymentPlanSplitter" link="no"/>
</change>
<change id="Batched-CMPMappingInfo">
<api name="j2eeserver"/>
<summary>Wizard should push CMP mappings in one single call</summary>
<version major="1" minor="5"/>
<date day="23" month="12" year="2004"/>
<author login="nnguyen"/>
<compatibility addition="yes"/>
<description>
<p>
Related CMP Beans Wizard need to push mapping info to plugin
in one single call. This would improve performance and make it
easier for plugin code to process the relationship mappings.
Part of this batching change, OriginalCMPMapping now includes ejbName.
J2eeModuleProvider.ConfigSupport now has new method saveConfiguration()
to allow development module wizard to commit changes it caused to
component deployment configuration.
OriginalMappingProvider, not used in the CMP mapping push module,
is removed.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ConfigurationSupport" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="OriginalCMPMapping"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="OriginalMappingProvider" link="no"/>
</change>
</changes>
<!-- Now the surrounding HTML text and document structure: -->
<htmlcontents>
<!--
NO NO NO NO NO!
==============> DO NOT EDIT ME! <==============
AUTOMATICALLY GENERATED FROM APICHANGES.XML, DO NOT EDIT
SEE j2eeserver/apichanges.xml
-->
<head>
<title>Change History for the J2EE Server API</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 <a href="index.html">J2EE Server API</a>.</p>
<!-- The actual lists of changes, as summaries and details: -->
<hr/>
<standard-changelists module-code-name="org.netbeans.modules.j2eeserver/3"/>
<hr/><p>@FOOTER@</p>
</body>
</htmlcontents>
</apichanges>