Поддержка работы с несколькими конфигурациями 1С при помощи паттерна «Стратегия» на примере C#

Интеграция программного обеспечения с 1С не всегда ограничивается работой только с одной информационной базой. Нередко возникает необходимость реализовать поддержку нескольких конфигураций или даже различных версий одной и той же конфигурации.

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

Паттерн «Стратегия» позволяет не просто определить некое семейство алгоритмов для решения некоторых задач. Его основное преимущество в том, что при его использовании эти алгоритмы становятся взаимозаменяемыми и их можно изменять независимо от тех объектов, которые их используют.

Паттерн «Стратегия» имеет три составляющих:

Strategy (Стратегия). Базовый класс для Concrete Strategy. Объявляет интерфейс общий для всех поддерживаемых алгоритмов. Класс Context использует этот интерфейс для вызова конкретного алгоритма, реализованного в классе Concrete Strategy;
Concrete Strategy (Конкретная стратегия). Реализует алгоритм использующий интерфейс, объявленный в классе Strategy;
Context (Контекст). Класс, который использует алгоритмы «Стратегии». Хранит ссылку на объект класса Strategy и конфигурируется объектом класса Concrete Strategy. Также может определять интерфейс позволяющий объекту Strategy получить доступ к данным контекста.

Для того чтобы рассмотреть работу паттерна «Стратегия» применительно к нескольким конфигурациям 1С обратимся к примерам из цикла статей посвящённых работе с 1С в C# (часть 1 и часть 2).

Суть этих примеров подробно изложена в указанных статьях. Поэтому не станем их здесь описывать и перейдём сразу к постановке задачи и её решению с помощью паттерна «Стратегия».

Допустим необходимо реализовать в программе поддержку одновременно двух версий одной и той же конфигурации. При этом более новая версия имеет API для работы и, следовательно, работать с ней предпочтительно с его помощью, а более старая нет и работа с ней возможна только через объектную модель.

В обоих случаях выполняются одинаковые по своей сути действия получения и добавления данных, но используемые алгоритмы существенно отличаются. Исключение составляет только подключение к 1С через COM-сервер.

Таким образом, реализация получения и добавления данных для каждой конкретной конфигурации может быть выделена в отдельную «конкретную стратегию». В свою очередь сигнатуры соответствующих методов и подключение к 1С можно вынести в базовый класс «стратегию». В качестве «контекста» выступает класс программы, который отвечает за работу с 1С. В данном конкретном примере «контекстом» будет служить класс формы приложения.

Создадим абстрактный класс, который будет базовым для будущих «конкретных стратегий».

abstract class Strategy1C

{
    protected string _infoBase;
    public Strategy1C(string infoBase)
    {
        _infoBase = infoBase;
    }
    protected static dynamic Get1CConnection(string infoBase)
    {
        COMConnector comConnector = new COMConnector();
        dynamic connection = comConnector.Connect("File=\""+infoBase+"\"");
        return connection;
    }
    abstract public DataTable Load();
    abstract public void Add(string author);
}

{

protected string _infoBase;

public Strategy1C(string infoBase)

{

_infoBase = infoBase;

}

protected static dynamic Get1CConnection(string infoBase)

{

COMConnector comConnector = new COMConnector();

dynamic connection = comConnector.Connect("File=\""+infoBase+"\"");

return connection;

}

abstract public DataTable Load();

abstract public void Add(string author);

}

Этот класс уже включает реализацию подключения к 1С и защищённое строковое поля для хранения пути к информационной базе.

Теперь необходимо реализовать «конкретные стратегии» для работы со старой и новой версиями конфигурации.

Класс для работы со старой версией.

class ConfOld : Strategy1C
{
    public ConfOld(string infoBase) : base(infoBase)
    {
    }
    public override void Add(string author)
    {
        dynamic conn = Get1CConnection(_infoBase);
        dynamic addAuthor = conn.Справочники.Авторы.СоздатьЭлемент();
        addAuthor.Наименование = author;
        addAuthor.Записать();
    }
    public override DataTable Load(DataGridView grid)
    {
        dynamic conn = Get1CConnection(_infoBase);
        dynamic dataArray1C = conn.Справочники.Авторы.Выбрать();
        DataTable dt = new DataTable();
        dt.Columns.Add();
        dt.Columns[0].ColumnName = "Наименование";
        while (dataArray1C.Следующий == true)
        {
            dt.Rows.Add(dataArray1C.Наименование);
        }
        return dt;
   }
}

class ConfOld : Strategy1C

