JSF 2.x Facelets support is integrated in "Eclipse IDE for Enterprise Java Developers" (note the Enterprise, thus not "Eclipse IDE for Java Developers"), since Eclipse Helios (version 3.6, released June 2010). You need to ensure that the JavaServer Faces facet is enabled in Project Facets section of project's properties and is set to a minimum of version 2.0.
This is usually configureable during in new Dynamic Web Project wizard, but when importing non-Eclipse projects or creating non-Dynamic Web Project projects (e.g. Maven archetypes), then you need to manually check/add it.
Once integrated, JSF tag autocomplete is by default available on java.sun.com
XML namespace.
The new xmlns.jcp.org
namespace isn't recognized by default (currently tested Eclipse version is Luna SR2).
The new xmlns.jcp.org
namespace will only work if you've added a physical JSF 2.2 implementation to build path in flavor of a full fledged Java EE container having JSF 2.2 in its modules, integrated via a decent server plugin and set as Targeted Runtimes in project's properties, or a concrete JSF 2.2 implementation JAR file in /WEB-INF/lib
in case of Tomcat and clones (or by adding it as a Maven dependency).
It only still doesn't recognize composites in the new XML namespace. When changing back to java.sun.com
, code completion of composite component tags is back, but code completion of attributes on those tags is not available.
Then I installed JBoss Tools 4.2.3 for Eclipse Luna and enabled the JBoss Tools Knowledge Base in project's properties.
After closing and reopening the Facelet (so JBoss builtin HTML editor gets opened; you can set/configure the editor used by rightclick, Open With), and switching to the Source tab (please don't use Visual editor, this is a disaster), I finally got code completion of attribtues on composite components.
Only the xmlns.jcp.org
still didn't work. It's an Eclipse specific issue and probably already fixed in Mars or newer. You can always hide the composite namespace behind a custom XML namespace as below:
/WEB-INF/my.taglib.xml
<?xml version="1.0" encoding="UTF-8"?>
<facelet-taglib
xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facelettaglibrary_2_2.xsd"
version="2.2"
>
<namespace>http://example.com/my</namespace>
<composite-library-name>components</composite-library-name>
</facelet-taglib>
/WEB-INF/web.xml
<context-param>
<param-name>javax.faces.FACELETS_LIBRARIES</param-name>
<param-value>/WEB-INF/my.taglib.xml</param-value>
</context-param>
So, summarized:
- Enable JSF project facet in project's properties for code completion on composite tags.
- Install JBoss Tools for code completion on attribtues in composite tags.
- Enable JBoss Tools Knowledge base in project's properties.
- Have a physical JSF 2.2 impl JAR in buildpath for
xmlns.jcp.org
support on standard tags.
- Use
java.sun.com
XML namespace domain or a custom taglib (or a newer Eclipse version) on composite tags.