/*
* QUANTCONNECT.COM - Democratizing Finance, Empowering Individuals.
* Lean Algorithmic Trading Engine v2.0. Copyright 2014 QuantConnect Corporation.
*
* 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.
*/
using System;
using System.Linq;
using System.Reflection;
using QuantConnect.Logging;
using System.Collections.Generic;
namespace QuantConnect.Exceptions
{
///
/// Interprets exceptions using the configured interpretations
///
public class StackExceptionInterpreter : IExceptionInterpreter
{
private readonly List _interpreters;
///
/// Stack interpreter instance
///
public static readonly Lazy Instance = new Lazy(
() => StackExceptionInterpreter.CreateFromAssemblies(AppDomain.CurrentDomain.GetAssemblies()));
///
/// Determines the order that an instance of this class should be called
///
public int Order => 0;
///
/// Initializes a new instance of the class
///
/// The interpreters to use
public StackExceptionInterpreter(IEnumerable interpreters)
{
_interpreters = interpreters.OrderBy(x => x.Order).ToList();
}
///
/// Gets the interpreters loaded into this instance
///
public IEnumerable Interpreters => _interpreters;
///
/// Determines if this interpreter should be applied to the specified exception.
///
/// The exception to check
/// True if the exception can be interpreted, false otherwise
public bool CanInterpret(Exception exception)
{
return _interpreters.Any(interpreter => interpreter.CanInterpret(exception));
}
///
/// Interprets the specified exception into a new exception
///
/// The exception to be interpreted
/// An interpreter that should be applied to the inner exception.
/// This provides a link back allowing the inner exceptions to be interpreted using the intepretators
/// configured in the . Individual implementations *may* ignore
/// this value if required.
/// The interpreted exception
public Exception Interpret(Exception exception, IExceptionInterpreter innerInterpreter = null)
{
if (exception == null)
{
return null;
}
foreach (var interpreter in _interpreters)
{
try
{
if (interpreter.CanInterpret(exception))
{
// use this instance to interpret inner exceptions as well, unless one was specified
return interpreter.Interpret(exception, innerInterpreter ?? this);
}
}
catch (Exception err)
{
Log.Error(err);
}
}
return exception;
}
///
/// Combines the exception messages from this exception and all inner exceptions.
///
/// The exception to create a collated message from
/// The collate exception message
public string GetExceptionMessageHeader(Exception exception)
{
return string.Join(" ", InnersAndSelf(exception).Select(e => e.Message));
}
///
/// Creates a new by loading implementations with default constructors from the specified assemblies
///
/// The assemblies to scan
/// A new containing interpreters from the specified assemblies
public static StackExceptionInterpreter CreateFromAssemblies(IEnumerable assemblies)
{
var interpreters =
from assembly in assemblies.Where(x =>
(!x.FullName?.StartsWith("System.", StringComparison.InvariantCultureIgnoreCase) ?? false)
&& (!x.FullName?.StartsWith("Microsoft.", StringComparison.InvariantCultureIgnoreCase) ?? false))
from type in assembly.GetTypes()
// ignore non-public and non-instantiable abstract types
where type.IsPublic && !type.IsAbstract
// type implements IExceptionInterpreter
where typeof(IExceptionInterpreter).IsAssignableFrom(type)
// type is not mocked with MOQ library
where type.FullName != null && !type.FullName.StartsWith("Castle.Proxies.ObjectProxy", StringComparison.InvariantCultureIgnoreCase)
// type has default parameterless ctor
where type.GetConstructor(new Type[0]) != null
// provide guarantee of deterministic ordering
orderby type.FullName
select (IExceptionInterpreter) Activator.CreateInstance(type);
var stackExceptionInterpreter = new StackExceptionInterpreter(interpreters);
foreach (var interpreter in stackExceptionInterpreter.Interpreters)
{
Log.Debug(Messages.StackExceptionInterpreter.LoadedExceptionInterpreter(interpreter));
}
return stackExceptionInterpreter;
}
private IEnumerable InnersAndSelf(Exception exception)
{
yield return exception;
while (exception.InnerException != null)
{
exception = exception.InnerException;
yield return exception;
}
}
}
}