<?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> |