| <!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="sA.html" rel="prev"><< §A OT/J Syntax</a></td> |
| <td class="top"><a href="index.html" rel="contents">↑ Table of Contents ↑</a></td> |
| <td class="next"></td> |
| </tr> |
| </table> |
| <div class="chapter" id="sB"> |
| <div class="headl"> |
| <div class="headr"> |
| <h1>§B Changes between versions</h1> |
| </div> |
| </div> |
| <div id="toc-box"> |
| <ul class="toc-box"> |
| <li><a href="sB.html">§B Changes between versions</a></li> |
| <li><a href="#sB.1">§B.1 Paragraphs changed between versions</a></li> |
| <li><a href="#sB.2">§B.2 Additions between versions</a></li> |
| </ul> |
| </div> |
| <div class="sect depth2" id="sB.1"> |
| <h2 class="sect">§B.1 Paragraphs changed between versions<a class="img" href="sB.html#sB.1" |
| title="PermaLink to §B.1 Paragraphs changed between versions"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png" |
| alt="" /></a><span class="toplink"><a href="#top">↑ §B</a></span></h2> |
| <div class="subsect depth3" id="sB.1.1"> |
| <h4 class="subsect">(1) <span class="title">Between OTJLD 1.0 and OTJLD 1.1</span><a class="img" href="sB.html#sB.1.1" |
| title="PermaLink to (1) Between OTJLD 1.0 and OTJLD 1.1"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png" |
| alt="" /></a></h4> |
| <ul> |
| <li><a href="s3.html#s3.2.a" title="§3.2.(a) with clause" class="sect">§3.2.(a)</a> : |
| <strong>Parameter mappings</strong><p> |
| Disallow parameter mappings in a role interface. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.5.d" title="§4.5.(d) Typing rules" class="sect">§4.5.(d)</a> : |
| <strong>Replace bindings</strong><p> |
| Disallow unsafe use of polymorphism and primitive type conversions. |
| |
| </p> |
| </li> |
| <li><a href="s6.html#s6.1.a" |
| title="§6.1.(a) Interface to the role registry" |
| class="sect">§6.1.(a)</a> : |
| <strong>Signatures of reflective methods</strong><p> |
| Made two methods generic so that return values can be used without the need of casting. |
| |
| </p> |
| </li> |
| <li><a href="s7.html#s7.2" title="§7.2 Confined roles" class="sect">§7.2</a> : |
| <strong>Confined roles</strong><p> |
| Improved explanation. |
| |
| </p> |
| </li> |
| </ul> |
| </div> |
| <div class="subsect depth3" id="sB.1.2"> |
| <h4 class="subsect">(2) <span class="title">Between OTJLD 1.1 and OTJLD 1.2</span><a class="img" href="sB.html#sB.1.2" |
| title="PermaLink to (2) Between OTJLD 1.1 and OTJLD 1.2"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png" |
| alt="" /></a></h4> |
| <ul> |
| <li><a href="s1.html#s1.2.1.e" title="§1.2.1.(e) Role features" |
| class="sect">§1.2.1.(e)</a>: |
| <strong>Visibility of role features</strong><p> |
| Clarification has been added that a role can always access all the |
| features that its enclosing team has access to. |
| |
| </p> |
| </li> |
| <li><a href="s2.html#s2.1.2.e" |
| title="§2.1.2.(e) No free type parameters" |
| class="sect">§2.1.2.(e)</a>: |
| <strong>Generic roles/bases</strong><p> |
| Relaxed the rules about generic bound roles. This change also subsumes what previously was a specific restriction in |
| <a href="s4.html#s4.1.b" |
| title="§4.1.(b) Prerequisite: Class binding" |
| class="sect">§4.1.(b)</a>. |
| |
| </p> |
| </li> |
| <li><a href="s3.html#s3.1.i" title="§3.1.(i) Shorthand definition" |
| class="sect">§3.1.(i)</a> and <a href="s3.html#s3.5.f" title="§3.5.(f) Shorthand definition" |
| class="sect">§3.5.(f)</a>: |
| <strong>Visibility of shorthand callout</strong><p> |
| A role method defined by a shorthand callout binding can now specify a visibility modifier |
| (see also <a href="sA.html#sA.3.2" title="§A.3.2 CalloutBinding" class="sect">§A.3.2</a>), |
| otherwise it inherits the visibility modifier of it's bound base method/field. |
| |
| </p> |
| </li> |
| <li><a href="s3.html#s3.1.j" title="§3.1.(j) Inferred callout" |
| class="sect">§3.1.(j)</a> and <a href="s3.html#s3.5.h" title="§3.5.(h) Inferred callout" |
| class="sect">§3.5.(h)</a>: |
| <strong>Visibility of inferred callout</strong><p> |
| Role methods inferred as a callout binding are either <code>public</code> |
| (inferred via interface) or <code>private</code> inferred from |
| self call / field access. |
| |
| </p> |
| </li> |
| <li><a href="s3.html#s3.5.h" title="§3.5.(h) Inferred callout" |
| class="sect">§3.5.(h)</a>: |
| <strong>No explicit use of inferred callout to field</strong><p> |
| Clarification has been added that an accessor method generated for an inferred callout to field |
| can not be explicitly invoked. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.1.b" |
| title="§4.1.(b) Prerequisite: Class binding" |
| class="sect">§4.1.(b)</a>: |
| <strong>No callin in generic role</strong><p> |
| A restriction has been made explicit that a generic role cannot define callin bindings. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.2.d" title="§4.2.(d) Callin methods" |
| class="sect">§4.2.(d)</a> : |
| <strong>Callin methods</strong><p>Slightly rephrased and extended the rule to make explicit that a callin method can |
| indeed be intercepted using a second level callin binding. |
| |
| </p> |
| </li> |
| <li><a href="s6.html#s6.1.a" |
| title="§6.1.(a) Interface to the role registry" |
| class="sect">§6.1.(a)</a> : |
| <strong>Reflective methods <code>getAllRoles</code></strong><p> |
| More precision: answer only <em>bound</em> roles. |
| |
| </p> |
| </li> |
| </ul> |
| </div> |
| <div class="subsect depth3" id="sB.1.3"> |
| <h4 class="subsect">(3) <span class="title">Between OTJLD 1.2 and OTJLD 1.3</span><a class="img" href="sB.html#sB.1.3" |
| title="PermaLink to (3) Between OTJLD 1.2 and OTJLD 1.3"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png" |
| alt="" /></a></h4> |
| <ul> |
| <li><a href="s1.html#s1.2.4.c" title="§1.2.4.(c) Class literal" |
| class="sect">§1.2.4.(c)</a> : |
| <strong>Syntax for role class literals</strong><p>Previously, the syntax <code>R<@t>.class</code> was not supported. |
| This restriction has been removed. |
| |
| </p> |
| </li> |
| <li><a href="s1.html#s1.3" |
| title="§1.3 Acquisition and implicit inheritance of role classes" |
| class="sect">§1.3</a> : |
| <strong>Teams extending non-team classes</strong><p>Previously, <code>org.objectteams.Team</code> was the super class of all team classes. |
| As a consequence a team could not extend a non-team class. |
| This restriction has been removed by introducing a new super-type of all teams, |
| the interface <code>org.objectteams.ITeam</code>. |
| This change also affects some paragraphs in <a href="s6.html" title="§6 Object Teams API" class="sect">§6</a> as members |
| have been moved to the new interface. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.4.c" |
| title="§4.4.(c) Mapping the result of a base method" |
| class="sect">§4.4.(c)</a> : |
| <strong>Further restrict result mapping in after callin bindings</strong><p>Clarify that <code>after</code> callin bindings cannot use the <code>-></code> |
| token to map a result value. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.8.a" title="§4.8.(a) Precedence declaration" |
| class="sect">§4.8.(a)</a> : |
| <strong>Precedence declarations affecting <code>after</code> callin bindings.</strong><p>While previously the effect of precedence declarations was underspecified it has been |
| defined that the order of elements in a precedence declaration affects their <em>priority</em> |
| similar to <a href="s5.html#s5.1" title="§5.1 Effect of team activation" |
| class="sect">§5.1</a>. This implies that the execution order for |
| <code>after</code> bindings is now reversed compared to the previous implementation. |
| In order to visualize this in the program it is now mandatory to mark precedence declarations |
| for after bindings with the keyword <code>after</code>. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.10" title="§4.10 Generic callin bindings" |
| class="sect">§4.10</a>, <a href="s4.html#s4.10.a" title="§4.10.(a) Fresh type parameter" |
| class="sect">§4.10.(a)</a> : |
| <strong>Generic callin bindings</strong><p>Minor changes to give room for new paragraph <a href="s4.html#s4.10.e" |
| title="§4.10.(e) Propagating type parameters" |
| class="sect">§4.10.(e)</a>. |
| </p> |
| </li> |
| <li><a href="s5.html#s5.4.1.a" title="§5.4.1.(a) Method binding guards" |
| class="sect">§5.4.1.(a)</a> : |
| <strong>Scope of regular binding guard</strong><p>Removed an erroneous sentence about the special identifier <code>result</code> in a regular method binding guard. |
| Since parameter mappings are applied before evaluating the guard, the result value can be accessed through |
| a result mapping (<a href="s4.html#s4.4.c" |
| title="§4.4.(c) Mapping the result of a base method" |
| class="sect">§4.4.(c)</a>). Furthermore, the sentence actually confused |
| base and role sides. |
| |
| </p> |
| </li> |
| <li><a href="sA.html#sA.3.2" title="§A.3.2 CalloutBinding" class="sect">§A.3.2</a>, <a href="sA.html#sA.3.3" title="§A.3.3 Callin binding" class="sect">§A.3.3</a> : |
| <strong>Syntax: generic method bindings</strong><p>The location of possible type parameters in a method binding has been made explicit.</p> |
| </li> |
| </ul> |
| </div> |
| </div> |
| <div class="sect depth2" id="sB.2"> |
| <h2 class="sect">§B.2 Additions between versions<a class="img" href="sB.html#sB.2" |
| title="PermaLink to §B.2 Additions between versions"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png" |
| alt="" /></a><span class="toplink"><a href="#top">↑ §B</a></span></h2> |
| <div class="subsect depth3" id="sB.2.1"> |
| <h4 class="subsect">(1) <span class="title">Between OTJLD 1.0 and OTJLD 1.1</span><a class="img" href="sB.html#sB.2.1" |
| title="PermaLink to (1) Between OTJLD 1.0 and OTJLD 1.1"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png" |
| alt="" /></a></h4> |
| <ul> |
| <li><a href="s1.html#s1.2.4.c" title="§1.2.4.(c) Class literal" |
| class="sect">§1.2.4.(c)</a>: |
| <strong>Role class literal</strong><p> |
| Made existing feature explicit and introduce new qualified class literal for externalized roles. |
| |
| </p> |
| </li> |
| <li><a href="s3.html#s3.1.j" title="§3.1.(j) Inferred callout" |
| class="sect">§3.1.(j)</a> and <a href="s3.html#s3.5.h" title="§3.5.(h) Inferred callout" |
| class="sect">§3.5.(h)</a> : |
| <strong>Inferred callout</strong><p> |
| New feature. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.6.a" |
| title="§4.6.(a) Private methods from super classes" |
| class="sect">§4.6.(a)</a> : |
| <strong>Callin-binding private methods from super classes</strong><p> |
| Added a necessary restriction. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.9" title="§4.9 Callin inheritance" class="sect">§4.9</a> : |
| <strong>Callin inheritance</strong><p> |
| Clarified issues that where under-specified or insufficiently explained, specifically: |
| |
| </p> |
| <ul> |
| <li>Effect of callin bindings on inherited or overridden base methods |
| (<a href="s4.html#s4.9.1" title="§4.9.1 Base side inheritance" |
| class="sect">§4.9.1</a>). |
| </li> |
| <li>Interplay of callin bindings and base methods with covariant return types |
| (<a href="s4.html#s4.9.3" title="§4.9.3 Covariant return types" |
| class="sect">§4.9.3</a>) |
| </li> |
| </ul> |
| </li> |
| <li><a href="s4.html#s4.10" title="§4.10 Generic callin bindings" |
| class="sect">§4.10</a>: |
| <strong>Generic replace bindings</strong><p> |
| Reconcile type safety of replace bindings as introduced in <a href="s4.html#s4.5.d" title="§4.5.(d) Typing rules" class="sect">§4.5.(d)</a> |
| with desirable flexibility by using type parameters. |
| |
| </p> |
| </li> |
| <li><a href="s7.html#s7.2.b" title="§7.2.(b) Arrays of Confined" |
| class="sect">§7.2.(b)</a> : |
| <strong>Arrays of Confined</strong><p> |
| Added a necessary restriction. |
| |
| </p> |
| </li> |
| </ul> |
| </div> |
| <div class="subsect depth3" id="sB.2.2"> |
| <h4 class="subsect">(2) <span class="title">Between OTJLD 1.1 and OTJLD 1.2</span><a class="img" href="sB.html#sB.2.2" |
| title="PermaLink to (2) Between OTJLD 1.1 and OTJLD 1.2"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png" |
| alt="" /></a></h4> |
| <ul> |
| <li><a href="s1.html#s1.2.2.h" title="§1.2.2.(h) Externalized creation" |
| class="sect">§1.2.2.(h)</a> : |
| <strong>Externalized creation</strong><p>Added alternative syntax using value parameter and changed title.</p> |
| </li> |
| <li><a href="s1.html#s1.2.5.f" title="§1.2.5.(f) Imports in role files" |
| class="sect">§1.2.5.(f)</a> : |
| <strong>Imports in role files</strong><p>Added a missing rule defining the effect of imports in role files.</p> |
| </li> |
| <li><a href="s1.html#s1.3.1.c" |
| title="§1.3.1.(c) Overriding and implicit inheritance" |
| class="sect">§1.3.1.(c)</a> : |
| <strong>@Override annotation for roles</strong><p>The regular <code>@Override</code> annotation (Java ≥5) has been extended to apply to role classes, too. |
| |
| </p> |
| </li> |
| <li><a href="s1.html#s1.3.1.k" title="§1.3.1.(k) Covariant return types" |
| class="sect">§1.3.1.(k)</a> : |
| <strong>Covariant return types</strong><p>Necessary constraint for covariant return types in the presence of both implicit and explicit inheritance. |
| |
| </p> |
| </li> |
| <li><a href="s2.html#s2.1.2.c" |
| title="§2.1.2.(c) Base class decapsulation" |
| class="sect">§2.1.2.(c)</a> : |
| <strong>Binding to final base class</strong><p>It has been added that binding to a final base class is now considered as decapsulation, too. |
| |
| </p> |
| </li> |
| <li><a href="s2.html#s2.2.f" title="§2.2.(f) Ambiguous lowering" |
| class="sect">§2.2.(f)</a> : |
| <strong>Ambiguous lowering</strong><p>A diagnostic has been added to detect situations where lowering might be intended |
| but fails because the declared type is <code>java.lang.Object</code>, |
| which makes a potential lowering translation unnecessary and thus ambiguous. |
| |
| </p> |
| </li> |
| <li><a href="s2.html#s2.3.2.e" |
| title="§2.3.2.(e) Generic declared lifting" |
| class="sect">§2.3.2.(e)</a> : |
| <strong>Generic declared lifting</strong><p>Support passing unrelated base types into the same method with declared lifting. |
| |
| </p> |
| </li> |
| <li><a href="s2.html#s2.6.g" |
| title="§2.6.(g) Decapsulation via base reference" |
| class="sect">§2.6.(g)</a> : |
| <strong>Decapsulation via base reference</strong><p>Extended applicability of decapsulation to two more positions. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.3.f" title="§4.3.(f) Base super calls" |
| class="sect">§4.3.(f)</a> : |
| <strong>Base super call</strong><p>Support base calls directly to the super version of the bound base method, |
| thus bypassing both the exact bound base method and also any further callins |
| relating to this base method or its super version. |
| |
| </p> |
| </li> |
| <li><a href="s5.html#s5.4.b" title="§5.4.(b) No side effects" |
| class="sect">§5.4.(b)</a> : |
| <strong>Side-effects in guard predicates</strong><p>Migrate previous note about a future feature to a regular paragraph.</p> |
| </li> |
| <li><a href="s5.html#s5.4.c" title="§5.4.(c) Exceptions" class="sect">§5.4.(c)</a> : |
| <strong>Exceptions in guard predicates</strong><p>Clarify the effect of exceptions thrown from a guard predicate.</p> |
| </li> |
| <li><a href="s6.html#s6.2.d" title="§6.2.(d) Exceptions" class="sect">§6.2.(d)</a> : |
| <strong>LiftingVetoException</strong><p>Added documentation for the mostly internal <code>LiftingVetoException</code> and how |
| it could actually be used in client code. |
| |
| </p> |
| </li> |
| <li><a href="s6.html#s6.2.e" title="§6.2.(e) Role migration" |
| class="sect">§6.2.(e)</a> : |
| <strong>Role migration</strong><p>Added two interfaces to add migration capabilities to a role class. |
| |
| </p> |
| </li> |
| </ul> |
| </div> |
| <div class="subsect depth3" id="sB.2.3"> |
| <h4 class="subsect">(3) <span class="title">Between OTJLD 1.2 and OTJLD 1.3</span><a class="img" href="sB.html#sB.2.3" |
| title="PermaLink to (3) Between OTJLD 1.2 and OTJLD 1.3"><img style="vertical-align:text-top;margin-left:5px;" src="../images/permalink.png" |
| alt="" /></a></h4> |
| <ul> |
| <li><a href="s3.html#s3.1.k" title="§3.1.(k) Callout to generic method" |
| class="sect">§3.1.(k)</a> : |
| <strong>Callout to generic method</strong><p>Added a rule on how a callout binding may refer to a generic base method. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.1.h" title="§4.1.(h) Method of enclosing class" |
| class="sect">§4.1.(h)</a> : |
| <strong>Binding to team methods</strong><p><code>before</code> and <code>after</code> callin bindings can now |
| bind to methods of an enclosing class, too. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.8.d" |
| title="§4.8.(d) Multiple precedence statements" |
| class="sect">§4.8.(d)</a> : |
| <strong>Order when merging precedence declarations</strong><p> |
| Clarified how several precedence declarations are merged, which was underspecified, |
| because the C3 algorithm needs ordered inputs, but this order was not specified. |
| |
| </p> |
| </li> |
| <li><a href="s4.html#s4.10.e" |
| title="§4.10.(e) Propagating type parameters" |
| class="sect">§4.10.(e)</a> : |
| <strong>Propagating type parameters in callin bindings</strong><p> |
| In addition to capturing covariant return types, a callin binding |
| may also declared type parameters in order to propagate genericity |
| from its base method to the role method. |
| |
| </p> |
| </li> |
| <li><a href="s5.html#s5.3.d" |
| title="§5.3.(d) Configuring implicit activation" |
| class="sect">§5.3.(d)</a> : |
| <strong>Configuring implicit activation</strong><p>Mechanisms have been added for configuring implicit team activation. |
| The default has been changed to not apply implicit activation. |
| A corresponding note has also been added to <a href="s5.html#s5.3" title="§5.3 Implicit team activation" |
| class="sect">§5.3</a></p> |
| </li> |
| <li><a href="s9.html#s9.2.1.a" |
| title="§9.2.1.(a) Instance constrained type parameters" |
| class="sect">§9.2.1.(a)</a> : |
| <strong>Instance constrained type parameter</strong><p> |
| Type anchors can now be applied to type parameters, too, |
| thus expressing a new kind of constraint on the type parameter. |
| |
| </p> |
| </li> |
| </ul> |
| </div> |
| </div> |
| </div> |
| <table class="nav"> |
| <tr> |
| <td class="back"><a href="sA.html" rel="prev"><< §A OT/J Syntax</a></td> |
| <td class="top"><a href="index.html" rel="contents">↑ Table of Contents ↑</a></td> |
| <td class="next"></td> |
| </tr> |
| </table> |
| </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>© Stephan Herrmann, Christine Hundt, Marco Mosconi</address> |
| OT/J version 1.3 — last modified: 2010-06-08 |
| </div> |
| </body> |
| </html> |