| <?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<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>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> |