mirror of
https://github.com/pese-git/cherrypick.git
synced 2026-01-23 21:13:35 +00:00
76 lines
3.5 KiB
Dart
76 lines
3.5 KiB
Dart
//
|
||
// Copyright 2021 Sergey Penkovsky (sergey.penkovsky@gmail.com)
|
||
// Licensed under the Apache License, Version 2.0 (the "License");
|
||
// you may not use this file except in compliance with the License.
|
||
// You may obtain a copy of the License at
|
||
// http://www.apache.org/licenses/LICENSE-2.0
|
||
// Unless required by applicable law or agreed to in writing, software
|
||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
//
|
||
|
||
/// ----------------------------------------------------------------------------
|
||
/// BindParameterSpec - describes a single method parameter and how to resolve it.
|
||
///
|
||
/// ENGLISH
|
||
/// Describes a single parameter for a provider/binding method in the DI system.
|
||
/// Stores the parameter type, its optional `@named` key for named resolution,
|
||
/// and whether it is a runtime "params" argument. Used to generate code that
|
||
/// resolves dependencies from the DI scope:
|
||
/// - If the parameter is a dependency type (e.g. SomeDep), emits:
|
||
/// currentScope.resolve<SomeDep>()
|
||
/// - If the parameter is named, emits:
|
||
/// currentScope.resolve<SomeDep>(named: 'yourName')
|
||
/// - If it's a runtime parameter (e.g. via @params()), emits:
|
||
/// args
|
||
///
|
||
/// RUSSIAN
|
||
/// Описывает один параметр метода в DI, и его способ разрешения из контейнера.
|
||
/// Сохраняет имя типа, дополнительное имя (если параметр аннотирован через @named),
|
||
/// и признак runtime-параметра (@params).
|
||
/// Для обычной зависимости типа (например, SomeDep) генерирует строку вида:
|
||
/// currentScope.resolve<SomeDep>()
|
||
/// Для зависимости с именем:
|
||
/// currentScope.resolve<SomeDep>(named: 'имя')
|
||
/// Для runtime-параметра:
|
||
/// args
|
||
/// ----------------------------------------------------------------------------
|
||
class BindParameterSpec {
|
||
/// Type name of the parameter (e.g. SomeService)
|
||
/// Имя типа параметра (например, SomeService)
|
||
final String typeName;
|
||
|
||
/// Optional name for named resolution (from @named)
|
||
/// Необязательное имя для разрешения по имени (если аннотировано через @named)
|
||
final String? named;
|
||
|
||
/// True if this parameter uses @params and should be provided from runtime args
|
||
/// Признак, что параметр — runtime (через @params)
|
||
final bool isParams;
|
||
|
||
BindParameterSpec(this.typeName, this.named, {this.isParams = false});
|
||
|
||
/// --------------------------------------------------------------------------
|
||
/// generateArg
|
||
///
|
||
/// ENGLISH
|
||
/// Generates Dart code for resolving the dependency from the DI scope,
|
||
/// considering type, named, and param-argument.
|
||
///
|
||
/// RUSSIAN
|
||
/// Генерирует строку для получения зависимости из DI scope (с учётом имени
|
||
/// и типа параметра или runtime-режима @params).
|
||
/// --------------------------------------------------------------------------
|
||
String generateArg([String paramsVar = 'args']) {
|
||
if (isParams) {
|
||
return paramsVar;
|
||
}
|
||
if (named != null) {
|
||
return "currentScope.resolve<$typeName>(named: '$named')";
|
||
}
|
||
return "currentScope.resolve<$typeName>()";
|
||
}
|
||
}
|