using System; using System.Collections.Generic; using System.Linq; namespace Umbraco.Core.Composing { /// /// Provides extension methods to the class. /// public static class ContainerExtensions { /// /// Gets an instance. /// /// The type of the instance. /// The container. /// An instance of the specified type. /// Throws an exception if the container failed to get an instance of the specified type. public static T GetInstance(this IContainer container) => (T) container.GetInstance(typeof(T)); /// /// Tries to get an instance. /// /// The type of the instance. /// An instance of the specified type, or null. /// Returns null if the container does not know how to get an instance /// of the specified type. Throws an exception if the container does know how /// to get an instance of the specified type, but failed to do so. public static T TryGetInstance(this IContainer container) => (T) container.TryGetInstance(typeof(T)); /// /// Gets registration for a service. /// /// The type of the service. /// The registrations for the service. public static IEnumerable GetRegistered(this IContainer container) => container.GetRegistered(typeof(TService)); /// /// Creates an instance with arguments. /// /// The type of the instance. /// The container. /// Arguments. /// An instance of the specified type. /// /// Throws an exception if the container failed to get an instance of the specified type. /// The arguments are used as dependencies by the container. /// public static T CreateInstance(this IContainer container, params object[] args) => (T) container.CreateInstance(typeof(T), args); /// /// Registers a service with an implementation type. /// public static void Register(this IContainer container, Lifetime lifetime = Lifetime.Transient) => container.Register(typeof(TService), typeof(TImplementing), lifetime); /// /// Registers a service with a named implementation type. /// public static void Register(this IContainer container, string name, Lifetime lifetime = Lifetime.Transient) => container.Register(typeof(TService), typeof(TImplementing), name, lifetime); /// /// Registers a service as its own implementation. /// public static void Register(this IContainer container, Lifetime lifetime = Lifetime.Transient) => container.Register(typeof(TService), lifetime); /// /// Registers a singleton service as its own implementation. /// public static void RegisterSingleton(this IContainer container) => container.Register(typeof(TService), Lifetime.Singleton); /// /// Registers a singleton service with an implementation type. /// public static void RegisterSingleton(this IContainer container) => container.Register(typeof(TService), typeof(TImplementing), Lifetime.Singleton); /// /// Registers a singleton service with an implementation factory. /// public static void RegisterSingleton(this IContainer container, Func factory) => container.Register(factory, Lifetime.Singleton); /// /// Registers a service with an implementing instance. /// public static void RegisterInstance(this IContainer container, TService instance) => container.RegisterInstance(typeof(TService), instance); /// /// Registers a base type for auto-registration. /// public static void RegisterAuto(this IContainer container) => container.RegisterAuto(typeof(TServiceBase)); /// /// Registers and instanciates a collection builder. /// /// The type of the collection builder. /// A collection builder of the specified type. public static TBuilder RegisterCollectionBuilder(this IContainer container) { // make sure it's not already registered // we just don't want to support re-registering collection builders if (container.GetRegistered().Any()) throw new InvalidOperationException("Collection builders should be registered only once."); // register the builder - passing the container as an arg to the factory container.RegisterSingleton(c => c.CreateInstance(container)); // initialize and return the builder return container.GetInstance(); } } }