blob: 095d72edb5f639d3f41240a61336f68f4f0e7a7b [file] [log] [blame]
<html>
<head>
<meta
http-equiv="Content-Type"
content="text/html; charset=Cp1252">
<meta
http-equiv="Content-Style-Type"
content="text/css">
<link
href="../theme/Master.css"
rel="stylesheet"
type="text/css">
<title>Getting Started.html</title>
</head>
<body>
<h1>J2EE Tools Evaluation Guide</h1>
<h2>1.0 Introduction</h2>
<p>The J2EE tools contribution offers tools to create, import, export and exploration thru J2EE modules including
EAR, Application Client, Connector, EJB and Web projects. <br>
The following document contains information to get you started using the J2EE tools features</p>
<h2>2.0 Getting Started</h2>
<p>This document can be used as reference for a user with a new workspace or an existing workspace.</p>
<h2>3.0 Quick Tour</h2>
<p>In the following bullet points various simple tasks within the J2EE tools will be explained. The sections
themselves are not inter-related and can be run independent of the others.</p>
<h3>3.1 Project Creation</h3>
<p>The J2EE tools Project Creation wizards allow developers to create basic J2EE projects including EAR, Application
Client, Connector, EJB and Web projects. Each Project Creation wizard can be launched by selecting
File-&gt;Import-&gt;Module type (Note: Module type depends on which type of J2EE project you are going to create. EJB
Project is shown below, however, EAR, Application Client, Connector can be found under the J2EE folder, and Web Project
be found in the Web folder with in this wizard.)<br>
<img
src="J2EEToolsEval_files/1480_5053.jpg"
align="baseline"
alt=""><br>
Each module has its own wizard; however, for usability reasons they are all very similar. Because of this only the EJB
Project Creation will be covered in detail in this document, but the same principles apply for all modules.<br>
Once you have selected EJB Project from the basic Project Creation Wizard hitting &quot;Next&quot; will take you to the
EJB Project Creation Wizard. This wizard pictured below allows the developer to enter a &quot;Project Name&quot; as well
as a variety of other J2EE specific information including possible EAR which will contain the EJB as well as a target
server.<br>
<img
src="J2EEToolsEval_files/1480_6255.jpg"
align="baseline"
alt=""><br>
The user can now create the project by selecting &quot;Finish&quot;.<br>
</p>
<h3>3.2 Import</h3>
<p><span
style='font-size: 12.0pt; font-family: "Times New Roman"; mso-fareast-font-family: "Times New Roman"; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA'>J2EE
Tools provide import of EJB modules in form of .jar files. The import wizard can be invoked from two places. The user
can access the wizard from File -&gt; Import -&gt; EJB Jar file<br>
<img
src="J2EEToolsEval_files/1480_25186.jpg"
align="baseline"
alt=""> </span><br>
or right click on the EJB modules group in the Project Explorer and select Import -&gt; EJB JAR File<br>
<img
src="J2EEToolsEval_files/1480_25434.jpg"
align="baseline"
alt=""><br>
<span
style='font-size: 12.0pt; font-family: "Times New Roman"; mso-fareast-font-family: "Times New Roman"; color: black; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA'>The
EJB Import wizard comes up as shown in the figure below. Select the <b style="mso-bidi-font-weight: normal">“EJB JAR
file”</b> by using the <b style="mso-bidi-font-weight: normal">“Browse”</b> button and navigating to the JAR file to be
imported.<br>
<img
src="J2EEToolsEval_files/1480_26923.jpg"
align="baseline"
alt=""><br>
<br>
To complete the import simple press &quot;<b>Finish</b>&quot;. Import of other modules like EAR, Application Client, Web
and Connector projects is also supported and can be done in a similar way, as a wizard is available for each module type
<br>
</span></p>
<h3>3.3 Export</h3>
<p><span
style='font-size: 12.0pt; font-family: "Times New Roman"; mso-fareast-font-family: "Times New Roman"; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA'>J2EE
Tools provide exporting of EJB modules in form of .jar files. The export wizard can be invoked from two places. First
the user can access the wizard from either File -&gt; Export -&gt; EJB Jar file<br>
<img
src="J2EEToolsEval_files/1480_23732.jpg"
align="baseline"
alt=""><br>
</span>or right click on the EJB project to be exported under the EJB modules in the Project Explorer and select Export -&gt;
EJB JAR file.<br>
<img
src="J2EEToolsEval_files/1480_23804.jpg"
align="baseline"
alt=""><br>
<span
style='font-size: 12.0pt; font-family: "Times New Roman"; mso-fareast-font-family: "Times New Roman"; color: black; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA'>EJB
Export wizard comes up as shown in the figure below. Select the <b style="mso-bidi-font-weight: normal">“Destination”</b>
by using the <b style="mso-bidi-font-weight: normal">“Browse”</b> button. You are also able to change the project which
you want to export by selecting on the drop down combo box under the &quot;<b>Project:</b>&quot; heading.</span><br>
<img
src="J2EEToolsEval_files/1480_24007.jpg"
align="baseline"
alt=""><br>
To complete the export simple press finish. <span
style='font-size: 12.0pt; font-family: "Times New Roman"; mso-fareast-font-family: "Times New Roman"; color: black; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA'>Export
of other modules like EAR, Application Client, Web and Connector projects is also supported and can be done in a similar
way</span>, as a wizard is available for each module type.<br>
</p>
<h3>3.4 Project Explorer</h3>
<p>The Project Explorer is useful J2EE group navigation view. The view can be launched by selecting Windows-&gt;Show
View-&gt;Others-&gt;J2EE -&gt; Project Explorer. The Project Explorer has two basic layouts determined by selection of
the folder grouping button located at the top of the view <img
src="J2EEToolsEval_files/1480_31986.jpg"
align="baseline"
alt="">. When selected, as seen below, the J2EE projects in your workspace will be group under their
appropriate J2EE modules. Simple Java Projects and other non-J2EE projects will be found under the &quot;Other
Projects&quot; group.<br>
<img
src="J2EEToolsEval_files/1480_30115.jpg"
align="baseline"
alt=""><br>
If a user would like to see all project ungrouped simply deselecting the <img
src="J2EEToolsEval_files/1480_31986.jpg"
align="baseline"
alt=""> will show a view seen below.<br>
<img
src="J2EEToolsEval_files/1480_32577.jpg"
align="baseline"
alt=""><br>
<br>
The Project Explorer also provides a framework of actions which are contributed from the individual objects to perform
operations, open editors and do a variety of other work on the projects and their contents as seen by the example
implementation below.<br>
.<img
src="J2EEToolsEval_files/1480_589.jpg"
align="baseline"
alt=""><br>
</p>
<h2>4.0 Provide Feedback to Us</h2>
<p>We encourage development/design feed back on the <a href="https://dev.eclipse.org/mailman/listinfo/wtp-dev">wtp-dev</a>
mailing list. You can subscribe to the list via <a href="https://dev.eclipse.org/mailman/listinfo/wtp-dev">this link</a>.<br>
<br>
For usage questions, discussion of bugs, and strange behaviour please post to the eclipse.webtools newsgroup.
Information on the Web Tools Platform newsgroup can be found <a href="http://www.eclipse.org/newsgroups/index.html">here</a>.</p>
</body>
</html>