Jump to: navigation, search

Difference between revisions of "WTP 2.0 API Delta"

(JSF: Deleted App Conifg Manager - its provisional API)
 
(16 intermediate revisions by 7 users not shown)
Line 1: Line 1:
The following is a summary of the API changes between WTP 1.5 and 2.0:
+
The following is a summary of the API changes between WTP 1.5 and 2.0: [http://wiki.eclipse.org/index.php?title=WTP_2.0_API_Delta&action=edit edit]
 +
 
 +
==== Common Components ====
 +
* The <code>ID</code> value given for extensions to <code>org.eclipse.wst.common.snippets.SnippetContributions</code> can now be accessed [https://bugs.eclipse.org/bugs/show_bug.cgi?id=172041 programmatically]
 +
 
 +
 
  
 
====  XML/JSP Components ====
 
====  XML/JSP Components ====
 +
* Declared the <code>org.eclipse.jst.jsp.core.tagsource</code> Content Type for JSP 2.0 Simple Tag Extension files
 +
* <code>org.eclipse.jst.jsp.core.taglib.ITaglibIndexListener</code> and <code>org.eclipse.jst.jsp.core.taglib.ITaglibIndexDelta</code> are now API interfaces; the API versions have breaking changes from earlier unsupported revisions
 +
* The following <code>hyperlinkDetectorTargets</code> were set up, so adopters can target their hyperlink detectors to the xml, schema, wsdl, html, jsp editors via the <code>org.eclipse.ui.workbench.texteditor.hyperlinkDetectors</code> extension point: <code>org.eclipse.core.runtime.xml, org.eclipse.wst.xsd.core.xsdsource, org.eclipse.wst.wsdl.wsdlsource, org.eclipse.wst.html.core.htmlsource, org.eclipse.jst.jsp.core.jspsource</code>
 +
 +
 +
====  Server Component ====
 +
* API support for external (non-workspace) modules added via <code>org.eclipse.wst.server.core.IModule.isExternal()</code> and associated methods in <code>org.eclipse.wst.server.core.ServerBehaviourDelegate</code>.
 +
 +
* New API methods added to <code>org.eclipse.wst.server.core.IServer</code> including <code>getLaunchConfiguration()</code>, <code>shouldPublish()</code>, and <code>shouldRestart()</code>.
 +
 +
* Support for server scheduling rules added to <code>org.eclipse.wst.server.core.ServerUtil</code>.
 +
 +
* Support for multiple artifacts in a single selection added via <code>org.eclipse.wst.server.core.model.ModuleArtifactAdapterDelegate.getModuleArtifacts()</code>.
 +
 +
* <code>org.eclipse.wst.server.model.ModuleArtifactDelegate</code> added as an abstract class (including additional support) for all artifact delegates.
 +
 +
* Performance improvements added via new methods to <code>org.eclipse.wst.server.core.model.ModuleFactoryDelegate.findModule()</code> and <code>getModule()</code>.
 +
 +
* Support for better restarting added via <code>org.eclipse.wst.server.core.model.ServerBehaviourDelegate.restartModule()</code>.
 +
 +
* <code>org.eclipse.wst.server.core.util.PublishUtil</code> moved from jst.server and added to API.
 +
 +
* Run on Server added to API via <code>org.eclipse.wst.server.ui.actions.RunOnServerAction</code>.
 +
 +
* <code>org.eclipse.wst.server.ui.ServerUIUtil</code> provides additional methods to display new runtime and new server wizards.
 +
 +
* <code>org.eclipse.wst.server.ui.FacetRuntimeComponentLabelProvider</code> provides a new facet runtime label provider.
 +
 +
* Enhanced profiler support for TPTP in jst.server in provisional API.
 +
 +
==== WebServices and WSDL ====
 +
 +
* The Web Services Explorer now supports a pluggable transport and message stack.  A new extension point, '''org.eclipse.wst.ws.explorer.wseTransportProvider''', has been added to the Web Services Explorer.  This extension point entry allows an extender to plug in a new factory for creating '''org.eclipse.wst.ws.internal.explorer.transport.ISOAPTransport''' instances. The '''ISOAPTranport''' class is used by the Web Services Explorer for invoking Web services operations that uses the SOAP message protocol. The factory must implement the '''org.eclipse.wst.ws.internal.explorer.transport.ISOAPTransportProvider''' interface. Other supporting classes/interfaces which are part of this internal API can be found in the '''org.eclipse.wst.ws.internal.explorer.transport''' package.
 +
* A new optional attribute '''mergerClass''' is introduced in the Web services implementation type extension point '''org.eclipse.jst.ws.consumption.ui.wsImpl'''. This '''mergerClass''' should implement the newly defined '''org.eclipse.wst.ws.internal.wsrt.IMerger''' interface which contains a load() and merge() method. This class is used for the purpose of Web services skeleton file merging for the Web service implementation type.
 +
* Adopters of the Web services creation framework can now use the same Web services pop-ups provided by the framework to process their custom types. They just need to provide an '''IAdapterFactory''' that adapts that custom type to IFile or String and register the factory with the Platform's '''AdapterManager''' (or extends the '''org.eclipse.core.runtime.adapters''' extension). There might be sematic changes post WTP 2.0 to change the type of object the custom types should be adapted to.
 +
 +
==== JEE ====
 +
 +
*
 +
 +
==== JSF ====
 +
 +
*'''Application Configuration Resource File ("faces-config.xml") Model''': Packages, <code>org.eclipse.jst.jsf.facesconfig.*</code>, provide programmatic access and manipulation of the standard JSF application configuration resource file (e.g. "faces-config.xml").
 +
*'''Design-Time Application Framework''': Packages,<code>org.eclipse.jst.jsf.core.designtime.*</code>, simulates certain JSF runtime behavior (currently mainly EL variable/property resolution)  at designtime and provides API for adopters to add the same for their custom extension of the JSF runtime (i.e. custom VariableResolver).
 +
*'''Model Context Framework''': Packages, <code>org.eclipse.jst.jsf.common.context</code>, provides a generic way to describe specific instance contexts within an arbitrary model and derive orthogonal information about that context through related resolvers.
 +
*Packages, <code>org.eclipse.jst.jsf.common.util</code>, provides utility classes for manipulating JDT IType's, primarily as Java Beans.
 +
 +
==== JPT - Dali JPA Tools ====
 +
 +
* None:  No Public API's have been defined for this release due to the fact that our models are not quite at the correct level of maturity.  The hope is that adopter feedback as a result of working with the release will allow us to harden the model and declare real API for future releases. See bug 178653 for more information.
  
  
 
[[Category:Eclipse Web Tools Platform Project]]
 
[[Category:Eclipse Web Tools Platform Project]]
* Supports [https://bugs.eclipse.org/bugs/show_bug.cgi?id=170988#c15 quick fix] processors as attributes on validation framework <code>IMessage</code>s.  Although a functional extension point is available as well, it is '''''only provisional'''''.
 
* Private hyperlink facility has been replaced with support for the [https://bugs.eclipse.org/bugs/show_bug.cgi?id=177387 platform's] [http://download.eclipse.org/eclipse/downloads/drops/S-3.3M5-200702091006/eclipse-news-M5.html#Platform extension points and APIs]
 
* Added the <code>org.eclipse.jst.jsp.core.tagsource</code> content type for simple tag extension files
 
* <code>org.eclipse.jst.jsp.core.taglib.ITaglibIndexListener</code> and <code>org.eclipse.jst.jsp.core.taglib.ITaglibIndexDelta</code> are now API interfaces; the API versions have breaking changes from earlier unsupported revisions
 
* Partitioning constants haven't been changed as expected, although the possibility still remains for 3.0
 

Latest revision as of 14:28, 1 June 2007

The following is a summary of the API changes between WTP 1.5 and 2.0: edit

Common Components

  • The ID value given for extensions to org.eclipse.wst.common.snippets.SnippetContributions can now be accessed programmatically


XML/JSP Components

  • Declared the org.eclipse.jst.jsp.core.tagsource Content Type for JSP 2.0 Simple Tag Extension files
  • org.eclipse.jst.jsp.core.taglib.ITaglibIndexListener and org.eclipse.jst.jsp.core.taglib.ITaglibIndexDelta are now API interfaces; the API versions have breaking changes from earlier unsupported revisions
  • The following hyperlinkDetectorTargets were set up, so adopters can target their hyperlink detectors to the xml, schema, wsdl, html, jsp editors via the org.eclipse.ui.workbench.texteditor.hyperlinkDetectors extension point: org.eclipse.core.runtime.xml, org.eclipse.wst.xsd.core.xsdsource, org.eclipse.wst.wsdl.wsdlsource, org.eclipse.wst.html.core.htmlsource, org.eclipse.jst.jsp.core.jspsource


Server Component

  • API support for external (non-workspace) modules added via org.eclipse.wst.server.core.IModule.isExternal() and associated methods in org.eclipse.wst.server.core.ServerBehaviourDelegate.
  • New API methods added to org.eclipse.wst.server.core.IServer including getLaunchConfiguration(), shouldPublish(), and shouldRestart().
  • Support for server scheduling rules added to org.eclipse.wst.server.core.ServerUtil.
  • Support for multiple artifacts in a single selection added via org.eclipse.wst.server.core.model.ModuleArtifactAdapterDelegate.getModuleArtifacts().
  • org.eclipse.wst.server.model.ModuleArtifactDelegate added as an abstract class (including additional support) for all artifact delegates.
  • Performance improvements added via new methods to org.eclipse.wst.server.core.model.ModuleFactoryDelegate.findModule() and getModule().
  • Support for better restarting added via org.eclipse.wst.server.core.model.ServerBehaviourDelegate.restartModule().
  • org.eclipse.wst.server.core.util.PublishUtil moved from jst.server and added to API.
  • Run on Server added to API via org.eclipse.wst.server.ui.actions.RunOnServerAction.
  • org.eclipse.wst.server.ui.ServerUIUtil provides additional methods to display new runtime and new server wizards.
  • org.eclipse.wst.server.ui.FacetRuntimeComponentLabelProvider provides a new facet runtime label provider.
  • Enhanced profiler support for TPTP in jst.server in provisional API.

WebServices and WSDL

  • The Web Services Explorer now supports a pluggable transport and message stack. A new extension point, org.eclipse.wst.ws.explorer.wseTransportProvider, has been added to the Web Services Explorer. This extension point entry allows an extender to plug in a new factory for creating org.eclipse.wst.ws.internal.explorer.transport.ISOAPTransport instances. The ISOAPTranport class is used by the Web Services Explorer for invoking Web services operations that uses the SOAP message protocol. The factory must implement the org.eclipse.wst.ws.internal.explorer.transport.ISOAPTransportProvider interface. Other supporting classes/interfaces which are part of this internal API can be found in the org.eclipse.wst.ws.internal.explorer.transport package.
  • A new optional attribute mergerClass is introduced in the Web services implementation type extension point org.eclipse.jst.ws.consumption.ui.wsImpl. This mergerClass should implement the newly defined org.eclipse.wst.ws.internal.wsrt.IMerger interface which contains a load() and merge() method. This class is used for the purpose of Web services skeleton file merging for the Web service implementation type.
  • Adopters of the Web services creation framework can now use the same Web services pop-ups provided by the framework to process their custom types. They just need to provide an IAdapterFactory that adapts that custom type to IFile or String and register the factory with the Platform's AdapterManager (or extends the org.eclipse.core.runtime.adapters extension). There might be sematic changes post WTP 2.0 to change the type of object the custom types should be adapted to.

JEE

JSF

  • Application Configuration Resource File ("faces-config.xml") Model: Packages, org.eclipse.jst.jsf.facesconfig.*, provide programmatic access and manipulation of the standard JSF application configuration resource file (e.g. "faces-config.xml").
  • Design-Time Application Framework: Packages,org.eclipse.jst.jsf.core.designtime.*, simulates certain JSF runtime behavior (currently mainly EL variable/property resolution) at designtime and provides API for adopters to add the same for their custom extension of the JSF runtime (i.e. custom VariableResolver).
  • Model Context Framework: Packages, org.eclipse.jst.jsf.common.context, provides a generic way to describe specific instance contexts within an arbitrary model and derive orthogonal information about that context through related resolvers.
  • Packages, org.eclipse.jst.jsf.common.util, provides utility classes for manipulating JDT IType's, primarily as Java Beans.

JPT - Dali JPA Tools

  • None: No Public API's have been defined for this release due to the fact that our models are not quite at the correct level of maturity. The hope is that adopter feedback as a result of working with the release will allow us to harden the model and declare real API for future releases. See bug 178653 for more information.