blob: 800f2ae55dbf15270205a105a65330b95f06f023 [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 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/taddingfacet.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"> A connector
is a J2EE standard extension mechanism for containers to provide connectivity
to enterprise information systems (EISs). 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:</p>
</div>
<ol class="id_steps">
<li class="stepexpand"><span>In the J2EE perspective, select <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">Connector Project</span></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"><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>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>
<div class="reltasks"><strong>Related tasks</strong><br />
<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>