blob: 46fe63ad2ee3f7f0c324fbf7abc3b4d1501cd8b2 [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="task" name="DC.Type" />
<meta name="DC.Title" content="Creating an enterprise application project" />
<meta name="abstract" content="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." />
<meta name="description" content="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." />
<meta content="enterprise applications, projects, creating, J2EE, enterprise application projects" name="DC.subject" />
<meta content="enterprise applications, projects, creating, J2EE, enterprise application projects" 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/cfacets.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">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.</p>
<div class="id_context"><p class="anchor_topictop" />
<p>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, complete the following steps:</p>
</div>
<ol class="id_steps">
<li class="stepexpand"><span>In the Java™ EE perspective, click <span class="menucascade"><span class="uicontrol">File</span>
&gt; <span class="uicontrol">New</span> &gt; <span class="uicontrol">Project</span></span>.</span>
</li>
<li class="stepexpand"><span>In the New Project Wizard, select <span class="menucascade"><span class="uicontrol">J2EE</span>
&gt; <span class="uicontrol">Enterprise Application Project</span></span> and click <span class="uicontrol">Next</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"><strong>Optional: </strong><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"><strong>Optional: </strong><span>To use a predefined configuration for your
project, select a configuration in the <span class="uicontrol">Configuration</span> list.
You can click the <span class="uicontrol">Modify</span> button to do the following:</span>
<ul>
<li>Customize project facets. Select the check boxes next to the facets you
want the project to have and select a version number for each facet. Select
a facet name to see more information about that facet in the <span class="uicontrol">Details</span> tab.
You can also choose a preset combination of facets from the <span class="uicontrol">Configurations</span> list.</li>
<li>Limit your project to be compatible with one or more runtimes. Click the <span class="uicontrol">Show
Runtimes</span> tab and select the runtimes that you want the project
to be compatible with. </li>
</ul>
Click <span class="uicontrol">Next</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"><strong>Optional: </strong><span>To create new modules to add to the project,
click the <span class="uicontrol">New Module</span> button to do one of the following:</span>
<table class="choicetableborder" summary="" cellspacing="0" cellpadding="4" rules="rows" frame="hsides" border="1">
<thead><tr><th valign="bottom" id="N1016C-option" align="left">Option</th>
<th valign="bottom" id="N1016C-desc" align="left">Description</th></tr></thead>
<tbody>
<tr><td valign="top" headers="N1016C-option" id="N10176">Creating one module</td>
<td valign="top" headers="N1016C-desc N10176">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.</td>
</tr>
<tr><td valign="top" headers="N1016C-option" id="N10191">Creating two or more modules</td>
<td valign="top" headers="N1016C-desc N10191">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>.</td>
</tr>
</tbody></table>
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>
<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 applications.">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><a href="../topics/cfacets.html" title="Facets define characteristics and requirements for Java EE projects and are used as part of the runtime configuration.">Project facets</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>
</div>
</body>
</html>