<?xml version="1.0" encoding="utf-8"?>
<!--Arbortext, Inc., 1988-2006, v.4002-->
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN"
 "task.dtd">
<task id="tjrar" xml:lang="en-us">
<title outputclass="id_title">Creating a connector project</title>
<shortdesc outputclass="id_shortdesc">A connector is a J2EE standard extension
mechanism for containers to provide connectivity to enterprise information
systems (EISs).</shortdesc>
<prolog><metadata>
<keywords><indexterm>connector projects<indexterm>creating</indexterm></indexterm>
</keywords>
</metadata></prolog>
<taskbody outputclass="id_taskbody">
<context outputclass="id_context"> <p outputclass="anchor_topictop"></p> <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><note
type="restriction">J2EE 1.2 specification level does not include connector
capability.</note><p>To create a new connector project, complete the following
steps:</p></context>
<steps outputclass="id_steps">
<step><cmd>In the <tm tmclass="special" tmowner="Sun Microsystems, Inc." tmtype="tm"
trademark="Java">Java</tm> EE perspective, click <menucascade><uicontrol>File</uicontrol>
<uicontrol>New</uicontrol><uicontrol>Project</uicontrol></menucascade>.</cmd>
</step>
<step><cmd>In the New Project Wizard, select <menucascade><uicontrol>J2EE</uicontrol>
<uicontrol>Connector Project</uicontrol></menucascade> and click <uicontrol>Next</uicontrol>.</cmd>
</step>
<step><cmd>In the <uicontrol>Project Name</uicontrol> field, type a name for
the connector project. </cmd></step>
<step importance="optional"><cmd>To change the default project location, clear
the <uicontrol>Use default</uicontrol> check box under <uicontrol>Project
contents</uicontrol> and select a new location with the <uicontrol>Browse</uicontrol> button.</cmd>
<info>If you specify a non-default project location that is already being
used by another project, the project creation will fail.<note>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.</note></info></step>
<step importance="optional"><cmd>If you want to add the new project to an
enterprise application project, select the <uicontrol>Add project to an EAR</uicontrol> check
box and select a project in the <uicontrol>EAR Project Name</uicontrol> list.</cmd>
<info>If you choose to add the project to an existing EAR project, the <uicontrol>Target
runtime</uicontrol> field becomes disabled because the target runtime for
the new project will be the same as that of the EAR project.</info></step>
<step><cmd>In the <uicontrol>Target runtime</uicontrol> field, select the
target runtime for the project.</cmd></step>
<step importance="optional"><cmd>To use a predefined configuration for your
project, select a configuration in the <uicontrol>Configuration</uicontrol> list.
You can click the <uicontrol>Modify</uicontrol> button to do the following:</cmd>
<info><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 <uicontrol>Details</uicontrol> tab.
You can also choose a preset combination of facets from the <uicontrol>Configurations</uicontrol> list.</li>
<li>Limit your project to be compatible with one or more runtimes. Click the <uicontrol>Show
Runtimes</uicontrol> tab and select the runtimes that you want the project
to be compatible with. </li>
</ul>Click <uicontrol>Next</uicontrol>.</info></step>
<step><cmd>In the <uicontrol>Source Folder</uicontrol> field, enter the name
of the folder to use for source code.</cmd></step>
<step><cmd>Click <uicontrol>Finish</uicontrol>.</cmd></step>
</steps>
<postreq outputclass="id_postreq"><p outputclass="anchor_topicbottom"></p></postreq>
</taskbody>
</task>