<< §8 Join Point Queries | ↑ Table of Contents ↑ | §A OT/J Syntax >> |
§9 Value Dependent Classes
Generalizing externalized roles
§9.1 Defining classes with value parameters↑ §9
(a) Value parameter declaration
Within the angle brackets that mark the parameters of a generic class also value parameters can be declared. In contrast to a type parameter, a value parameter is denoted as a pair of two identifiers: a type and a free name, e.g.,
class MyClass<YourType aName> { ...
Note that value parameters are valid for classes only, not for interfaces.
(b) Value parameter application
Within the given class (MyClass
) the parameter name (aName
) can be used
like a final field of the given type (YourType
). In contrast to regular final fields
the assignment to this name occurs even before the constructor is executed.
(c) Role types as dependent types
Any role type can be interpreted as a value dependent type, however, in the declaration of a role type the value parameter remains implicit: it is identical to the enclosing team instance.
§9.2 Using classes with value parameters↑ §9
When using a class which declares one or more value parameters (type anchors) a corresponding anchor value has to be provided.
§9.2.1 Parameter substitution↑ §9.2
Substitution of a type anchor of a class MyClass<YourType p>
is denoted as
MyClass<@v>
.
In this term v
must be a value which is conform to the declaration of the value
parameter "YourType p
", ie., v
must have the static type YourType
.
The value passed for substituting a type anchor must be a path of variables declared as final
.
Obviously, only the first element in such a path can be a local variable or a method argument,
all other elements have to be fields. The reason for requiring final variables is
in type checking as discussed next.
Note:
Externalized roles as defined in §1.2.2.(b) are a special case of types with a value parameter, where the value is an instance of the enclosing team.(a) Instance constrained type parameters
In addition to normal usage, a value parameter can be applied nested to a regular type parameter:
class MyClass<YourType aName, DependentParam<@aName>> { ...
Here the type parameter DependentParam
is constrained to be anchored to aName
.
If a value parameter is used as a constraint for a regular type parameter any substitution for the type parameter must also supply a value matching the value parameter. The class from above could be applied like this:
final YourType anchor = new YourType(); MyClass <anchor, YourDependent<anchor>>
Within the declaring element (class or method) applications of the type variable representing the instance constrained type parameter must repeat the anchor verbatim, i.e., no substitutions are performed here.
§9.2.2 Type conformance↑ §9.2
Two value dependent types (anchored types) are considered conform only if the anchors of both types refer to the same object(s). The compiler must be able to statically analyze this anchor identity.
(a) Substitutions for type anchors
Only two substitutions are considered for determining anchor identity:
- If a method signature uses
this
as the anchor of any of its types, type checking an application of this method performs the following substitutions:
A simplethis
expression is substituted by the actual call target of the method application.
A qualifiedOuter.this
expression is substituted by the corresponding enclosing instance of the call target. - Assignments from a
final
identifier to anotherfinal
identifier are transitively followed, i.e., ift1, t2
are final, after an assignmentt1=t2
the typesC<@t1>
andC<@t2>
are considered identical. OtherwiseC<@t1>
andC<@t2>
are incommensurable.
Attaching an actual parameter to a formal parameter in a method call is also considered as an assignment with respect to this rule.
(b) Conformance of raw types
After anchors have been proven identical, the raw types are checked for compatibility using the standard Java rules.
§9.3 Restrictions and limitations↑ §9
(a) No overriding
Types with value parameters that are declared outside a team cannot be overridden, as roles can be. Therefor, implicit inheritance does not apply for these types.
(b) Only first parameter
Currently only the first parameter of a class may be a value parameter. This restriction may be removed in the future.
<< §8 Join Point Queries | ↑ Table of Contents ↑ | §A OT/J Syntax >> |