docs/org.eclipse.jst.j2ee.doc.user/topics/tjear.html - gerrit/jeetools/webtools.javaee - Git at Google

 <?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="Creating an enterprise application project" />
 <meta name="abstract" content="" />
 <meta name="description" content="" />
 <meta content="enterprise application projects, creating" name="DC.subject" />
 <meta content="enterprise application projects, creating" name="keywords" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjimpear.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjexpear.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/cjarch.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/cjearproj.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/cjearproj.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddingfacet.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="tjear" 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>Creating an enterprise application project</title>
 </head>
 <body id="tjear"><a name="tjear"><!-- --></a>


 <h1 class="id_title">Creating an enterprise application project</h1>


 <div class="id_taskbody"><p class="id_shortdesc" />

 <div class="id_context"><p class="anchor_topictop">Enterprise
 application projects contain references to the resources needed for enterprise
 applications and can contain a combination of Web modules, JAR files, connector
 modules, EJB modules, and application client modules. An enterprise application
 project is deployed in the form of an EAR file, and is therefore sometimes
 referred to as an EAR project. The modules in an enterprise application project
 are mapped to other J2EE projects. The mapping information is stored in metadata
 files within the enterprise application project. The metadata files are used
 for exporting the project to an EAR file and for running the project on the
 server.</p>
 <p>Like the other types of projects, enterprise application projects
 can contain one or more project facets, which represent units of functionality
 in the project. To be deployed as an EAR file, the new project must have the
 EAR facet. Depending on what you want to use the project for, you may want
 to enable other facets for the project.</p>
 <p>When
 you create an enterprise application project, it is recommended that you do
 not give it a name that contains double-byte character set (DBCS) characters.</p>
 <p>To
 create a J2EE enterprise application project:</p>
 </div>

 <ol class="id_steps">
 <li class="stepexpand"><span>In the J2EE perspective, click <span class="menucascade"><span class="uicontrol">File</span>
  &gt; <span class="uicontrol">New</span> &gt; <span class="uicontrol">Project</span> &gt; <span class="uicontrol">J2EE</span>
  &gt; <span class="uicontrol">Enterprise Application Project</span></span>.</span>
 </li>

 <li class="stepexpand"><span>In the <span class="uicontrol">Project Name</span> field, type a name for
 the new project. </span></li>

 <li class="stepexpand"><span>To change the default project location, clear the <span class="uicontrol">Use
 default</span> check box under <span class="uicontrol">Project contents</span> and
 select a new location with the <span class="uicontrol">Browse</span> button.</span>
 </li>

 <li class="stepexpand"><span>In the <span class="uicontrol">Target runtime</span> field, select the
 target runtime for the project.</span> You can click the <span class="uicontrol">New</span> button
 to create a new runtime for the project to use.</li>

 <li class="stepexpand"><span>If you want to use a predefined configuration for your project,
 select a configuration in the <span class="uicontrol">Common Configurations</span> list.</span>
 </li>

 <li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li>

 <li class="stepexpand"><span>Select the check boxes next to the facets you want this project
 to have and select a version number for each facet. </span> You can also
 choose a preset combination of facets from the <span class="uicontrol">Presets</span> list,
 and you can also find out more about the requirements for each facet by right-clicking
 the facet name and then clicking <span class="uicontrol">Show Constraints</span>.
 </li>

 <li class="stepexpand"><span>If you want to limit your 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>
 </li>

 <li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li>

 <li class="stepexpand"><span>On the J2EE Modules to Add to the EAR page of the wizard, select
 the existing modules that you want to add to the new enterprise application
 project. </span></li>

 <li class="stepexpand"><span>You can also create new modules to add to the project:</span>
 <ol type="a">
 <li class="substepexpand"><span>Click the <span class="uicontrol">New Module</span> button.</span></li>

 <li class="substepexpand"><span>If you want to create one module, clear the <span class="uicontrol">Create
 default modules</span> check box, select the type of module you want
 to create, click <span class="uicontrol">Next</span> and follow the New Project wizard
 for that type of project.</span></li>

 <li class="substepexpand"><span>If you want to create more than one module, select the <span class="uicontrol">Create
 default modules</span> check box, select the check boxes for each type
 of project you want to create, and click <span class="uicontrol">Finish</span>. </span>
  You can enter a name for each module. Each of these modules will have
 the default settings for that type of project and they will have the same
 server target as the new enterprise application.</li>

 </ol>

 </li>

 <li class="stepexpand"><span>Click <span class="uicontrol">Finish</span>.</span></li>

 </ol>

 <div class="id_postreq"><p class="anchor_topicbottom" />
 </div>

 </div>

 <div><div class="relconcepts"><strong>Related concepts</strong><br />
 <div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div>
 <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/tjimpear.html" title="Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed EAR file.">Importing an enterprise application EAR file</a></div>
 <div><a href="../topics/tjexpear.html" title="Enterprise applications are deployed in the form of an EAR file. Use the Export wizard to export an enterprise application project into an EAR file for deployment.">Exporting an enterprise application into an EAR file</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 J2EE project</a></div>
 </div>
 </div>

 </body>
 </html>
	<?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="Creating an enterprise application project" />
	<meta name="abstract" content="" />
	<meta name="description" content="" />
	<meta content="enterprise application projects, creating" name="DC.subject" />
	<meta content="enterprise application projects, creating" name="keywords" />
	<meta scheme="URI" name="DC.Relation" content="../topics/tjimpear.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/tjexpear.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/cjarch.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/cjearproj.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/cjearproj.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddingfacet.html" />
	<meta content="XHTML" name="DC.Format" />
	<meta content="tjear" 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>Creating an enterprise application project</title>
	</head>
	<body id="tjear"><a name="tjear"><!-- --></a>


	<h1 class="id_title">Creating an enterprise application project</h1>



	<div class="id_taskbody"><p class="id_shortdesc" />

	<div class="id_context"><p class="anchor_topictop">Enterprise
	application projects contain references to the resources needed for enterprise
	applications and can contain a combination of Web modules, JAR files, connector
	modules, EJB modules, and application client modules. An enterprise application
	project is deployed in the form of an EAR file, and is therefore sometimes
	referred to as an EAR project. The modules in an enterprise application project
	are mapped to other J2EE projects. The mapping information is stored in metadata
	files within the enterprise application project. The metadata files are used
	for exporting the project to an EAR file and for running the project on the
	server.</p>
	<p>Like the other types of projects, enterprise application projects
	can contain one or more project facets, which represent units of functionality
	in the project. To be deployed as an EAR file, the new project must have the
	EAR facet. Depending on what you want to use the project for, you may want
	to enable other facets for the project.</p>
	<p>When
	you create an enterprise application project, it is recommended that you do
	not give it a name that contains double-byte character set (DBCS) characters.</p>
	<p>To
	create a J2EE enterprise application project:</p>
	</div>

	<ol class="id_steps">
	<li class="stepexpand"><span>In the J2EE perspective, click <span class="menucascade"><span class="uicontrol">File</span>
	> <span class="uicontrol">New</span> > <span class="uicontrol">Project</span> > <span class="uicontrol">J2EE</span>
	> <span class="uicontrol">Enterprise Application Project</span></span>.</span>
	</li>

	<li class="stepexpand"><span>In the <span class="uicontrol">Project Name</span> field, type a name for
	the new project. </span></li>

	<li class="stepexpand"><span>To change the default project location, clear the <span class="uicontrol">Use
	default</span> check box under <span class="uicontrol">Project contents</span> and
	select a new location with the <span class="uicontrol">Browse</span> button.</span>
	</li>

	<li class="stepexpand"><span>In the <span class="uicontrol">Target runtime</span> field, select the
	target runtime for the project.</span> You can click the <span class="uicontrol">New</span> button
	to create a new runtime for the project to use.</li>

	<li class="stepexpand"><span>If you want to use a predefined configuration for your project,
	select a configuration in the <span class="uicontrol">Common Configurations</span> list.</span>
	</li>

	<li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li>

	<li class="stepexpand"><span>Select the check boxes next to the facets you want this project
	to have and select a version number for each facet. </span> You can also
	choose a preset combination of facets from the <span class="uicontrol">Presets</span> list,
	and you can also find out more about the requirements for each facet by right-clicking
	the facet name and then clicking <span class="uicontrol">Show Constraints</span>.
	</li>

	<li class="stepexpand"><span>If you want to limit your 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>
	</li>

	<li class="stepexpand"><span>Click <span class="uicontrol">Next</span>.</span></li>

	<li class="stepexpand"><span>On the J2EE Modules to Add to the EAR page of the wizard, select
	the existing modules that you want to add to the new enterprise application
	project. </span></li>

	<li class="stepexpand"><span>You can also create new modules to add to the project:</span>
	<ol type="a">
	<li class="substepexpand"><span>Click the <span class="uicontrol">New Module</span> button.</span></li>

	<li class="substepexpand"><span>If you want to create one module, clear the <span class="uicontrol">Create
	default modules</span> check box, select the type of module you want
	to create, click <span class="uicontrol">Next</span> and follow the New Project wizard
	for that type of project.</span></li>

	<li class="substepexpand"><span>If you want to create more than one module, select the <span class="uicontrol">Create
	default modules</span> check box, select the check boxes for each type
	of project you want to create, and click <span class="uicontrol">Finish</span>. </span>
	You can enter a name for each module. Each of these modules will have
	the default settings for that type of project and they will have the same
	server target as the new enterprise application.</li>

	</ol>

	</li>

	<li class="stepexpand"><span>Click <span class="uicontrol">Finish</span>.</span></li>

	</ol>

	<div class="id_postreq"><p class="anchor_topicbottom" />
	</div>

	</div>

	<div><div class="relconcepts"><strong>Related concepts</strong><br />
	<div><a href="../topics/cjarch.html" title="The Java 2 Platform, Enterprise Edition (J2EE) provides a standard for developing multitier, enterprise services.">J2EE architecture</a></div>
	<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/tjimpear.html" title="Enterprise application projects are deployed into EAR files. You can import an enterprise application project by importing it from a deployed EAR file.">Importing an enterprise application EAR file</a></div>
	<div><a href="../topics/tjexpear.html" title="Enterprise applications are deployed in the form of an EAR file. Use the Export wizard to export an enterprise application project into an EAR file for deployment.">Exporting an enterprise application into an EAR file</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 J2EE project</a></div>
	</div>
	</div>

	</body>
	</html>