/*
* 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.Collections.Concurrent;
namespace QuantConnect
{
///
/// Provides a string->Symbol mapping to allow for user defined strings to be lifted into a Symbol
/// This is mainly used via the Symbol implicit operator, but also functions that create securities
/// should also call Set to add new mappings
///
public static class SymbolCache
{
// we aggregate the two maps into a class so we can assign a new one as an atomic operation
private static Cache _cache = new Cache();
///
/// Adds a mapping for the specified ticker
///
/// The string ticker symbol
/// The symbol object that maps to the string ticker symbol
public static void Set(string ticker, Symbol symbol)
{
_cache.Symbols[ticker] = symbol;
_cache.Tickers[symbol] = ticker;
}
///
/// Gets the Symbol object that is mapped to the specified string ticker symbol
///
/// The string ticker symbol
/// The symbol object that maps to the specified string ticker symbol
public static Symbol GetSymbol(string ticker)
{
Symbol symbol;
if (TryGetSymbol(ticker, out symbol)) return symbol;
throw new Exception(string.Format("We were unable to locate the ticker '{0}'.", ticker));
}
///
/// Gets the Symbol object that is mapped to the specified string ticker symbol
///
/// The string ticker symbol
/// The output symbol object
/// The symbol object that maps to the specified string ticker symbol
public static bool TryGetSymbol(string ticker, out Symbol symbol)
{
return _cache.TryGetSymbol(ticker, out symbol);
}
///
/// Gets the string ticker symbol that is mapped to the specified Symbol
///
/// The symbol object
/// The string ticker symbol that maps to the specified symbol object
public static string GetTicker(Symbol symbol)
{
string ticker;
return _cache.Tickers.TryGetValue(symbol, out ticker) ? ticker : symbol.ID.ToString();
}
///
/// Gets the string ticker symbol that is mapped to the specified Symbol
///
/// The symbol object
/// The output string ticker symbol
/// The string ticker symbol that maps to the specified symbol object
public static bool TryGetTicker(Symbol symbol, out string ticker)
{
return _cache.Tickers.TryGetValue(symbol, out ticker);
}
///
/// Removes the mapping for the specified symbol from the cache
///
/// The symbol whose mappings are to be removed
/// True if the symbol mapping were removed from the cache
public static bool TryRemove(Symbol symbol)
{
string ticker;
return _cache.Tickers.TryRemove(symbol, out ticker) && _cache.Symbols.TryRemove(ticker, out symbol);
}
///
/// Removes the mapping for the specified symbol from the cache
///
/// The ticker whose mappings are to be removed
/// True if the symbol mapping were removed from the cache
public static bool TryRemove(string ticker)
{
Symbol symbol;
return _cache.Symbols.TryRemove(ticker, out symbol) && _cache.Tickers.TryRemove(symbol, out ticker);
}
///
/// Clears the current caches
///
public static void Clear()
{
_cache = new Cache();
}
class Cache
{
public readonly ConcurrentDictionary Symbols = new ConcurrentDictionary(StringComparer.OrdinalIgnoreCase);
public readonly ConcurrentDictionary Tickers = new ConcurrentDictionary();
///
/// Attempts to resolve the ticker to a Symbol via the cache. If not found in the
/// cache then
///
/// The ticker to resolver to a symbol
/// The resolves symbol
/// True if we successfully resolved a symbol, false otherwise
public bool TryGetSymbol(string ticker, out Symbol symbol)
{
if (Symbols.TryGetValue(ticker, out symbol))
{
return true;
}
SecurityIdentifier sid;
if (SecurityIdentifier.TryParse(ticker, out sid))
{
symbol = new Symbol(sid, sid.Symbol);
return true;
}
return false;
}
}
}
}