blob: 2b2479cb7cbfd80916eb81f55a85ac137cf8c29a [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="Creating an application client project" />
<meta name="abstract" content="You can use a wizard to create a new application client project and add it to a new or existing enterprise application project." />
<meta name="description" content="You can use a wizard to create a new application client project and add it to a new or existing enterprise application project." />
<meta content="application client projects, creating" name="DC.subject" />
<meta content="application client projects, creating" name="keywords" />
<meta scheme="URI" name="DC.Relation" content="../topics/tjexpapp.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/tjimpapp.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/cjarch.html" />
<meta scheme="URI" name="DC.Relation" content="../topics/cjappcliproj.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="tjappproj" 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 application client project</title>
</head>
<body id="tjappproj"><a name="tjappproj"><!-- --></a>
<h1 class="id_title">Creating an application client project</h1>
<div class="id_taskbody"><p class="id_shortdesc">You can use a wizard to create a new
application client project and add it to a new or existing enterprise application
project.</p>
<div class="id_context"> <p class="anchor_topictop">Application
client projects contain the resources needed for application client modules.
Application client projects contain programs that run on networked client
systems. An application client project is deployed as a JAR file.</p>
<p>Like
the other types of projects, application client projects can contain one or
more project facets, which represent units of functionality in the project.
A new application client project should have the Application Client module
facet. Depending on what you want to use the project for, you may want to
enable other facets for the project.</p>
<p>To create a J2EE application client
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">Application Client Project</span></span>.</span></li>
<li class="stepexpand"><span>In the <span class="uicontrol">Project Name</span> field, type a name for
the application client 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>
If you specify a non-default project location that is already being
used by another project, the project creation will fail.<div class="note"><span class="notetitle">Note:</span> If you type
a new EAR project name, the EAR project will be created in the default location
with the lowest compatible J2EE version based on the version of the project
being created. If you want to specify a different version or a different location
for the enterprise application, you must use the New Enterprise Application
Project wizard.</div>
</li>
<li class="stepexpand"><span>If you want to add the new project to an enterprise application
project, select the <span class="uicontrol">Add project to an EAR</span> check box
and select a project in the <span class="uicontrol">EAR Project Name</span> list.</span>
If you choose to add the project to an existing EAR project, the <span class="uicontrol">Target
runtime</span> field becomes disabled because the target runtime for
the new project will be the same as that of the EAR project.</li>
<li class="stepexpand"><span>In the <span class="uicontrol">Target runtime</span> field, select the
target runtime for the project.</span></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 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>In the <span class="uicontrol">Source Folder</span> field, enter the name
of the folder to use for source code. </span></li>
<li class="stepexpand"><span>If you want to create a default class for the module, select the <span class="uicontrol">Create
a default Main class</span> check box.</span></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/cjappcliproj.html" title="">Application client projects</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/tjexpapp.html" title="You can export an application client project as a JAR file.">Exporting an application client project</a></div>
<div><a href="../topics/tjimpapp.html" title="Application client projects are deployed as JAR files. You can import an application client project that has been deployed into a JAR file by using the Import wizard.">Importing an application client JAR 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>