blob: 03e30659b1da00f0ff8ba98fb374a5ab399d0f76 [file] [log] [blame]
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8">
<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 1.5.5">
<title>New LookupCall Wizard</title>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
<link rel="stylesheet" href="css/eclipse.css">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
<link rel="stylesheet" href="css/coderay-eclipse.css">
</head>
<body class="article">
<table border="0" class="navigation" style="width: 100%;" summary="navigation">
<tr>
<td align="left" colspan="1" rowspan="1" style="width: 30%"><a href="sdk_wizard_nls-entry.html" shape="rect" title="NLS Entry Wizard"><img alt="Previous" border="0" src="images/prev.gif"></a></td>
<td align="center" colspan="1" rowspan="1" style="width: 40%"></td>
<td align="right" colspan="1" rowspan="1" style="width: 30%"><a href="sdk_wizard_code-type.html" shape="rect" title="New CodeType Wizard"><img alt="Next" border="0" src="images/next.gif"></a></td>
</tr>
<tr>
<td align="left" colspan="1" rowspan="1" style="width: 30%">NLS Entry Wizard</td>
<td align="center" colspan="1" rowspan="1" style="width: 40%"></td>
<td align="right" colspan="1" rowspan="1" style="width: 30%">New CodeType Wizard</td>
</tr>
</table>
<div id="header">
</div>
<div id="content">
<div class="sect3">
<h4 id="new-lookupcall-wizard"><a class="anchor" href="#new-lookupcall-wizard"></a>New LookupCall Wizard</h4>
<div class="paragraph">
<p>The <em>New Scout Lookup Call</em> wizard can be used to create a lookup call and a corresponding lookup service. To start the wizard use <span class="menuseq"><span class="menu">File</span>&nbsp;&#x25b8; <span class="submenu">New</span>&nbsp;&#x25b8; <span class="menuitem">Other&#x2026;&#x200b;</span></span> or press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>N</kbd></span> as described in section <a href="sdk_wizard.html">Scout Wizards</a>.</p>
</div>
<div id="img-sdk_wizard_lookupcall" class="imageblock">
<div class="content">
<img src="images/sdk_new_lookupcall.png" alt="sdk new lookupcall">
</div>
<div class="title">
Figure 1. The new LookupCall wizard
</div>
</div>
<div class="paragraph">
<p>In the case of <a href="#img-sdk_wizard_lookupcall">Figure 1</a> the package <code>org.eclipse.scout.apps.helloworld.shared.helloworld</code> has been selected in the Package Explorer. The only wizard fields that then needs to be filled in manually are the <strong>Name</strong> and the <strong>Key Class</strong> fields.</p>
</div>
<div class="paragraph">
<p>By clicking on the <b class="button">Finish</b> button the wizard is started and the specified components are created.</p>
</div>
<div class="sect4">
<h5 id="wizard-fields-and-default-values"><a class="anchor" href="#wizard-fields-and-default-values"></a>Wizard Fields and Default Values</h5>
<div class="paragraph">
<p>Most of the fields of the <a href="#img-sdk_wizard_lookupcall">Figure 1</a> will be filled with default values depending on the current context of the IDE. The context can be derived from a package selected in the Package Explorer or from the class in the active Java Editor.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">
Source Folder
</dt>
<dd>
<p>The source folder of the Maven shared module used for the creation of the lookup call class. The default value is the <code>src/main/java</code> folder in the Maven shared module.</p>
</dd>
<dt class="hdlist1">
Package
</dt>
<dd>
<p>The Java package that will contain the lookup call class. The Scout SDK will try to guess the package name from the current context and derive a matching package names for the Maven server module.</p>
</dd>
<dt class="hdlist1">
Name
</dt>
<dd>
<p>The name of the lookup call class. According to Scout conventions the class name ends with the suffix <code>LookupCall</code>.</p>
</dd>
<dt class="hdlist1">
Super Class
</dt>
<dd>
<p>The super class for the form. <code>LookupCall</code> is the default value.</p>
</dd>
<dt class="hdlist1">
Key Class
</dt>
<dd>
<p>The class to be used for key values of the lookup call.</p>
</dd>
<dt class="hdlist1">
Server Source Folder
</dt>
<dd>
<p>The source folder of the Maven server module used for the service class creation. The default value is the <code>src/main/java</code> folder in the Maven server module.</p>
</dd>
<dt class="hdlist1">
Service Super Class
</dt>
<dd>
<p>The super class for the lookup service associated with this lookup call. The default value is <code>AbstractLookupService</code>.</p>
</dd>
</dl>
</div>
</div>
<div class="sect4">
<h5 id="created-components"><a class="anchor" href="#created-components"></a>Created Components</h5>
<div class="paragraph">
<p>In the <a href="#img-sdk_wizard_lookupcall">Figure 1</a> example shown above the Scout SDK will create the following components.</p>
</div>
<div class="ulist">
<ul>
<li> <p>In Maven module <strong>helloworld.shared</strong></p>
<div class="ulist">
<ul>
<li> <p>In folder <code>src/main/java</code> and package <code>org.eclipse.scout.apps.helloworld.shared.helloworld</code></p>
<div class="ulist">
<ul>
<li> <p>The <code>MyLookupCall</code> class</p> </li>
<li> <p>The <code>IMyLookupService</code> interface</p> </li>
</ul>
</div> </li>
</ul>
</div> </li>
<li> <p>In Maven module <strong>helloworld.server</strong></p>
<div class="ulist">
<ul>
<li> <p>The <code>MyLookupService</code> service class in folder <code>src/generated/java</code> and package <code>org.eclipse.scout.apps.helloworld.server.helloworld</code></p> </li>
</ul>
</div> </li>
</ul>
</div>
<hr>
<div class="paragraph">
<p>Go back to the <a href="sdk_wizard.html">Scout Wizards</a>.</p>
</div>
<div class="paragraph">
<p>Do you want to improve this document? Have a look at the <a href="https://github.com/BSI-Business-Systems-Integration-AG/org.eclipse.scout.docs/blob/releases/8.0.x/docs/build/eclipse_help/src/docs/sdk_wizard_lookupcall.adoc" target="_blank">sources</a> on GitHub.</p>
</div>
</div>
</div>
</div>
<table border="0" class="navigation" style="width: 100%;" summary="navigation">
<tr>
<td align="left" colspan="1" rowspan="1" style="width: 30%"><a href="sdk_wizard_nls-entry.html" shape="rect" title="NLS Entry Wizard"><img alt="Previous" border="0" src="images/prev.gif"></a></td>
<td align="center" colspan="1" rowspan="1" style="width: 40%"><a href="scout_user_guide.html" shape="rect" title="Eclipse Scout User Guide"><img alt="Eclipse Scout User Guide" border="0" src="images/home.gif"></a></td>
<td align="right" colspan="1" rowspan="1" style="width: 30%"><a href="sdk_wizard_code-type.html" shape="rect" title="New CodeType Wizard"><img alt="Next" border="0" src="images/next.gif"></a></td>
</tr>
<tr>
<td align="left" colspan="1" rowspan="1" style="width: 30%">NLS Entry Wizard</td>
<td align="center" colspan="1" rowspan="1" style="width: 40%"></td>
<td align="right" colspan="1" rowspan="1" style="width: 30%">New CodeType Wizard</td>
</tr>
</table>
<div id="footer">
<div id="footer-text">
Version 8.0
<br> Last updated 2018-04-03 14:49:24 CEST
</div>
</div>
</body>
</html>