blob: 20a86564166a2beed5108cec7a31ebbd83b8f59f [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, 2006 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 http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2006" />
<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="task" name="DC.Type" />
<meta name="DC.Title" content="Adding a facet to a J2EE project" />
<meta name="abstract" content="This topic explains how to add a facet to an existing project in your workspace." />
<meta name="description" content="This topic explains how to add a facet to an existing project in your workspace." />
<meta content="projects, facets, adding, removing" name="DC.subject" />
<meta content="projects, facets, adding, removing" name="keywords" />
<meta scheme="URI" name="DC.Relation" content="../topics/tchangejavalevel.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tchangefacet.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/cfacets.html" />
<meta content="XHTML" name="DC.Format" />
<meta content="taddingfacet" 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>Adding a facet to a J2EE project</title>
</head>
<body id="taddingfacet"><a name="taddingfacet"><!-- --></a>
<h1 class="topictitle1" id="title">Adding a facet to a J2EE project</h1>
<div id="taskbody"><div id="shortdesc">This topic explains how to add a facet
to an existing project in your workspace.</div>
<div class="section" id="context"><anchor id="topictop"></anchor><p>New projects
generally have facets added to them when they are created. To add another
facet to a project that already exists, follow these steps:</p>
</div>
<ol id="steps">
<li class="stepexpand"><span>In the Project Explorer view, right-click the project and then
click <span class="uicontrol">Properties</span>.</span></li>
<li class="stepexpand"><span>In the Properties window, click <span class="uicontrol">Project Facets</span>.</span>
The Project Facets page lists the facets in the project.
</li>
<li class="stepexpand"><span>Click <span class="uicontrol">Add/Remove Project Facets</span>.</span></li>
<li class="stepexpand"><span>In the Add/Remove Project Facets window, select the check boxes
next to the facets you want this project to have.</span> <div class="p">Only the facets
that are valid for the project are listed:<ul>
<li>The list of runtimes selected for the project limits the facets shown
in the list. Only the facets compatible with all selected target runtimes
are shown.</li>
<li>The currently selected facets and their version numbers limit the other
facets shown in the list. For example, if the project contains the Dynamic
Web Module facet, the EJB Module facet is not listed because these two facets
cannot be in the same project.</li>
</ul>
You can find out more about the requirements and limitations for each
facet by right-clicking the facet name and then clicking <span class="uicontrol">Show Constraints</span>.</div>
<p>You
can also choose a preset combination of facets from the <span class="uicontrol">Presets</span> list.</p>
</li>
<li class="stepexpand"><span>Choose a version number for the facet by clicking the current version
number and selecting the version number you want from the drop-down list.</span>
</li>
<li class="stepexpand"><span>To remove a facet, clear its check box.</span> Not all facets
can be removed.</li>
<li class="stepexpand"><span>If you want to limit the project so it will be compatible with
one or more runtimes, click the <span class="uicontrol">Show Runtimes</span> button
and select the runtimes that you want the project to be compatible with.</span>
For more information on runtimes, see <a href="tjtargetserver.html" title="When you develop J2EE applications,&#10;you can specify the server runtime environments for your J2EE projects. The&#10;target server is specified during project creation and import, and it can&#10;be changed in the project properties. The target server setting is the default&#10;mechanism for setting the class path for J2EE projects.">Specifying target servers for J2EE projects</a>.
</li>
<li class="stepexpand"><span>Click <span class="uicontrol">Finish</span>.</span></li>
<li class="stepexpand"><span>Click <span class="uicontrol">OK</span>.</span></li>
</ol>
<div class="section" id="postreq"><anchor id="topicbottom"></anchor>
</div>
</div>
<div><div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="../topics/cfacets.html" title="Facets define characteristics and requirements for J2EE projects.">Project facets</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="../topics/tchangejavalevel.html" title="You can change the version of Java used in a J2EE project by changing the value of the Java facet.">Changing the Java compiler version for a J2EE project</a></div>
<div><a href="../topics/tchangefacet.html" title="You can change the version of a facet in a J2EE project by editing the facets for the project.">Changing the version of a facet</a></div>
</div>
</div>
</body>
</html>