<?xml version="1.0" encoding="utf-8"?>
<!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. </shortdesc>
<prolog><metadata>
<keywords><indexterm>J2EE development<indexterm>project facets</indexterm></indexterm>
<indexterm>J2EE modules<indexterm>project facets</indexterm></indexterm><indexterm>projects<indexterm>facets<indexterm>overview</indexterm></indexterm
></indexterm><indexterm>facets<indexterm>overview</indexterm></indexterm>
</keywords>
</metadata></prolog>
<conbody outputclass="id_conbody">
<p outputclass="anchor_topictop"></p>
<p>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>