1 # This file is part of NIT ( http://www.nitlanguage.org ).
3 # Copyright 2012 Jean Privat <jean@pryen.org>
5 # Licensed under the Apache License, Version 2.0 (the "License");
6 # you may not use this file except in compliance with the License.
7 # You may obtain a copy of the License at
9 # http://www.apache.org/licenses/LICENSE-2.0
11 # Unless required by applicable law or agreed to in writing, software
12 # distributed under the License is distributed on an "AS IS" BASIS,
13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 # See the License for the specific language governing permissions and
15 # limitations under the License.
17 # Computing of super-constructors that must be implicitly called at the begin of constructors.
18 # The current rules are a bit crazy but whatever.
19 module auto_super_init
22 private import annotation
24 redef class ToolContext
25 # Phase that inject `super` in constructors that need it.
26 var auto_super_init_phase
: Phase = new AutoSuperInitPhase(self, [typing_phase
])
29 private class AutoSuperInitPhase
31 redef fun process_npropdef
(npropdef
) do if npropdef
isa AMethPropdef then npropdef
.do_auto_super_init
(toolcontext
.modelbuilder
)
34 private class AutoSuperInitVisitor
38 n
.accept_auto_super_init
(self)
42 var has_explicit_super_init
: nullable ANode = null
44 # The method is broken, so avoid to display additional errors
49 redef class AMethPropdef
50 # In case of introduced constructor, the list of implicit auto super init constructors invoked (if needed)
51 var auto_super_inits
: nullable Array[CallSite] = null
53 # In case of redefined constructors, is an implicit call-to-super required?
54 var auto_super_call
= false
56 # Collect initializers and build the auto-init
57 fun do_auto_super_init
(modelbuilder
: ModelBuilder)
59 var mclassdef
= self.parent
.as(AClassdef).mclassdef
.as(not null)
60 var mpropdef
= self.mpropdef
.as(not null)
61 var mmodule
= mpropdef
.mclassdef
.mmodule
62 var anchor
= mclassdef
.bound_mtype
63 var recvtype
= mclassdef
.mclass
.mclass_type
65 # Get the annotation, but check its pertinence before returning
66 var nosuper
= get_single_annotation
("nosuper", modelbuilder
)
68 # Collect only for constructors
69 if not mpropdef
.mproperty
.is_init
or mpropdef
.mproperty
.is_new
then
70 if nosuper
!= null then modelbuilder
.error
(nosuper
, "Error: nosuper only in `init`")
74 # FIXME: THIS IS STUPID (be here to keep the old code working)
75 if not mpropdef
.mclassdef
.is_intro
then return
77 # Do we inherit for a constructor?
79 for cd
in mclassdef
.in_hierarchy
.direct_greaters
do
80 if cd
.mclass
.kind
.need_init
then skip
= false
84 # Now we search for the absence of any explicit super-init invocation
86 # * via a call of an other init
87 var nblock
= self.n_block
88 if nblock
!= null then
89 var v
= new AutoSuperInitVisitor
91 var anode
= v
.has_explicit_super_init
93 if nosuper
!= null then modelbuilder
.error
(anode
, "Error: method is annotated nosuper but a constructor call is present")
96 if v
.is_broken
then return # skip
99 if nosuper
!= null then return
101 # Still here? So it means that we must add an implicit super-call on redefinitions.
102 if not mpropdef
.is_intro
then
103 auto_super_call
= true
104 mpropdef
.has_supercall
= true
108 # Still here? So it means that we must determine what super inits need to be automatically invoked
109 # The code that follow is required to deal with complex cases with old-style and new-style inits
111 # Look for old-style super constructors
112 var auto_super_inits
= new Array[CallSite]
113 for msupertype
in mclassdef
.supertypes
do
114 # FIXME: the order is quite arbitrary
115 if not msupertype
.mclass
.kind
.need_init
then continue
116 msupertype
= msupertype
.anchor_to
(mmodule
, mclassdef
.bound_mtype
)
117 var candidate
= modelbuilder
.try_get_mproperty_by_name2
(self, mmodule
, msupertype
, mpropdef
.mproperty
.name
)
118 if candidate
== null then
119 candidate
= modelbuilder
.try_get_mproperty_by_name2
(self, mmodule
, msupertype
, "init")
121 if candidate
== null then
122 modelbuilder
.error
(self, "Error: Cannot do an implicit constructor call in {mpropdef}; there is no constructor named {mpropdef.mproperty.name} in {msupertype}.")
125 assert candidate
isa MMethod
127 # Skip new-style init
128 if candidate
.is_root_init
then continue
130 var candidatedefs
= candidate
.lookup_definitions
(mmodule
, anchor
)
131 var candidatedef
= candidatedefs
.first
132 # TODO, we drop the others propdefs in the callsite, that is not great :(
134 var msignature
= candidatedef
.new_msignature
or else candidatedef
.msignature
135 msignature
= msignature
.resolve_for
(recvtype
, anchor
, mmodule
, true)
137 var callsite
= new CallSite(self, recvtype
, mmodule
, anchor
, true, candidate
, candidatedef
, msignature
, false)
138 auto_super_inits
.add
(callsite
)
141 # No old style? The look for new-style super constructors (called from a old style constructor)
142 var the_root_init_mmethod
= modelbuilder
.the_root_init_mmethod
143 if the_root_init_mmethod
!= null and auto_super_inits
.is_empty
then
144 var candidatedefs
= the_root_init_mmethod
.lookup_definitions
(mmodule
, anchor
)
146 # Search the longest-one and checks for conflict
147 var candidatedef
= candidatedefs
.first
148 if candidatedefs
.length
> 1 then
149 # Check for conflict in the order of initializers
150 # Each initializer list must me a prefix of the longest list
151 # part 1. find the longest list
152 for spd
in candidatedefs
do
153 if spd
.initializers
.length
> candidatedef
.initializers
.length
then candidatedef
= spd
156 for spd
in candidatedefs
do
158 for p
in spd
.initializers
do
159 if p
!= candidatedef
.initializers
[i
] then
160 modelbuilder
.error
(self, "Error: Cannot do an implicit constructor call to comflicting for inherited inits {spd}({spd.initializers.join(", ")}) and {candidatedef}({candidatedef.initializers.join(", ")}). NOTE: Do not mix old-style and new-style init!")
168 var msignature
= candidatedef
.new_msignature
or else candidatedef
.msignature
169 msignature
= msignature
.resolve_for
(recvtype
, anchor
, mmodule
, true)
171 var callsite
= new CallSite(self, recvtype
, mmodule
, anchor
, true, the_root_init_mmethod
, candidatedef
, msignature
, false)
172 auto_super_inits
.add
(callsite
)
174 if auto_super_inits
.is_empty
then
175 modelbuilder
.error
(self, "Error: No constructors to call implicitely in {mpropdef}. Call one explicitely.")
179 # Can the super-constructors be called?
180 for auto_super_init
in auto_super_inits
do
181 var auto_super_init_def
= auto_super_init
.mpropdef
182 var msig
= mpropdef
.msignature
.as(not null)
183 var supermsig
= auto_super_init
.msignature
184 if supermsig
.arity
> msig
.arity
then
185 modelbuilder
.error
(self, "Error: Cannot do an implicit constructor call to {auto_super_init_def}{supermsig}. Expected at least {supermsig.arity} arguments, got {msig.arity}.")
189 for sp
in supermsig
.mparameters
do
190 var p
= msig
.mparameters
[i
]
193 if not sub
.is_subtype
(mmodule
, anchor
, sup
) then
194 modelbuilder
.error
(self, "Error: Cannot do an implicit constructor call to {auto_super_init_def}{supermsig}. Expected argument #{i} of type {sp.mtype}, got implicit argument {p.name} of type {p.mtype}.")
200 self.auto_super_inits
= auto_super_inits
206 private fun accept_auto_super_init
(v
: AutoSuperInitVisitor) do end
210 redef class ASendExpr
211 redef fun accept_auto_super_init
(v
)
213 var callsite
= self.callsite
214 if callsite
== null then
218 if callsite
.mproperty
.is_init
then
219 v
.has_explicit_super_init
= self
224 redef class ASuperExpr
225 redef fun accept_auto_super_init
(v
)
227 # If the super is a standard call-next-method then there it is considered am explicit super init call
228 # The the super is a "super int" then it is also an explicit super init call
229 v
.has_explicit_super_init
= self