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

Difference between revisions of "WTP FAQ"

(General)
m (How do I install WTP?)
(116 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 
==Eclipse Web Tools Frequent Asked Questions==
 
==Eclipse Web Tools Frequent Asked Questions==
  
Many of the FAQ's found on this page have been pulled from the [http://www.eclipse.org/newsgroups/index_project.php|WTP newsgroup]. Thank you to everyone that took the time to answer these questions.
+
Many of the FAQ's found on this page have been pulled from the [http://www.eclipse.org/forums/eclipse.webtools WTP newsgroup]. Thank you to everyone that took the time to answer these questions.
  
Looking for FAQ's related to the development of WTP? See the [http://http://www.eclipse.org/webtools/faq/CommitterFAQ.php | Committer FAQ].
+
Looking for FAQ's related to the development of WTP? See the [http://www.eclipse.org/webtools/faq/CommitterFAQ.php Committer FAQ].
  
If you have identified a FAQ that is not in this list, please add it to the list.  You will need a bugzilla user id in order to edit the page.
+
If you have identified a FAQ that is not in this list, please add it to the list.  You will need a [http://bugs.eclipse.org/bugs bugzilla] user id in order to edit the page.
  
==Table of Contents==
+
==General==
  
===General===
+
===How is the Eclipse Web Tools Platform licensed?===
 +
The Eclipse Web Tools Platform (WTP) consists of software produced by the Eclipse Project combined with third party software from other open source projects. The software produced by the Eclipse Project is made available under the [https://www.eclipse.org/org/documents/epl-v10.php Eclipse Public License]. Third party components are made available under their own licenses. The detailed licensing information can be found in the Eclipse.org Software User Agreement (notice.html) file in the root directory of the SDK download. Licensing for third party components is described in about.html files in the respective subdirectories.
  
====How is the Eclipse Web Tools platformed licenesed?====
+
===How do I install WTP?===
The Eclipse Web Tools Platform consists of software produced by the Eclipse Project combined with third party software from other open source projects. The software produced by the Eclipse Project is made available under the Eclipse Public License. Third party components are made available under their own licenses. The detailed licensing information can be found in the Eclipse.org Software User Agreement (notice.html) file in the root directory of the SDK download. Licensing for third party components is described in about.html files in the respective subdirectories.
+
'''If you don't already have Eclipse''', the simplest way is to download the latest '''Eclipse IDE for Java EE Developers''' from [http://download.eclipse.org/ download.eclipse.org].
  
====How can I tell what is new and noteworthy within an specific release?====
+
'''If you do already have Eclipse up and running''', Kepler and later versions can install WTP through the [https://marketplace.eclipse.org/content/eclipse-java-ee-developer-tools-0 Marketplace].
To be filled in.
+
  
====How can I find a list of known problems with a release?====
+
Otherwise, within Eclipse, go to the '''Help''' menu, choose '''Install New Software''', and while Working With '''All Available Sites''', choose the features you want from the ''Web, XML, Java EE and OSGi Enterprise Development'' category.  If unsure, pick both the ''Eclipse Java EE Developer Tools'' and ''JST Server Adapters Extensions'' and proceed, allowing it to select dependencies for you.  For more complete steps on installing software, consult the Workbench User Guide Task:[http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.user/tasks/tasks-129.htm Updating and Installing Software].
To be filled in.
+
  
====Why am I getting a java.lang.OutOfMemoryError: PermGen space?====
+
For those certain that they only want to install selected parts of WTP, the ''Eclipse XML Editors and Tools'' selection is exactly as named, while the ''Eclipse Web Developer Tools'' builds on that with HTML, CSS, and JavaScript tools, and supports deployable "static" web projects. The ''Eclipse Java Web Developer Tools'' adds support for JSP files (but not Java Servlets), and complete support for "dynamic" web projects requires the full ''Eclipse Java EE Developer Tools'' Feature.
The default maximum PermGen space set by your JRE may be too small. You can increase the maximum PermGen size by launching WTP with VM argument: -XX:MaxPermSize=128m
+
  
Note that this issue only appears to happen using a Sun Java Runtime.  Others runtime environments do not seem to have this issue.
 
  
====After updating to Eclipse Europa why did I get this "can't find view" error?====
+
WTP requires at least '''Java 8''' to be run properly. '''Neon''' is the current supported release.
After updating to Eclipse Europa I restart and get this error:
+
  
'''Problems occurred restoring workbench.
 
  
Could not find view: org.eclipse.wst.rdb.server.ui.navigator.serverExplorer'''
+
WTP releases are incorporated into the simultaneous release sites listed below, with the corresponding version-specific WTP update sites used to provide Sources and WTP Adopter documentation, plus the occasional hotfix.
  
These errors are expected as RDB is not a part of Europa, so the associated RDB views and perspectives are not there. The user can use the new DTP views and perspectives.
+
If the Simultaneous Release Site and corresponding WTP site are not already listed on the '''Available Software Sites''' Preference Page, you can add them manually. Be sure to add both and to not mix versions. For reference:
 +
* Update Sites for [http://download.eclipse.org/releases/neon/ '''Neon (Eclipse 4.6)'''] ''and'' [http://download.eclipse.org/webtools/repository/neon/ '''WTP 3.8''']
 +
''Older releases, '''no longer supported''' by eclipse.org:''
 +
* Update Sites for [http://download.eclipse.org/releases/mars/ '''Mars (Eclipse 4.5)'''] ''and'' [http://download.eclipse.org/webtools/repository/mars/ '''WTP 3.7''']
 +
* Update Sites for [http://download.eclipse.org/releases/luna/ '''Luna (Eclipse 4.4)'''] and [http://download.eclipse.org/webtools/repository/luna/ '''WTP 3.6''']
 +
* Update Sites for [http://download.eclipse.org/releases/kepler/ Kepler (Eclipse 4.3)] and [http://download.eclipse.org/webtools/repository/kepler/ WTP 3.5]
 +
* Update Sites for [http://download.eclipse.org/releases/juno/ Juno (Eclipse 3.8/4.2)] and [http://download.eclipse.org/webtools/repository/juno/ WTP 3.4]
 +
* Update Sites for [http://download.eclipse.org/releases/indigo/ Indigo (Eclipse 3.7/4.1)] and [http://download.eclipse.org/webtools/repository/indigo/ WTP 3.3]
 +
* Update Sites for [http://download.eclipse.org/releases/helios/ Helios (Eclipse 3.6)] and [http://download.eclipse.org/webtools/repository/helios/ WTP 3.2]
 +
* Update Sites for [http://download.eclipse.org/releases/galileo/ Galileo (Eclipse 3.5)] and [http://download.eclipse.org/webtools/repository/galileo/ WTP 3.1]
  
====Who are the contributors to the Eclipse Web Tools Platform Project?====
+
Manual installation (only recommended for adopters and WTP contributors):
We have a [http://www.eclipse.org/webtools/people/contributors.php|whole page]  listing the hard working contributors to this project. See the [http://www.eclipse.org/webtools/faq/CommitterFAQ.php|Committer FAQ] if you are a committer.
+
* The Web Tools Platform has several required projects that '''must all''' be installed for proper operation. Each WTP build is built and tested with specific versions of these prerequisites (see the '''Requirements and Handy Extras''' section on each specific build's download page) and it is recommended that only those versions be installed and active when used with a particular WTP build. The WTP download page for each build details the complete list of requirements and provides links to download the corresponding versions. Downloading and unpacking each should place its contents into a folder named eclipse.
 +
** Unpack the Eclipse SDK ''into a clean directory''
 +
** Unpack the Graphical Editor Framework (GEF) into the same location
 +
** Unpack the Eclipse Modeling Framework (EMF) / XML Schema Infoset Model (XSD) into the same location
 +
** Unpack the Data Tools Platform (DTP) into the same location
 +
** Unpack EMF Transaction into the same location
 +
** Unpack EMF Validation into the same location
 +
** Unpack Graphiti into the same location
 +
** Unpack the [http://download.eclipse.org/webtools/downloads/ Web Tools Platform build] into the same location
 +
WTP should now be installed. Launch Eclipse with the -clean option one time to ensure all plug-ins are detected properly and that P2 records a new configuration.
  
====What version of Eclipse does WTP work with?====
+
A [http://www.eclipse.org/org/june05release/screencasts/5-webToolsInstallation/webToolsInstallation.html screencast] that includes setting up Xdoclet and a JBoss 3.x test server is also available.
* WTP 1.0.x supports Eclipse 3.1.x.
+
* WTP 1.5.x supports Eclipse 3.2.
+
* WTP 2.0 is planned for Eclipse 3.3.
+
  
To use WTP with Eclipse 2.1.x see the IBM alphaWorks project IBM Web Tools for Eclipse.
+
===Which zip file should I download?===
 +
The WTP SDK (wtp-sdk-*.zip) includes everything produced by the WTP project, including source and both user and programmer documentation. '''If you aren't sure which download you need, you should probably get the WTP-SDK.'''
  
====Which zip file should I download?====
+
The software development kit (SDK) downloads are for developers wishing to build solutions on top of the Web Tools Platform, while the non-SDK downloads are suitable for everyone else's use. The project also provides various other builds for easier use by other projects and adopters.
The WTP SDK (wtp-sdk-*.zip) includes both the [http://www.eclipse.org/webtools/main.html|Web Standard Tools]  and [http://www.eclipse.org/webtools/jst/main.html|J2EE Standard Tools], including source and both user and programmer documentation. '''If you aren't sure which download you need, you should probably get the SDK.'''
+
  
The software development kit (SDK) downloads are for developers wishing to build solutions on top of the Web Tools Platform, while the non-SDK (e.g.: wtp-0.7.zip) downloads are suitable for everyone else's use. The project also provides separate builds of the [http://www.eclipse.org/webtools/wst/main.html|Web Standard Tools] (wtp-wst-*.zip) by themselves for those uninterested in the tooling for J2EE standards.
+
===How can I tell what is new and noteworthy within an specific release?===
 +
All of the [http://www.eclipse.org/webtools/development/news/ ''New and Noteworthy''] documents can be found on the main web site. A new set of documents is usually prepared for each Milestone and collected together for each Release.
  
===Data Tools===
+
===How can I find a list of known problems with a release?===
 +
While there may be specific Release Notes added for [http://www.eclipse.org/webtools/releases/ the latest release], what is in Bugzilla is generally regarded as complete.  Remember: unless a bug report is filed for a problem, '''no one''' will have a chance to fix it.
  
===J2EE===
+
===Why am I getting a java.lang.OutOfMemoryError: PermGen space?===
 +
The default maximum ''Permanent Generation'' space set by your JRE may be too small.  This is unrelated to the maximum allowed ''Heap'' space.  You can increase the maximum PermGen size by launching Eclipse with the VM argument: <code>-XX:MaxPermSize=128m</code>
  
===Server/Internet===
+
Note that this issue only appears to happen using a Sun/Oracle Java Runtime.  Others runtime environments do not seem to have this issue, or may themselves use different methods to control their maximum allowed PermGen size.
  
===Web===
+
===Who are the contributors to the Eclipse Web Tools Platform Project?===
 +
We have a [http://www.eclipse.org/webtools/people/contributors.php whole page]  listing the hard working contributors to this project. See the [http://www.eclipse.org/webtools/faq/CommitterFAQ.php Committer FAQ] if you are a committer.
  
===Web Services===
+
===What version of Eclipse does WTP work with?===
 +
* '''WTP 3.8 runs on Eclipse 4.6 (a.k.a. Neon).  Neon is the supported release.'''
 +
* WTP 3.7 runs on Eclipse 4.5 (a.k.a. Mars).
 +
* WTP 3.6 runs on Eclipse 4.4 (a.k.a. Luna, 2014).
 +
* WTP 3.5 runs on Eclipse 4.3 (a.k.a. Kepler, 2013).
 +
* WTP 3.4 runs on Eclipse 3.8/4.2 (a.k.a. Juno if it's 4.2, 2012).
 +
* WTP 3.3 runs on Eclipse 3.7 (a.k.a. Indigo, 2011)
 +
* WTP 3.2 runs on Eclipse 3.6 (a.k.a. Helios, 2010).
 +
* WTP 3.1 runs on Eclipse 3.5 (a.k.a. Galileo, 2009).
 +
* WTP 3.0.x runs on Eclipse 3.4 (a.k.a. Ganymede, 2008).
 +
* WTP 2.0.x runs on Eclipse 3.3 (a.k.a. Europa, 2007).
 +
* WTP 1.5.x runs on Eclipse 3.2 (a.k.a. Callisto, 2006).
 +
* WTP 1.0.x runs on Eclipse 3.1.x. (2005)
  
===XML===
+
===Are there any WTP tutorials available?===
 +
Yes! See the [http://www.eclipse.org/webtools/community/communityresources.php WTP Community Resources] page.
 +
 
 +
===How do I install WTP Source, after I've installed the Eclipse IDE for Java EE Developers?===
 +
Generally, you'll find the Source Features in the release-specific repository listed in the installation instructions, [[WTP_FAQ#How_do_I_install_WTP.3F]].
 +
For the Ganymede release, there are instructions provided at this [http://www.eclipse.org/webtools/faq/GettingSource/ Getting Source] link.  Check the [http://download.eclipse.org/webtools/repository/helios/ Helios-specific repository] for the sources in that version.
 +
 
 +
==Data Tools==
 +
 
 +
===Where can I find the WTP Data Tools?===
 +
WTP adopted the [http://eclipse.org/datatools/ Data Tools Platform] project as of WTP 2.0.
 +
 
 +
==Java EE==
 +
 
 +
===Where can I find the New J2EE Web Module wizard?===
 +
J2EE Web Module has been renamed Dynamic Web Project.
 +
 
 +
===Does the WTP include a visual JSP editor?===
 +
Yes!  Check the '''Open With...''' context menu on your web pages for the '''Web Page Editor'''.
 +
 
 +
===How do I install XDoclet in WTP?===
 +
To install XDoclet:
 +
# Download XDoclet from  http://sourceforge.net/project/showfiles.php?group_id=31602.
 +
# Unzip XDoclet to a directory on your machine such as C:\XDoclet
 +
# Specify the directory in which XDoclet is located in Window->Preferences->J2EE Annotations->XDoclet.
 +
 
 +
===What types of EJBs does WTP support?===
 +
WTP supports entity, session and messages driven beans. Support for the Java Persistence API (JPA) is available from the [http://www.eclipse.org/webtools/dali/ Eclipse Dali Project].
 +
 
 +
===How do I include Java classpath entries in a Java EE project's published/exported module structure?===
 +
 
 +
Publish/export support for classpath entries was introduced in WTP 2.0 and is explained in detail here: [[ClasspathEntriesPublishExportSupport]].  WTP 3.2 and newer make use of the project's '''Deployment Assembly''' properties page.
 +
 
 +
==JSP==
 +
===How do I use my tag libraries in the JSP editor?  I don't see any place to set them up.===
 +
Place them in the WEB-INF/lib folder of your project (put tag files in WEB-INF/tags), or on the project's '''Java Build Path''' through the '''Deployment Assembly''' properties page, and refer to them as you would on an actual server.  While the '''Java Build Path''' itself is enough for the editor, it is the '''Deployment Assembly''' properties page that determines what is usable when you '''Run on Server'''.  Proper taglib directives should then enable custom tags within content assist, validation, and parsing (for custom tags with ''tagdependent'' body content), displayed documentation, and icons in the Outline view and content assist proposals.
 +
 
 +
===Why isn't the JSP editor/validator finding my custom tag libraries?===
 +
If your project's Web Module facet version is set to 2.2 or lower, you will only be able to refer to libaries by their filename or mapped URIs in your web.xml file.  For Dynamic Web Projects, the tag libraries '''must''' be either on the '''Java Build Path''' or under the ''WebContent'' folder(s).  For projects lacking the Dynamic Web Module Facet where the the Module Core Nature ''has'' been configured, its information will be used.  Otherwise, whichever parent folder of the JSP file that is [[also]] the parent of WEB-INF/ is treated as the root of the web application.  In most situations, placing the tag lbirary's jar onto the Java Build Path is the easiest way to make it usable.
 +
 
 +
For "well known" tag libraries that may be incorporated within a server runtime and not otherwise found, the ''XML Catalog'' may also be used to register URIs for a specified TLD file on disk.
 +
 
 +
===Where can I find out more about the Tomcat support in WTP?===
 +
For more information about the support for Tomcat 4.0 through Tomcat 7 in WTP, see this separate [[WTP_Tomcat_FAQ]].
 +
 
 +
===How do I debug JSPs with BEA WebLogic Server 8.x?===
 +
 
 +
BEA WebLogic Server 8.x and earlier do not support JSR-45; WebLogic Server 9.x and later do support JSR-45 so you can debug JSP files with them using WTP (note: there are outstanding issues with JSP source lookup for the WLS Generic adapter in WTP 0.7 - see [http://bugs.eclipse.org/104401 bug 104401]).
 +
 
 +
===How do I debug JSPs with Apache Tomcat 4.x?===
 +
Apache Tomcat 4.x and earlier do not support JSR-45; Tomcat 5.x and later do support JSR-45 so you can debug JSP files with them using WTP.
 +
 
 +
==Server/Internet==
 +
 
 +
===Where are cached files located?===
 +
The cached files are located in WORKSPACE_DIR/.metadata/.plugins/org.eclipse.wst.internet.cache. The entries are all named with numbers but you can see the mappings in the cache.xml file located in the same directory.
 +
 
 +
==Web==
 +
 
 +
===Why does the HTML editor show a validation error if I don't use closing </p> or </br> tags?===
 +
You're likely editing an XHTML file which requires that the file be well formed XML.
 +
 
 +
===Does WTP's JavaScript editor report syntax errors?===
 +
Yes, the JavaScript Development Tools (JSDT) available in WTP 3.0 and newer provides a Validator.  For projects that are not already JavaScript projects, use the project's '''Configure''' context menu to make it a JavaScript project.  For JavaScript in web pages, you will need the Validation Builder installed on a project as well (check the project Properties dialog).
 +
 
 +
==Web Services==
 +
 
 +
===Can the WSDL validator be extended to validate extension elements, for example partnerLinks and properties from the WS-BPEL specification?===
 +
Yes! The WSDL validator has extension points (which should all be considered internal, non-API at this point) which allow you to plug your own extension validator for a given namespace into the WSDL validator.
 +
 
 +
In this case, you can create a validator for the WS-BPEL namespace and plug-it into the WSDL validator. Your validator will get called any time an element from the WS-BPEL namespace is encountered.
 +
 
 +
The WSDL HTTP validator and SOAP validator both use this extension mechanism. To contribute your validator to the WSDL validator you need to specify an entry in your plugin manifest as follows:
 +
(I'm assuming http://schemas.xmlsoap.org/ws/2004/03/business-process/ is the BPEL namespace.)
 +
 
 +
<source lang="xml">
 +
<extension point="org.eclipse.wst.wsdl.validation.wsdl11validator">
 +
    <wsdl11validator
 +
            class="org.example.WSBPELValidator"
 +
            namespace="http://schemas.xmlsoap.org/ws/2004/03/business-process/"
 +
            resourcebundle="wsbpelvalidator"/>
 +
</extension>
 +
</source>
 +
 
 +
===Why does WTP produce errors for multiple import statements for the same namespace in WSDL 1.1?===
 +
The [http://schemas.xmlsoap.org/wsdl/ WSDL 1.1] schema restricts wsdl:import statements by specifying that they must contain unique namespaces. This means one import per namespace per WSDL document.
 +
 
 +
===What are the list of known problems for Axis2 Web services in WTP 2.0?===
 +
Here are the list of major known bugs for Axis2 Web services in WTP 2.0:
 +
 
 +
* [http://bugs.eclipse.org/184301 184301] - Ant task not supported for Axis2 Web service. The workaround is to use the Web services wizard instead.
 +
* [http://bugs.eclipse.org/187840 187840] - InvocationTargetException in Axis2 scenario. The workaround is to retry the scenario or to exit and re-enter the workbench.
 +
* [http://bugs.eclipse.org/186429 186429] - Validation of Axis2 JSP is slow. The workaround is to turn off JSP validation in the Preferences.
 +
* [http://bugs.eclipse.org/192522 192522] - FileNotFoundException copying to build/classes directory. The workaround is to set Java output directory to build/classes or apply the patch attached to the bug.
 +
* [http://bugs.eclipse.org/194786 194786] - Problem running Axis2 servlet on server with different servlet level. The workaround is to delete servletapi-2.3.jar from the WebContent/WEB-INF/lib directory and restart the WAR or EAR.
 +
* [http://bugs.eclipse.org/192280 192280] - RPC/encoded not supported in Axis2 client and skeleton scenario.
 +
* [http://bugs.eclipse.org/193593 193593] - Custom namespace to package mapping not working.
 +
* [http://bugs.eclipse.org/193996 193996] - Unable to select ports and services for client or skeleton.
 +
* [http://bugs.eclipse.org/184627 184627] - Error deleting Axis2 project. The workaround is to stop the server first and then remove the project from the server before deleting the project.
 +
 
 +
==XML==
 +
 
 +
===How do I use my own filename extensions in the XML editor? It only works correctly if a file ends with .xml.===
 +
 
 +
''Note: this also applies to the JSP and HTML editors and others in WTP, plus PDT's PHP Editor''
 +
 
 +
Open the '''Content Types''' preference page and expand the '''Content types''' tree until you find the existing content type you want to treat the new filename extension as. Adding the new filename extension to the list of '''File associations''' "teaches" Eclipse about that filename extension so that features such as Validation and Task Tag detection also support those files correctly.
 +
 
 +
===How do I programmatically add entries to the XML catalog?===
 +
The XML catalog extension point schema contains specific definitions of how to use the extension point. You can view the schema here.
 +
 
 +
For easier viewing, checkout the org.eclipse.wst.xml.core plugin from the repository and view this file with the Eclipse extension schema editor.
 +
 
 +
===Why does the XML catalog preference dialog only show URI Key type entry when no file is selected?===
 +
As Public ID and System ID are only applicable to DTD entity resolution in order to see these options in addition to URI for the Key Type choice you must first select a DTD file.
 +
 
 +
When you select an XSD file you will see Namespace Name and Schema Location for the Key Type selection.
 +
 
 +
[[Category:FAQ]]
 +
[[Category:Web Tools Platform FAQs| ]]
 +
[[Category:XML Tools ]]

Revision as of 23:24, 31 August 2016

Contents

Eclipse Web Tools Frequent Asked Questions

Many of the FAQ's found on this page have been pulled from the WTP newsgroup. Thank you to everyone that took the time to answer these questions.

Looking for FAQ's related to the development of WTP? See the Committer FAQ.

If you have identified a FAQ that is not in this list, please add it to the list. You will need a bugzilla user id in order to edit the page.

General

How is the Eclipse Web Tools Platform licensed?

The Eclipse Web Tools Platform (WTP) consists of software produced by the Eclipse Project combined with third party software from other open source projects. The software produced by the Eclipse Project is made available under the Eclipse Public License. Third party components are made available under their own licenses. The detailed licensing information can be found in the Eclipse.org Software User Agreement (notice.html) file in the root directory of the SDK download. Licensing for third party components is described in about.html files in the respective subdirectories.

How do I install WTP?

If you don't already have Eclipse, the simplest way is to download the latest Eclipse IDE for Java EE Developers from download.eclipse.org.

If you do already have Eclipse up and running, Kepler and later versions can install WTP through the Marketplace.

Otherwise, within Eclipse, go to the Help menu, choose Install New Software, and while Working With All Available Sites, choose the features you want from the Web, XML, Java EE and OSGi Enterprise Development category. If unsure, pick both the Eclipse Java EE Developer Tools and JST Server Adapters Extensions and proceed, allowing it to select dependencies for you. For more complete steps on installing software, consult the Workbench User Guide Task:Updating and Installing Software.

For those certain that they only want to install selected parts of WTP, the Eclipse XML Editors and Tools selection is exactly as named, while the Eclipse Web Developer Tools builds on that with HTML, CSS, and JavaScript tools, and supports deployable "static" web projects. The Eclipse Java Web Developer Tools adds support for JSP files (but not Java Servlets), and complete support for "dynamic" web projects requires the full Eclipse Java EE Developer Tools Feature.


WTP requires at least Java 8 to be run properly. Neon is the current supported release.


WTP releases are incorporated into the simultaneous release sites listed below, with the corresponding version-specific WTP update sites used to provide Sources and WTP Adopter documentation, plus the occasional hotfix.

If the Simultaneous Release Site and corresponding WTP site are not already listed on the Available Software Sites Preference Page, you can add them manually. Be sure to add both and to not mix versions. For reference:

Older releases, no longer supported by eclipse.org:

Manual installation (only recommended for adopters and WTP contributors):

  • The Web Tools Platform has several required projects that must all be installed for proper operation. Each WTP build is built and tested with specific versions of these prerequisites (see the Requirements and Handy Extras section on each specific build's download page) and it is recommended that only those versions be installed and active when used with a particular WTP build. The WTP download page for each build details the complete list of requirements and provides links to download the corresponding versions. Downloading and unpacking each should place its contents into a folder named eclipse.
    • Unpack the Eclipse SDK into a clean directory
    • Unpack the Graphical Editor Framework (GEF) into the same location
    • Unpack the Eclipse Modeling Framework (EMF) / XML Schema Infoset Model (XSD) into the same location
    • Unpack the Data Tools Platform (DTP) into the same location
    • Unpack EMF Transaction into the same location
    • Unpack EMF Validation into the same location
    • Unpack Graphiti into the same location
    • Unpack the Web Tools Platform build into the same location

WTP should now be installed. Launch Eclipse with the -clean option one time to ensure all plug-ins are detected properly and that P2 records a new configuration.

A screencast that includes setting up Xdoclet and a JBoss 3.x test server is also available.

Which zip file should I download?

The WTP SDK (wtp-sdk-*.zip) includes everything produced by the WTP project, including source and both user and programmer documentation. If you aren't sure which download you need, you should probably get the WTP-SDK.

The software development kit (SDK) downloads are for developers wishing to build solutions on top of the Web Tools Platform, while the non-SDK downloads are suitable for everyone else's use. The project also provides various other builds for easier use by other projects and adopters.

How can I tell what is new and noteworthy within an specific release?

All of the New and Noteworthy documents can be found on the main web site. A new set of documents is usually prepared for each Milestone and collected together for each Release.

How can I find a list of known problems with a release?

While there may be specific Release Notes added for the latest release, what is in Bugzilla is generally regarded as complete. Remember: unless a bug report is filed for a problem, no one will have a chance to fix it.

Why am I getting a java.lang.OutOfMemoryError: PermGen space?

The default maximum Permanent Generation space set by your JRE may be too small. This is unrelated to the maximum allowed Heap space. You can increase the maximum PermGen size by launching Eclipse with the VM argument: -XX:MaxPermSize=128m

Note that this issue only appears to happen using a Sun/Oracle Java Runtime. Others runtime environments do not seem to have this issue, or may themselves use different methods to control their maximum allowed PermGen size.

Who are the contributors to the Eclipse Web Tools Platform Project?

We have a whole page listing the hard working contributors to this project. See the Committer FAQ if you are a committer.

What version of Eclipse does WTP work with?

  • WTP 3.8 runs on Eclipse 4.6 (a.k.a. Neon). Neon is the supported release.
  • WTP 3.7 runs on Eclipse 4.5 (a.k.a. Mars).
  • WTP 3.6 runs on Eclipse 4.4 (a.k.a. Luna, 2014).
  • WTP 3.5 runs on Eclipse 4.3 (a.k.a. Kepler, 2013).
  • WTP 3.4 runs on Eclipse 3.8/4.2 (a.k.a. Juno if it's 4.2, 2012).
  • WTP 3.3 runs on Eclipse 3.7 (a.k.a. Indigo, 2011)
  • WTP 3.2 runs on Eclipse 3.6 (a.k.a. Helios, 2010).
  • WTP 3.1 runs on Eclipse 3.5 (a.k.a. Galileo, 2009).
  • WTP 3.0.x runs on Eclipse 3.4 (a.k.a. Ganymede, 2008).
  • WTP 2.0.x runs on Eclipse 3.3 (a.k.a. Europa, 2007).
  • WTP 1.5.x runs on Eclipse 3.2 (a.k.a. Callisto, 2006).
  • WTP 1.0.x runs on Eclipse 3.1.x. (2005)

Are there any WTP tutorials available?

Yes! See the WTP Community Resources page.

How do I install WTP Source, after I've installed the Eclipse IDE for Java EE Developers?

Generally, you'll find the Source Features in the release-specific repository listed in the installation instructions, WTP_FAQ#How_do_I_install_WTP.3F. For the Ganymede release, there are instructions provided at this Getting Source link. Check the Helios-specific repository for the sources in that version.

Data Tools

Where can I find the WTP Data Tools?

WTP adopted the Data Tools Platform project as of WTP 2.0.

Java EE

Where can I find the New J2EE Web Module wizard?

J2EE Web Module has been renamed Dynamic Web Project.

Does the WTP include a visual JSP editor?

Yes! Check the Open With... context menu on your web pages for the Web Page Editor.

How do I install XDoclet in WTP?

To install XDoclet:

  1. Download XDoclet from http://sourceforge.net/project/showfiles.php?group_id=31602.
  2. Unzip XDoclet to a directory on your machine such as C:\XDoclet
  3. Specify the directory in which XDoclet is located in Window->Preferences->J2EE Annotations->XDoclet.

What types of EJBs does WTP support?

WTP supports entity, session and messages driven beans. Support for the Java Persistence API (JPA) is available from the Eclipse Dali Project.

How do I include Java classpath entries in a Java EE project's published/exported module structure?

Publish/export support for classpath entries was introduced in WTP 2.0 and is explained in detail here: ClasspathEntriesPublishExportSupport. WTP 3.2 and newer make use of the project's Deployment Assembly properties page.

JSP

How do I use my tag libraries in the JSP editor? I don't see any place to set them up.

Place them in the WEB-INF/lib folder of your project (put tag files in WEB-INF/tags), or on the project's Java Build Path through the Deployment Assembly properties page, and refer to them as you would on an actual server. While the Java Build Path itself is enough for the editor, it is the Deployment Assembly properties page that determines what is usable when you Run on Server. Proper taglib directives should then enable custom tags within content assist, validation, and parsing (for custom tags with tagdependent body content), displayed documentation, and icons in the Outline view and content assist proposals.

Why isn't the JSP editor/validator finding my custom tag libraries?

If your project's Web Module facet version is set to 2.2 or lower, you will only be able to refer to libaries by their filename or mapped URIs in your web.xml file. For Dynamic Web Projects, the tag libraries must be either on the Java Build Path or under the WebContent folder(s). For projects lacking the Dynamic Web Module Facet where the the Module Core Nature has been configured, its information will be used. Otherwise, whichever parent folder of the JSP file that is also the parent of WEB-INF/ is treated as the root of the web application. In most situations, placing the tag lbirary's jar onto the Java Build Path is the easiest way to make it usable.

For "well known" tag libraries that may be incorporated within a server runtime and not otherwise found, the XML Catalog may also be used to register URIs for a specified TLD file on disk.

Where can I find out more about the Tomcat support in WTP?

For more information about the support for Tomcat 4.0 through Tomcat 7 in WTP, see this separate WTP_Tomcat_FAQ.

How do I debug JSPs with BEA WebLogic Server 8.x?

BEA WebLogic Server 8.x and earlier do not support JSR-45; WebLogic Server 9.x and later do support JSR-45 so you can debug JSP files with them using WTP (note: there are outstanding issues with JSP source lookup for the WLS Generic adapter in WTP 0.7 - see bug 104401).

How do I debug JSPs with Apache Tomcat 4.x?

Apache Tomcat 4.x and earlier do not support JSR-45; Tomcat 5.x and later do support JSR-45 so you can debug JSP files with them using WTP.

Server/Internet

Where are cached files located?

The cached files are located in WORKSPACE_DIR/.metadata/.plugins/org.eclipse.wst.internet.cache. The entries are all named with numbers but you can see the mappings in the cache.xml file located in the same directory.

Web

Why does the HTML editor show a validation error if I don't use closing </p> or </br> tags?

You're likely editing an XHTML file which requires that the file be well formed XML.

Does WTP's JavaScript editor report syntax errors?

Yes, the JavaScript Development Tools (JSDT) available in WTP 3.0 and newer provides a Validator. For projects that are not already JavaScript projects, use the project's Configure context menu to make it a JavaScript project. For JavaScript in web pages, you will need the Validation Builder installed on a project as well (check the project Properties dialog).

Web Services

Can the WSDL validator be extended to validate extension elements, for example partnerLinks and properties from the WS-BPEL specification?

Yes! The WSDL validator has extension points (which should all be considered internal, non-API at this point) which allow you to plug your own extension validator for a given namespace into the WSDL validator.

In this case, you can create a validator for the WS-BPEL namespace and plug-it into the WSDL validator. Your validator will get called any time an element from the WS-BPEL namespace is encountered.

The WSDL HTTP validator and SOAP validator both use this extension mechanism. To contribute your validator to the WSDL validator you need to specify an entry in your plugin manifest as follows: (I'm assuming http://schemas.xmlsoap.org/ws/2004/03/business-process/ is the BPEL namespace.)

<extension point="org.eclipse.wst.wsdl.validation.wsdl11validator">
    <wsdl11validator
            class="org.example.WSBPELValidator"
            namespace="http://schemas.xmlsoap.org/ws/2004/03/business-process/"
            resourcebundle="wsbpelvalidator"/>
</extension>

Why does WTP produce errors for multiple import statements for the same namespace in WSDL 1.1?

The WSDL 1.1 schema restricts wsdl:import statements by specifying that they must contain unique namespaces. This means one import per namespace per WSDL document.

What are the list of known problems for Axis2 Web services in WTP 2.0?

Here are the list of major known bugs for Axis2 Web services in WTP 2.0:

  • 184301 - Ant task not supported for Axis2 Web service. The workaround is to use the Web services wizard instead.
  • 187840 - InvocationTargetException in Axis2 scenario. The workaround is to retry the scenario or to exit and re-enter the workbench.
  • 186429 - Validation of Axis2 JSP is slow. The workaround is to turn off JSP validation in the Preferences.
  • 192522 - FileNotFoundException copying to build/classes directory. The workaround is to set Java output directory to build/classes or apply the patch attached to the bug.
  • 194786 - Problem running Axis2 servlet on server with different servlet level. The workaround is to delete servletapi-2.3.jar from the WebContent/WEB-INF/lib directory and restart the WAR or EAR.
  • 192280 - RPC/encoded not supported in Axis2 client and skeleton scenario.
  • 193593 - Custom namespace to package mapping not working.
  • 193996 - Unable to select ports and services for client or skeleton.
  • 184627 - Error deleting Axis2 project. The workaround is to stop the server first and then remove the project from the server before deleting the project.

XML

How do I use my own filename extensions in the XML editor? It only works correctly if a file ends with .xml.

Note: this also applies to the JSP and HTML editors and others in WTP, plus PDT's PHP Editor

Open the Content Types preference page and expand the Content types tree until you find the existing content type you want to treat the new filename extension as. Adding the new filename extension to the list of File associations "teaches" Eclipse about that filename extension so that features such as Validation and Task Tag detection also support those files correctly.

How do I programmatically add entries to the XML catalog?

The XML catalog extension point schema contains specific definitions of how to use the extension point. You can view the schema here.

For easier viewing, checkout the org.eclipse.wst.xml.core plugin from the repository and view this file with the Eclipse extension schema editor.

Why does the XML catalog preference dialog only show URI Key type entry when no file is selected?

As Public ID and System ID are only applicable to DTD entity resolution in order to see these options in addition to URI for the Key Type choice you must first select a DTD file.

When you select an XSD file you will see Namespace Name and Schema Location for the Key Type selection.

Back to the top