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();
}
}
}