blob: 70bd0e815e699ebdfd67e87f62f8d65bb17b2451 [file] [log] [blame]
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "../xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<link rel="stylesheet" type="text/css" href="../css/ot.css" />
<link rel="stylesheet" type="text/css" href="../css/otjld.css" />
<title>OT/J Language Definition v1.3</title>
</head>
<body class="otdt">
<div id="content">
<table class="nav">
<tr>
<td class="back"><a id="top"></a><a href="s3.5.g.html" rel="prev">&lt;&lt;&nbsp;&sect;3.5.(g)&nbsp;Callout override</a></td>
<td class="top"><a href="index.html" rel="contents">&uarr;&nbsp;Table of Contents&nbsp;&uarr;</a></td>
<td class="next"></td>
</tr>
</table>
<div class="breadcrumb"><a class="nav" href="s3.html" rel="section">&sect;3&nbsp;Callout Binding</a>&nbsp;&gt;&nbsp;<a class="nav" href="s3.5.html" rel="section">&sect;3.5&nbsp;Callout to field</a></div>
<div class="subsect depth3" id="s3.5.h">
<h4 class="subsect">&sect;3.5.(h)&nbsp;<span class="title">Inferred callout</span><a class="img" href="s3.5.h.html" title="PermaLink to (h)&nbsp;Inferred callout"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png"
alt="" /></a></h4>
<p> If a statement or expression within the body of a bound role class
uses a simple name or a name qualified by <code>this</code>
which can not be resolved using normal rules,
the compiler may infer to use a callout to field instead,
given that a field of the required name can be found in the role's declared baseclass.
</p>
<p> If a callout to field has explicitly been declared it is used for the otherwise
unresolved name, if and only if:
</p>
<ul>
<li>the callout declares a role method name the is constructed from the token "set" for
a setter or "get" for a getter plus the field name with capital first letter,
</li>
<li>the base field referenced by the callout has exactly the required name, and</li>
<li>the callout kind (set/get) matches the application of the unresolved name as either
the left-hand side of an assignment (set) or as an expression (get).
</li>
</ul>
<p>
If a matching callout to field is not found, the compiler generates one automatically,
which has <code>private</code> visibility.
</p>
<p>
If a callout to field has been inferred it is an error to directly invoke the
implicitly generated callout accessor that is formed according to the above rules.
</p>
<p>
Per default inferred callout bindings are disabled, i.e., a compiler
must report these as an error. However, a compiler should allow to
configure reporting to produce a warning only (which can be suppressed
using a <code>@SuppressWarnings("inferredcallout")</code> annotation),
or to completely ignore the diagnostic. See also <a href="s3.1.j.html" title="&sect;3.1.(j)&nbsp;Inferred callout" class="sect">&sect;3.1.(j)</a>.
</p>
</div>
<table class="nav">
<tr>
<td class="back"><a href="s3.5.g.html" rel="prev">&lt;&lt;&nbsp;&sect;3.5.(g)&nbsp;Callout override</a></td>
<td class="top"><a href="index.html" rel="contents">&uarr;&nbsp;Table of Contents&nbsp;&uarr;</a></td>
<td class="next"></td>
</tr>
</table>
<div class="breadcrumb"><a class="nav" href="s3.html" rel="section">&sect;3&nbsp;Callout Binding</a>&nbsp;&gt;&nbsp;<a class="nav" href="s3.5.html" rel="section">&sect;3.5&nbsp;Callout to field</a></div>
</div>
<div id="footer">
<hr /><a class="w3c img" href="http://jigsaw.w3.org/css-validator/check/referer"
shape="rect"><img src="../images/valid-css2-blue.png" alt="Valid CSS!" height="31" width="88" /></a><a class="w3c img" href="http://validator.w3.org/check?uri=referer" shape="rect"><img src="../images/valid-xhtml10-blue.png" alt="Valid XHTML 1.0 Strict" height="31"
width="88" /></a><address>&copy; Stephan Herrmann, Christine Hundt, Marco Mosconi</address>
OT/J version 1.3 &mdash; last modified: 2011-05-12
</div>
</body>
</html>