{

public ConfOld(string infoBase) : base(infoBase)

{

}

public override void Add(string author)

{

dynamic conn = Get1CConnection(_infoBase);

dynamic addAuthor = conn.Справочники.Авторы.СоздатьЭлемент();

addAuthor.Наименование = author;

addAuthor.Записать();

}

public override DataTable Load(DataGridView grid)

{

dynamic conn = Get1CConnection(_infoBase);

dynamic dataArray1C = conn.Справочники.Авторы.Выбрать();

DataTable dt = new DataTable();

dt.Columns.Add();

dt.Columns[0].ColumnName = "Наименование";

while (dataArray1C.Следующий == true)

{

dt.Rows.Add(dataArray1C.Наименование);

}

return dt;

}

Класс для работы с новой версией.

class ConfNew : Strategy1C

{
    public ConfNew(string infoBase) : base(infoBase)
    {

{

public ConfNew(string infoBase) : base(infoBase)

{

    }
    public override void Add(string author)
    {
        dynamic conn = Get1CConnection(_infoBase);
        conn.Добавить(author);
    }
    public override DataTable Load(DataGridView grid)
    {
        dynamic conn = Get1CConnection(_infoBase);
        dynamic dataArray1C = conn.Загрузить();
        DataTable dt = new DataTable();
        dt.Columns.Add();
        dt.Columns[0].ColumnName = "Наименование";
        while (dataArray1C.Следующий == true)
        {
            dt.Rows.Add(dataArray1C.Наименование);
        }
        return dt;
    }
}

}

public override void Add(string author)

{

dynamic conn = Get1CConnection(_infoBase);

conn.Добавить(author);

}

public override DataTable Load(DataGridView grid)

{

dynamic conn = Get1CConnection(_infoBase);

dynamic dataArray1C = conn.Загрузить();

DataTable dt = new DataTable();

dt.Columns.Add();

dt.Columns[0].ColumnName = "Наименование";

while (dataArray1C.Следующий == true)

{

dt.Rows.Add(dataArray1C.Наименование);

}

return dt;

}

После этого остаётся только доработать класс формы.

Добавим закрытое поле класса Strategy1C.

private Strategy1C _strategy1C;

1	private Strategy1C _strategy1C;

Добавим метод, который будет изменять стратегию во время выполнения.

private void SetStrategy(Strategy1C strategy)
    {
        _strategy1C = strategy;
    }

private void SetStrategy(Strategy1C strategy)

{

_strategy1C = strategy;

}

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

Изменение стратегии выполняется просто.

private void radioButtonOld_CheckedChanged(object sender, EventArgs e)
{
    //Работа со старой версией конфигурации
    if (((RadioButton)sender).Checked)
    {
        SetStrategy(new ConfOld("C:\\1С\\Тестовая\""));
    }
}
private void radioButtonNew_CheckedChanged(object sender, EventArgs e)
{
    //Работа с новой версией конфигурации
    if (((RadioButton)sender).Checked)
    {
        SetStrategy(new ConfNew("C:\\1С\\ТестоваяНовая"));
    }
}

private void radioButtonOld_CheckedChanged(object sender, EventArgs e)

{

//Работа со старой версией конфигурации

if (((RadioButton)sender).Checked)

{

SetStrategy(new ConfOld("C:\\1С\\Тестовая\""));

}

private void radioButtonNew_CheckedChanged(object sender, EventArgs e)

{

//Работа с новой версией конфигурации

if (((RadioButton)sender).Checked)

{

SetStrategy(new ConfNew("C:\\1С\\ТестоваяНовая"));

}

Однако самые главные изменения связаны непосредственно с взаимодействием с обеими версиями конфигураций.

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

if (isNewConf)
{
    conn.Добавить(textBox1C.Text);
}
else
{
    dynamic addAuthor = conn.Справочники.Авторы.СоздатьЭлемент();
    addAuthor.Наименование = textBox1C.Text;
    addAuthor.Записать();
}

if (isNewConf)

{

conn.Добавить(textBox1C.Text);

}

else

{

dynamic addAuthor = conn.Справочники.Авторы.СоздатьЭлемент();

addAuthor.Наименование = textBox1C.Text;

addAuthor.Записать();

}

Похожая ситуация имела место и при получении данных.

dynamic dataArray1C = isNewConf ? conn.Загрузить() : conn.Справочники.Авторы.Выбрать();
while (dataArray1C.Следующий == true)
{
    grid.Rows.Add(dataArray1C.Наименование);
}

dynamic dataArray1C = isNewConf ? conn.Загрузить() : conn.Справочники.Авторы.Выбрать();

while (dataArray1C.Следующий == true)

{

grid.Rows.Add(dataArray1C.Наименование);

}

После применения паттерна «Состояние» работа с обеими версиями конфигурации выполняется полностью идентично и, что тоже не маловажно, более компактно.

Как при добавлении.

_strategy1C.Add(textBox1C.Text);

1	_strategy1C.Add(textBox1C.Text);

Так и при получении данных.

grid.DataSource = _strategy1C.Load();

1	grid.DataSource = _strategy1C.Load();

В результате использования паттерна «Состояние» удалось добиться целого ряда преимуществ.

Бизнес-логика, связанная с работой с 1С, теперь полностью отделена от объекта, который её использует. В данном примере от интерфейса пользователя. Алгоритмы, реализованные в классах «конкретных стратегиях» могут со временем изменяться, но изменения тех компонентов, которые их используют, при этом не потребуются;
Работа со всеми поддерживаемыми конфигурациями стала полностью унифицированной. Это упрощает не только написание кода, но и расширение возможностей программы. При добавлении новой конфигурации потребуется только реализовать «конкретную стратегию» для работы с ней и её инициализацию. Всё остальное изменять не нужно;
Вследствие предыдущих пунктов также значительно упрощается разработка самих объектов использующих данные из 1С и их модернизация. В частности, в том примере, который был рассмотрен в данной статье, первоначальный интерфейс пользователя на Windows Forms можно без особого труда заменить на более современный с использованием WPF.

К недостаткам использования данного паттерна можно отнести «традиционные» для большинства паттернов увеличение количества классов в приложении и усложнение его архитектуры. Однако, преимущества, которые даёт использование паттерна «Стратегия» применительно к работе с несколькими конфигурациями 1С их покрывают в более чем достаточной степени.

Список источников

Гамма Э., Хелм Р., Джонсон Р., Влиссидес Дж. Приёмы объектно-ориентированного проектирования. Паттерны проектирования.
Стрелец Coder. Работа с 1С в C#. Способ 1. Работа с объектной моделью 1С
Стрелец Coder. Работа с 1С в C#. Способ 2. Работа с API конфигурации

Список источников

Добавить комментарий Отменить ответ