Table of Contents

Конвертация типов

Компонент конвертации типов играет важную роль в обеспечении совместимости между типами данных, используемыми в StockSharp, и форматами, специфичными для конкретной биржи.

Основные функции

  1. Преобразование типов StockSharp (например, Sides, OrderTypes, TimeInForce) в строковые представления, используемые биржей.
  2. Обратное преобразование данных, полученных от биржи, в типы StockSharp.
  3. Конвертация идентификаторов инструментов между форматами StockSharp и биржи.
  4. Преобразование временных форматов и таймфреймов.

Пример реализации

Ниже приведен пример класса с методами расширения для конвертации типов:

static class Extensions
{
	// Конвертация направления заявки StockSharp в строковое представление биржи
	public static string ToNative(this Sides side)
	{
		return side switch
		{
			Sides.Buy => "buy",
			Sides.Sell => "sell",
			_ => throw new ArgumentOutOfRangeException(nameof(side), side, LocalizedStrings.InvalidValue),
		};
	}

	// Конвертация строкового представления направления заявки биржи в тип StockSharp
	public static Sides ToSide(this string side)
		=> side?.ToLowerInvariant() switch
		{
			"buy" or "bid" => Sides.Buy,
			"sell" or "ask" or "offer" => Sides.Sell,
			_ => throw new ArgumentOutOfRangeException(nameof(side), side, LocalizedStrings.InvalidValue),
		};

	// Конвертация типа заявки StockSharp в строковое представление биржи
	public static string ToNative(this OrderTypes? type)
	{
		return type switch
		{
			null => null,
			OrderTypes.Limit => "limit",
			OrderTypes.Market => "market",
			OrderTypes.Conditional => "stop",
			_ => throw new ArgumentOutOfRangeException(nameof(type), type, LocalizedStrings.InvalidValue),
		};
	}

	// Конвертация строкового представления типа заявки биржи в тип StockSharp
	public static OrderTypes ToOrderType(this string type)
		=> type?.ToLowerInvariant() switch
		{
			"limit" => OrderTypes.Limit,
			"market" => OrderTypes.Market,
			"stop" or "stop limit" => OrderTypes.Conditional,
			_ => throw new ArgumentOutOfRangeException(nameof(type), type, LocalizedStrings.InvalidValue),
		};

	// Другие методы конвертации...

	// Словарь для сопоставления таймфреймов StockSharp и строковых представлений биржи
	public static readonly PairSet<TimeSpan, string> TimeFrames = new()
	{
		{ TimeSpan.FromMinutes(1), "ONE_MINUTE" },
		{ TimeSpan.FromMinutes(5), "FIVE_MINUTE" },
		// Другие таймфреймы...
	};

	// Конвертация таймфрейма StockSharp в строковое представление биржи
	public static string ToNative(this TimeSpan timeFrame)
		=> TimeFrames.TryGetValue(timeFrame) ?? throw new ArgumentOutOfRangeException(nameof(timeFrame), timeFrame, LocalizedStrings.InvalidValue);

	// Конвертация строкового представления таймфрейма биржи в TimeSpan
	public static TimeSpan ToTimeFrame(this string name)
		=> TimeFrames.TryGetKey2(name) ?? throw new ArgumentOutOfRangeException(nameof(name), name, LocalizedStrings.InvalidValue);
}

Рекомендации

  • Используйте методы расширения для удобства использования функций конвертации.
  • Обрабатывайте все возможные значения перечислений, включая null и неизвестные значения.
  • Используйте switch выражения (C# 8.0+) для более чистого и читаемого кода.
  • Добавляйте проверки на недопустимые значения и выбрасывайте исключения с понятными сообщениями об ошибках.
  • Рассмотрите возможность использования словарей для сопоставления значений, особенно для сложных или часто изменяющихся соответствий (например, для таймфреймов).

Правильная реализация конвертации типов значительно упрощает работу с данными в других частях коннектора и уменьшает вероятность ошибок, связанных с несоответствием форматов.

Edit this page