blob: 7768801c0116453cdf3c3a02fef6be40bba5f18a [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, 2008 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, 2008" />
<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/cfacets.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" />
<p>Application
client projects contain the resources needed for application client modules
and 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, 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">Java
EE</span> &gt; <span class="uicontrol">Application Client 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 application client 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>
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 Java EE 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"><strong>Optional: </strong><span>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"><strong>Optional: </strong><span>To use a predefined configuration for your
project, select a configuration in the <span class="uicontrol">Configurations</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>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"><strong>Optional: </strong><span>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 applications.">J2EE architecture</a></div>
<div><a href="../topics/cjappcliproj.html" title="Application client projects contain programs that run on networked client systems so the project can benefit from a server's tools.">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><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/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>
</div>
</body>
</html>