Merge pull request #416 from flutter-it/rename_service_factory

Rename service factory

Author: escamoteur

.idea/libraries/Dart_SDK.xml

@@ -1,3 +1,7 @@
+## [8.2.0]
+
+Thanks to PR by @Hu-Wentao we now expose part of the internal state of get_it so tool authors have more options. While doing so internal renaming has happened, so where previously where the term "ServiceFactory" was uses we not use consistently `ObjectRegistration` and instead of variables with `factory` in the name we use `registration` this has not impact on the public API so it is not a breaking change.
+
 ## [8.1.0]
 
 * adding documentation https://github.com/flutter-it/get_it/issues/411

.idea/modules.xml

@@ -11,6 +11,21 @@ import 'package:meta/meta.dart';
 
 part 'get_it_impl.dart';
 
+/// You will see a rather esoteric looking test `(const Object() is! T)` at several places.
+/// It tests if [T] is a real type and not Object or dynamic.
+
+/// For each registered factory/singleton an [ObjectRegistration<T>] is created
+/// it holds either the instance of a Singleton or/and the creation functions
+/// for creating an instance when [get] is called
+///
+/// There are three different types:
+enum ObjectRegistrationType {
+  alwaysNew, // factory which means on every call of [get] a new instance is created
+  constant, // normal singleton
+  lazy, // lazy
+  cachedFactory, // cached factory
+}
+
 /// If your singleton that you register wants to use the manually signalling
 /// of its ready state, it can implement this interface class instead of using
 /// the [signalsReady] parameter of the registration functions
@@ -109,6 +124,31 @@ class WaitingTimeOutException implements Exception {
   }
 }
 
+abstract class ObjectRegistration<T extends Object> {
+  ObjectRegistrationType get registrationType;
+
+  /// In case of a named registration the instance name is here stored for easy access
+  String? get instanceName;
+
+  /// true if one of the async registration functions have been used
+  bool get isAsync;
+
+  /// If an existing Object gets registered or an async/lazy Singleton has finished
+  /// its creation, it is stored here
+  Object? get instance;
+
+  /// the type that was used when registering, used for runtime checks
+  Type get registeredWithType;
+
+  bool get isReady;
+
+  bool get isNamedRegistration => instanceName != null;
+
+  String get debugName => '$instanceName : $registeredWithType';
+
+  bool get canBeWaitedFor;
+}
+
 /// Very simple and easy to use service locator
 /// You register your object creation factory or an instance of an object with [registerFactory],
 /// [registerSingleton] or [registerLazySingleton]
@@ -451,6 +491,12 @@ abstract class GetIt {
     bool useWeakReference = false,
   });
 
+  /// find the first registration that matches the type [T]/[instanceName] or the [instance]
+  ObjectRegistration? findFirstObjectRegistration<T extends Object>({
+    Object? instance,
+    String? instanceName,
+  });
+
   /// Tests if an [instance] of an object or a Type ([T] or [type]) or a name [instanceName]
   /// is registered inside GetIt
   bool isRegistered<T extends Object>({