blob: bc3f6bbb0fa8b515c5a3afc4f65029bc2d7f2e05 [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 a connector project" />
<meta name="abstract" content="A connector is a J2EE standard extension mechanism for containers to provide connectivity to enterprise information systems (EISs)." />
<meta name="description" content="A connector is a J2EE standard extension mechanism for containers to provide connectivity to enterprise information systems (EISs)." />
<meta content="connector projects, creating" name="DC.subject" />
<meta content="connector projects, creating" name="keywords" />
<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="tjrar" 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 a connector project</title>
</head>
<body id="tjrar"><a name="tjrar"><!-- --></a>
<h1 class="id_title">Creating a connector project</h1>
<div class="id_taskbody"><p class="id_shortdesc">A connector is a J2EE standard extension
mechanism for containers to provide connectivity to enterprise information
systems (EISs).</p>
<div class="id_context"> <p class="anchor_topictop" />
<p>A
connector is specific to an EIS and consists of a resource adapter and application
development tools. A resource adapter is a system-level software driver that
is used by an EJB container or an application client to connect to an EIS.
Connectors comply with the J2EE Connector architecture (JCA).</p>
<p>Like the
other types of projects, connector projects can contain one or more project
facets, which represent units of functionality in the project. A new connector
project should have the J2C Module facet. Depending on what you want to use
the project for, you may want to enable other facets for the project.</p>
<div class="restriction"><span class="restrictiontitle">Restriction:</span> J2EE 1.2 specification level does not include connector
capability.</div>
<p>To create a new connector 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">Connector 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 connector 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 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"><strong>Optional: </strong><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"><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>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>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/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>
</body>
</html>