blob: 91d2f418048bf121a345c5fc40ffd01458373bfa [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="Copyright (c) 2000, 2009 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/. Contributors: IBM Corporation - initial API and implementation" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2009" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta content="concept" name="DC.Type" />
<meta name="DC.Title" content="Project facets" />
<meta name="abstract" content="Facets define characteristics and requirements for Java EE projects and are used as part of the runtime configuration." />
<meta name="description" content="Facets define characteristics and requirements for Java EE projects and are used as part of the runtime configuration." />
<meta content="Java EE, project facets, JavaServer Faces (JSF), projects, facets, overview" name="DC.subject" />
<meta content="Java EE, project facets, JavaServer Faces (JSF), projects, facets, overview" name="keywords" />
<meta scheme="URI" name="DC.Relation" content="../topics/cjearproj.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tjear.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tjappproj.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tjrar.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/taddingfacet.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tchangejavalevel.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tchangefacet.html" />
<meta content="XHTML" name="DC.Format" />
<meta content="cfacets" name="DC.Identifier" />
<meta content="en-us" name="DC.Language" />
<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
<title>Project facets</title>
</head>
<body id="cfacets"><a name="cfacets"><!-- --></a>
<h1 class="id_title">Project facets</h1>
<div class="id_conbody"><p class="id_shortdesc">Facets define characteristics and requirements
for Java EE projects and are used as part of the runtime configuration. </p>
<p class="anchor_topictop" />
<p id="cfacets__aboutfacet"><a name="cfacets__aboutfacet"><!-- --></a>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 Java EE 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 Java™ 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 <a href="taddingfacet.html" title="This topic explains how to add a facet&#10;to an existing project in your workspace.">Adding a facet to a Java EE project</a>.</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 <a href="tchangefacet.html" title="You can change the version of a facet&#10;in a Java EE project by editing the facets for the project.">Changing the version of a facet</a>.</p>
<p class="anchor_topicbottom" />
</div>
<div><div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="../topics/cjearproj.html" title="An enterprise application project ties together the resources that are required to deploy a J2EE enterprise application.">Enterprise application projects</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="../topics/tjear.html" title="Using the wizard to create an enterprise application project allows you to package many web applications and modules in a project and deploy these modules as a J2EE enterprise application.">Creating an enterprise application project</a></div>
<div><a href="../topics/tjappproj.html" title="You can use a wizard to create a new application client project and add it to a new or existing enterprise application project.">Creating an application client project</a></div>
<div><a href="../topics/tjrar.html" title="A connector is a J2EE standard extension mechanism for containers to provide connectivity to enterprise information systems (EISs).">Creating a connector project</a></div>
<div><a href="../topics/taddingfacet.html" title="This topic explains how to add a facet to an existing project in your workspace.">Adding a facet to a Java EE project</a></div>
<div><a href="../topics/tchangejavalevel.html" title="You can change the version of Java used in a Java EE project by changing the value of the Java facet.">Changing the Java compiler version for a Java EE project</a></div>
<div><a href="../topics/tchangefacet.html" title="You can change the version of a facet in a Java EE project by editing the facets for the project.">Changing the version of a facet</a></div>
</div>
</div>
</body>
</html>