<?xml version="1.0" encoding="utf-8"?> | |
<!--Arbortext, Inc., 1988-2006, v.4002--> | |
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" | |
"concept.dtd"> | |
<concept id="cfacets" xml:lang="en-us"> | |
<title outputclass="id_title">Project facets</title> | |
<shortdesc outputclass="id_shortdesc">Facets define characteristics and requirements | |
for J2EE projects and are used as part of the runtime configuration. </shortdesc> | |
<prolog><metadata> | |
<keywords><indexterm>J2EE<indexterm>project facets</indexterm></indexterm> | |
<indexterm>JavaServer Faces (JSF)<indexterm>project facets</indexterm></indexterm> | |
<indexterm>projects<indexterm>facets<indexterm>overview</indexterm></indexterm></indexterm> | |
</keywords> | |
</metadata></prolog> | |
<conbody outputclass="id_conbody"> | |
<p outputclass="anchor_topictop"></p> | |
<p id="aboutfacet">When you add a facet to a project, that project is configured | |
to perform a certain task, fulfill certain requirements, or have certain characteristics. | |
For example, the EAR facet sets up a project to function as an enterprise | |
application by adding a deployment descriptor and setting up the project's | |
classpath.</p> | |
<p>You can add facets only to J2EE projects and other types of projects that | |
are based on J2EE projects, such as enterprise application projects, dynamic | |
Web projects, and EJB projects. You cannot add facets to a <tm tmclass="special" | |
tmowner="Sun Microsystems, Inc." tmtype="tm" trademark="Java">Java</tm> project | |
or plug-in project, for example. Typically, a facet-enabled project has at | |
least one facet when it is created, allowing you to add more facets if necessary. | |
For example, a new EJB project has the EJB Module facet. You can then add | |
other facets to this project like the EJBDoclet (XDoclet) facet. To add a | |
facet to a project, see <xref href="taddingfacet.dita"></xref>.</p> | |
<p>Some facets require other facets as prerequisites. Other facets cannot | |
be in the same project together. For example, you cannot add the Dynamic Web | |
Module facet to an EJB project because the EJB project already has the EJB | |
Module facet. Some facets can be removed from a project and others cannot.</p> | |
<p>Facets also have version numbers. You can change the version numbers of | |
facets as long as you stay within the requirements for the facets. To change | |
the version number of a facet, see <xref href="tchangefacet.dita"></xref>.</p> | |
<p outputclass="anchor_topicbottom"></p> | |
</conbody> | |
</concept> |