| // Copyright (c) 2016, the Dart project authors. Please see the AUTHORS file |
| // for details. All rights reserved. Use of this source code is governed by a |
| // BSD-style license that can be found in the LICENSE file. |
| |
| library fasta.procedure_builder; |
| |
| import 'package:front_end/src/fasta/builder/omitted_type_builder.dart'; |
| import 'package:kernel/ast.dart'; |
| import 'package:kernel/class_hierarchy.dart'; |
| |
| import '../builder/builder.dart'; |
| import '../builder/class_builder.dart'; |
| import '../builder/declaration_builder.dart'; |
| import '../builder/extension_builder.dart'; |
| import '../builder/formal_parameter_builder.dart'; |
| import '../builder/function_builder.dart'; |
| import '../builder/library_builder.dart'; |
| import '../builder/member_builder.dart'; |
| import '../builder/metadata_builder.dart'; |
| import '../builder/type_builder.dart'; |
| import '../builder/type_variable_builder.dart'; |
| import '../identifiers.dart'; |
| import '../kernel/internal_ast.dart' show VariableDeclarationImpl; |
| import '../kernel/kernel_helper.dart'; |
| import '../messages.dart' |
| show |
| messagePatchDeclarationMismatch, |
| messagePatchDeclarationOrigin, |
| messagePatchNonExternal, |
| noLength, |
| templateRequiredNamedParameterHasDefaultValueError; |
| import '../modifier.dart'; |
| import '../scope.dart'; |
| import '../source/source_loader.dart' show SourceLoader; |
| import '../type_inference/type_inference_engine.dart' |
| show IncludesTypeParametersNonCovariantly; |
| import '../util/helpers.dart' show DelayedActionPerformer; |
| import 'source_member_builder.dart'; |
| |
| abstract class SourceFunctionBuilder |
| implements FunctionBuilder, SourceMemberBuilder { |
| List<MetadataBuilder>? get metadata; |
| |
| TypeBuilder get returnType; |
| |
| List<TypeVariableBuilder>? get typeVariables; |
| |
| List<FormalParameterBuilder>? get formals; |
| |
| AsyncMarker get asyncModifier; |
| |
| @override |
| ProcedureKind? get kind; |
| |
| @override |
| bool get isAbstract; |
| |
| @override |
| bool get isConstructor; |
| |
| @override |
| bool get isRegularMethod; |
| |
| @override |
| bool get isGetter; |
| |
| @override |
| bool get isSetter; |
| |
| @override |
| bool get isOperator; |
| |
| @override |
| bool get isFactory; |
| |
| /// This is the formal parameter scope as specified in the Dart Programming |
| /// Language Specification, 4th ed, section 9.2. |
| Scope computeFormalParameterScope(Scope parent); |
| |
| Scope computeFormalParameterInitializerScope(Scope parent); |
| |
| /// This scope doesn't correspond to any scope specified in the Dart |
| /// Programming Language Specification, 4th ed. It's an unspecified extension |
| /// to support generic methods. |
| Scope computeTypeParameterScope(Scope parent); |
| |
| FormalParameterBuilder? getFormal(Identifier identifier); |
| |
| String? get nativeMethodName; |
| |
| Statement? get body; |
| |
| void set body(Statement? newBody); |
| |
| @override |
| bool get isNative; |
| |
| /// Returns the [index]th parameter of this function. |
| /// |
| /// The index is the syntactical index, including both positional and named |
| /// parameter in the order they are declared, and excluding the synthesized |
| /// this parameter on extension instance members. |
| VariableDeclaration getFormalParameter(int index); |
| |
| /// If this is an extension instance method or constructor with lowering |
| /// enabled, the tear off parameter corresponding to the [index]th parameter |
| /// on the instance method or constructor is returned. |
| /// |
| /// This is used to update the default value for the closure parameter when |
| /// it has been computed for the original parameter. |
| VariableDeclaration? getTearOffParameter(int index); |
| |
| /// Returns the parameter for 'this' synthetically added to extension |
| /// instance members. |
| VariableDeclaration? get extensionThis; |
| |
| /// Returns a list of synthetic type parameters added to extension instance |
| /// members. |
| List<TypeParameter>? get extensionTypeParameters; |
| |
| void becomeNative(SourceLoader loader); |
| |
| bool checkPatch(SourceFunctionBuilder patch); |
| |
| void reportPatchMismatch(Builder patch); |
| } |
| |
| /// Common base class for constructor and procedure builders. |
| abstract class SourceFunctionBuilderImpl extends SourceMemberBuilderImpl |
| implements SourceFunctionBuilder, InferredTypeListener { |
| @override |
| final List<MetadataBuilder>? metadata; |
| |
| @override |
| final int modifiers; |
| |
| @override |
| final String name; |
| |
| @override |
| final List<TypeVariableBuilder>? typeVariables; |
| |
| @override |
| final List<FormalParameterBuilder>? formals; |
| |
| /// If this procedure is an extension instance member, [_extensionThis] holds |
| /// the synthetically added `this` parameter. |
| VariableDeclaration? _extensionThis; |
| |
| /// If this procedure is an extension instance member, |
| /// [_extensionTypeParameters] holds the type parameters copied from the |
| /// extension declaration. |
| List<TypeParameter>? _extensionTypeParameters; |
| |
| SourceFunctionBuilderImpl( |
| this.metadata, |
| this.modifiers, |
| this.name, |
| this.typeVariables, |
| this.formals, |
| LibraryBuilder compilationUnit, |
| int charOffset, |
| this.nativeMethodName) |
| : super(compilationUnit, charOffset) { |
| returnType.registerInferredTypeListener(this); |
| if (formals != null) { |
| for (int i = 0; i < formals!.length; i++) { |
| formals![i].parent = this; |
| } |
| } |
| } |
| |
| @override |
| String get debugName => "FunctionBuilder"; |
| |
| @override |
| AsyncMarker get asyncModifier; |
| |
| @override |
| bool get isConstructor => false; |
| |
| @override |
| bool get isAbstract => (modifiers & abstractMask) != 0; |
| |
| @override |
| bool get isRegularMethod => identical(ProcedureKind.Method, kind); |
| |
| @override |
| bool get isGetter => identical(ProcedureKind.Getter, kind); |
| |
| @override |
| bool get isSetter => identical(ProcedureKind.Setter, kind); |
| |
| @override |
| bool get isOperator => identical(ProcedureKind.Operator, kind); |
| |
| @override |
| bool get isFactory => identical(ProcedureKind.Factory, kind); |
| |
| @override |
| bool get isExternal => (modifiers & externalMask) != 0; |
| |
| @override |
| bool get isAssignable => false; |
| |
| @override |
| Scope computeFormalParameterScope(Scope parent) { |
| if (formals == null) return parent; |
| Map<String, Builder> local = <String, Builder>{}; |
| for (FormalParameterBuilder formal in formals!) { |
| if (!isConstructor || |
| !formal.isInitializingFormal && !formal.isSuperInitializingFormal) { |
| local[formal.name] = formal; |
| } |
| } |
| return new Scope( |
| local: local, |
| parent: parent, |
| debugName: "formal parameter", |
| isModifiable: false); |
| } |
| |
| @override |
| Scope computeFormalParameterInitializerScope(Scope parent) { |
| // From |
| // [dartLangSpec.tex](../../../../../../docs/language/dartLangSpec.tex) at |
| // revision 94b23d3b125e9d246e07a2b43b61740759a0dace: |
| // |
| // When the formal parameter list of a non-redirecting generative |
| // constructor contains any initializing formals, a new scope is |
| // introduced, the _formal parameter initializer scope_, which is the |
| // current scope of the initializer list of the constructor, and which is |
| // enclosed in the scope where the constructor is declared. Each |
| // initializing formal in the formal parameter list introduces a final |
| // local variable into the formal parameter initializer scope, but not into |
| // the formal parameter scope; every other formal parameter introduces a |
| // local variable into both the formal parameter scope and the formal |
| // parameter initializer scope. |
| |
| if (formals == null) return parent; |
| Map<String, Builder> local = <String, Builder>{}; |
| for (FormalParameterBuilder formal in formals!) { |
| local[formal.name] = formal.forFormalParameterInitializerScope(); |
| } |
| return new Scope( |
| local: local, |
| parent: parent, |
| debugName: "formal parameter initializer", |
| isModifiable: false); |
| } |
| |
| @override |
| Scope computeTypeParameterScope(Scope parent) { |
| if (typeVariables == null) return parent; |
| Map<String, Builder> local = <String, Builder>{}; |
| for (TypeVariableBuilder variable in typeVariables!) { |
| local[variable.name] = variable; |
| } |
| return new Scope( |
| local: local, |
| parent: parent, |
| debugName: "type parameter", |
| isModifiable: false); |
| } |
| |
| @override |
| FormalParameterBuilder? getFormal(Identifier identifier) { |
| if (formals != null) { |
| for (FormalParameterBuilder formal in formals!) { |
| if (formal.name == identifier.name && |
| formal.charOffset == identifier.charOffset) { |
| return formal; |
| } |
| } |
| // If we have any formals we should find the one we're looking for. |
| assert(false, "$identifier not found in $formals"); |
| } |
| return null; |
| } |
| |
| @override |
| final String? nativeMethodName; |
| |
| Statement? bodyInternal; |
| |
| @override |
| void set body(Statement? newBody) { |
| // if (newBody != null) { |
| // if (isAbstract) { |
| // // TODO(danrubel): Is this check needed? |
| // return internalProblem(messageInternalProblemBodyOnAbstractMethod, |
| // newBody.fileOffset, fileUri); |
| // } |
| // } |
| bodyInternal = newBody; |
| // A forwarding semi-stub is a method that is abstract in the source code, |
| // but which needs to have a forwarding stub body in order to ensure that |
| // covariance checks occur. We don't want to replace the forwarding stub |
| // body with null. |
| TreeNode? parent = function.parent; |
| if (!(newBody == null && |
| parent is Procedure && |
| parent.isForwardingSemiStub)) { |
| function.body = newBody; |
| newBody?.parent = function; |
| } |
| } |
| |
| @override |
| Statement? get body => bodyInternal ??= new EmptyStatement(); |
| |
| @override |
| bool get isNative => nativeMethodName != null; |
| |
| void buildFunction() { |
| function.asyncMarker = asyncModifier; |
| function.body = body; |
| body?.parent = function; |
| IncludesTypeParametersNonCovariantly? needsCheckVisitor; |
| if (!isConstructor && !isFactory && parent is ClassBuilder) { |
| Class enclosingClass = classBuilder!.cls; |
| if (enclosingClass.typeParameters.isNotEmpty) { |
| needsCheckVisitor = new IncludesTypeParametersNonCovariantly( |
| enclosingClass.typeParameters, |
| // We are checking the parameter types which are in a |
| // contravariant position. |
| initialVariance: Variance.contravariant); |
| } |
| } |
| if (typeVariables != null) { |
| for (TypeVariableBuilder t in typeVariables!) { |
| TypeParameter parameter = t.parameter; |
| function.typeParameters.add(parameter); |
| if (needsCheckVisitor != null) { |
| if (parameter.bound.accept(needsCheckVisitor)) { |
| parameter.isCovariantByClass = true; |
| } |
| } |
| } |
| setParents(function.typeParameters, function); |
| } |
| if (formals != null) { |
| for (FormalParameterBuilder formal in formals!) { |
| VariableDeclaration parameter = formal.build(libraryBuilder); |
| if (needsCheckVisitor != null) { |
| if (parameter.type.accept(needsCheckVisitor)) { |
| parameter.isCovariantByClass = true; |
| } |
| } |
| if (formal.isNamed) { |
| function.namedParameters.add(parameter); |
| } else { |
| function.positionalParameters.add(parameter); |
| } |
| parameter.parent = function; |
| if (formal.isRequiredPositional) { |
| function.requiredParameterCount++; |
| } |
| |
| if (libraryBuilder.isNonNullableByDefault) { |
| // Required named parameters can't have default values. |
| if (formal.isRequiredNamed && formal.initializerToken != null) { |
| libraryBuilder.addProblem( |
| templateRequiredNamedParameterHasDefaultValueError |
| .withArguments(formal.name), |
| formal.charOffset, |
| formal.name.length, |
| formal.fileUri); |
| } |
| } |
| } |
| } |
| if (!isExtensionInstanceMember && |
| isSetter && |
| (formals?.length != 1 || formals![0].isOptionalPositional)) { |
| // Replace illegal parameters by single dummy parameter. |
| // Do this after building the parameters, since the diet listener |
| // assumes that parameters are built, even if illegal in number. |
| VariableDeclaration parameter = new VariableDeclarationImpl("#synthetic"); |
| function.positionalParameters.clear(); |
| function.positionalParameters.add(parameter); |
| parameter.parent = function; |
| function.namedParameters.clear(); |
| function.requiredParameterCount = 1; |
| } |
| if (returnType is! InferableTypeBuilder) { |
| function.returnType = |
| returnType.build(libraryBuilder, TypeUse.returnType); |
| } |
| if (isExtensionInstanceMember) { |
| ExtensionBuilder extensionBuilder = parent as ExtensionBuilder; |
| _extensionThis = function.positionalParameters.first; |
| if (extensionBuilder.typeParameters != null) { |
| int count = extensionBuilder.typeParameters!.length; |
| _extensionTypeParameters = new List<TypeParameter>.generate( |
| count, (int index) => function.typeParameters[index], |
| growable: false); |
| } |
| } |
| } |
| |
| @override |
| VariableDeclaration getFormalParameter(int index) { |
| if (isExtensionInstanceMember) { |
| return formals![index + 1].variable!; |
| } else { |
| return formals![index].variable!; |
| } |
| } |
| |
| @override |
| VariableDeclaration? getTearOffParameter(int index) => null; |
| |
| @override |
| VariableDeclaration? get extensionThis { |
| assert(_extensionThis != null || !isExtensionInstanceMember, |
| "ProcedureBuilder.extensionThis has not been set."); |
| return _extensionThis; |
| } |
| |
| @override |
| List<TypeParameter>? get extensionTypeParameters { |
| // Use [_extensionThis] as marker for whether extension type parameters have |
| // been computed. |
| assert(_extensionThis != null || !isExtensionInstanceMember, |
| "ProcedureBuilder.extensionTypeParameters has not been set."); |
| return _extensionTypeParameters; |
| } |
| |
| @override |
| void onInferredType(DartType type) { |
| function.returnType = type; |
| } |
| |
| bool _hasBuiltOutlineExpressions = false; |
| |
| @override |
| void buildOutlineExpressions( |
| ClassHierarchy classHierarchy, |
| List<DelayedActionPerformer> delayedActionPerformers, |
| List<DelayedDefaultValueCloner> delayedDefaultValueCloners) { |
| if (!_hasBuiltOutlineExpressions) { |
| DeclarationBuilder? classOrExtensionBuilder = |
| isClassMember || isExtensionMember |
| ? parent as DeclarationBuilder |
| : null; |
| Scope parentScope = |
| classOrExtensionBuilder?.scope ?? libraryBuilder.scope; |
| MetadataBuilder.buildAnnotations(member, metadata, libraryBuilder, |
| classOrExtensionBuilder, this, fileUri, parentScope); |
| if (typeVariables != null) { |
| for (int i = 0; i < typeVariables!.length; i++) { |
| typeVariables![i].buildOutlineExpressions( |
| libraryBuilder, |
| classOrExtensionBuilder, |
| this, |
| classHierarchy, |
| delayedActionPerformers, |
| computeTypeParameterScope(parentScope)); |
| } |
| } |
| |
| if (formals != null) { |
| // For const constructors we need to include default parameter values |
| // into the outline. For all other formals we need to call |
| // buildOutlineExpressions to clear initializerToken to prevent |
| // consuming too much memory. |
| for (FormalParameterBuilder formal in formals!) { |
| formal.buildOutlineExpressions( |
| libraryBuilder, delayedActionPerformers); |
| } |
| } |
| _hasBuiltOutlineExpressions = true; |
| } |
| } |
| |
| @override |
| void becomeNative(SourceLoader loader) { |
| MemberBuilder constructor = loader.getNativeAnnotation(); |
| Arguments arguments = |
| new Arguments(<Expression>[new StringLiteral(nativeMethodName!)]); |
| Expression annotation; |
| if (constructor.isConstructor) { |
| annotation = new ConstructorInvocation( |
| constructor.member as Constructor, arguments) |
| ..isConst = true; |
| } else { |
| annotation = |
| new StaticInvocation(constructor.member as Procedure, arguments) |
| ..isConst = true; |
| } |
| member.addAnnotation(annotation); |
| } |
| |
| @override |
| bool checkPatch(SourceFunctionBuilder patch) { |
| if (!isExternal && !patch.libraryBuilder.isAugmentation) { |
| patch.libraryBuilder.addProblem( |
| messagePatchNonExternal, patch.charOffset, noLength, patch.fileUri!, |
| context: [ |
| messagePatchDeclarationOrigin.withLocation( |
| fileUri, charOffset, noLength) |
| ]); |
| return false; |
| } |
| return true; |
| } |
| |
| @override |
| void reportPatchMismatch(Builder patch) { |
| libraryBuilder.addProblem(messagePatchDeclarationMismatch, patch.charOffset, |
| noLength, patch.fileUri!, context: [ |
| messagePatchDeclarationOrigin.withLocation(fileUri, charOffset, noLength) |
| ]); |
| } |
| } |
