Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

New Help for Old Friends IV

Revision as of 14:25, 9 February 2009 by Nsand.dev.gmail.com (Talk | contribs) (Semantic Highlighting)

This page to to collect miscellaneous notes and pointers to changes coming up in the WTP 3.1 (Galileo) release. Its purpose it to be a central "jump off" point for those adopters of WTP 3.0 that are moving to WTP 3.1. Most of this information may be already contained in various mailing lists and Bugzilla reports, but it is believed best to have a central place to get people started.

Adopters: if you run into trouble or notice things that are not covered here, please let us know (wtp-dev@eclipse.org is a good place). This will not only help us keep these notes up to date, but will help us better learn, over time, the discipline of "platform development" and help make sure we learn to provide compatible APIs, migration instructions, etc., in the future. It is not always easy, but our intent is to make it as simple and painless as possible for adopters to use WTP as a true platform.

One thing we have learned in the past is that some adopters do not move with us to every new release. Some early adopters went from 0.7 directly to 1.5, for example. Unfortunately, it is hard for us to present the information in that way, covering perhaps multiple changes, but hopefully as we develop these for each release, they will all flow together to aid adopters.

Note: as these notes develop and grow in number, they may occasionally be re-organized into categories, etc.


Versioning changes

Remember you can always view the versions and version changes for each build, by following the "Versioning Information" link on each build page. For example, see the one for WTP 3.1 M4.

Following are some of the noteworthy 'minor' field changes.

Common Components

The Faceted Project framework needed to increment the minor version in the 3.1 code stream to reflect the changes that happened in that code.

Bundle Version change
org.eclipse.wst.common.project.facet.core 1.3.100 -> 1.4.0
org.eclipse.wst.common.project.facet.ui 1.3.100 -> 1.4.0
org.eclipse.jst.common.project.facet.core 1.3.100 -> 1.4.0
org.eclipse.jst.common.project.facet.ui 1.3.100 -> 1.4.0

Source Editing

Bundle Version change Trigger
org.eclipse.wst.xml.ui 1.0.4xx -> 1.1.0 Refactoring of Outline View Configuration (246024)

Web Services

Bundle Version change Trigger Notes
org.eclipse.wst.wsdl 1.1.3xx -> 1.2.0 Bug 197197
javax.wsdl 1.4.x -> 1.5.x Bug 197197 Both versions of the plugin are actually currently in WTP, however if your plugin depends on both this plugin and org.eclipse.wst.wsdl, you are required to update this plugin dependency version number as well.

Source Editing Components

Selection in the XML/HTML/JSP Editors

The XML (and HTML and JSP) Editor selection, which represents both the selected DOM Nodes and text selection, now allows for the selected Node to be an Attr Node (attribute). Listeners who were written to handle Element Nodes may wish to use Attr.getOwnerElement() in this case.

Semantic Highlighting

SSE-based editors now support Semantic Highlighting.

In WTP 3.1M5, an org.eclipse.wst.sse.ui.semanticHighlighting extension point was added for adopters to contribute their own highlightings. This extension point is used to define a semantic highlighting, which is the content types the highlighting is valid for and the class that defines the stylings and consumable regions.

<extension point="org.eclipse.wst.sse.ui.semanticHighlighting">
    <highlighting
          class="com.example.highlighting.NamespaceHighlighting"
          target="org.eclipse.core.runtime.xml, org.eclipse.wst.xml.core.xmlsource">
    </highlighting>
</extension>

The class defined in the highlighting element must implement org.eclipse.wst.sse.ui.ISemanticHighlighting. The implementation is responsible for identifying the consumable IStructuredDocumentRegions. If a region is consumable, the preference store returned by getPreferenceStore() is queried for styles using the keys from the get*Key() methods.

Semantic Highlighting is enabled via the Structured Text Editors Preference page.

Web Services Components

Upgrade to WSDL4J 1.5.1

The WSDL editor, model, and validator have been upgraded from using WSDL4J 1.4.1 to using WSDL4J 1.5.1. If your plugin has a dependency on org.eclipse.wst.wsdl.validator.* or org.eclipse.wst.wsi.* as well as javax.wsdl, please either update your dependency on javax.wsdl to 1.5.x or please ensure your dependency on the javax.wsdl plugin is stated before your dependency on the wsdl plugins in your manifest.mf file. If your plugin has a dependency on org.eclipse.wst.wsdl.* plugins as well as javax.wsdl, please update your dependency to javax.wsdl 1.5.x. Please see the following bugs for more details: Bug 197197 Bug 252257 Bug 252258

Reference

See also: New Help for Old Friends III, New Help for Old Friends II, and the original New Help for Old Friends

Back to the top