File: System\Composition\Hosting\CompositionHost.cs
Web Access
Project: src\src\libraries\System.Composition.Hosting\src\System.Composition.Hosting.csproj (System.Composition.Hosting)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Collections.Generic;
using System.Composition.Hosting.Core;
using System.Composition.Hosting.Providers.CurrentScope;
using System.Composition.Hosting.Providers.ExportFactory;
using System.Composition.Hosting.Providers.ImportMany;
using System.Composition.Hosting.Providers.Lazy;
using System.Diagnostics;
using System.Linq;
 
namespace System.Composition.Hosting
{
    /// <summary>
    /// Assembles a lightweight composition container from configured
    /// providers.
    /// </summary>
    public sealed class CompositionHost : CompositionContext, IDisposable
    {
        private static readonly string[] s_noBoundaries = Array.Empty<string>();
 
        private readonly LifetimeContext _rootLifetimeContext;
 
        private CompositionHost(LifetimeContext rootLifetimeContext)
        {
            Debug.Assert(rootLifetimeContext != null);
            _rootLifetimeContext = rootLifetimeContext;
        }
 
        /// <summary>
        /// Create the composition host.
        /// </summary>
        /// <returns>The container as an <see cref="CompositionHost"/>.</returns>
        public static CompositionHost CreateCompositionHost(params ExportDescriptorProvider[] providers)
        {
            return CreateCompositionHost((IEnumerable<ExportDescriptorProvider>)providers);
        }
 
        /// <summary>
        /// Create the composition host.
        /// </summary>
        /// <returns>The container as an <see cref="CompositionHost"/>.</returns>
        public static CompositionHost CreateCompositionHost(IEnumerable<ExportDescriptorProvider> providers)
        {
            if (providers is null)
            {
                throw new ArgumentNullException(nameof(providers));
            }
 
            var allProviders = new ExportDescriptorProvider[] {
                new LazyExportDescriptorProvider(),
                new ExportFactoryExportDescriptorProvider(),
                new ImportManyExportDescriptorProvider(),
                new LazyWithMetadataExportDescriptorProvider(),
                new CurrentScopeExportDescriptorProvider(),
                new ExportFactoryWithMetadataExportDescriptorProvider()
            }
            .Concat(providers)
            .ToArray();
 
            var container = new LifetimeContext(new ExportDescriptorRegistry(allProviders), s_noBoundaries);
            return new CompositionHost(container);
        }
 
        /// <summary>
        /// Retrieve the single <paramref name="contract"/> instance from the
        /// <see cref="CompositionContext"/>.
        /// </summary>
        /// <param name="contract">The contract to retrieve.</param>
        /// <returns>An instance of the export.</returns>
        /// <param name="export">The export if available, otherwise, null.</param>
        /// <exception cref="CompositionFailedException" />
        public override bool TryGetExport(CompositionContract contract, out object export)
        {
            return _rootLifetimeContext.TryGetExport(contract, out export);
        }
 
        /// <summary>
        /// Release the host and any globally-shared parts.
        /// </summary>
        public void Dispose()
        {
            _rootLifetimeContext.Dispose();
        }
    }
}