При разработке в среде 1С:Предприятие многие программисты сталкиваются с досадным сообщением: «Передача мутабельного значения не допускается». Зачастую это вводит в заблуждение, так как мы привыкли передавать массивы, структуры и таблицы значений. Давайте разберемся, что на самом деле скрывается за этой формулировкой, почему она возникает и как правильно работать с данными в архитектуре клиент-сервер.
Термин «мутабельность» в программировании означает способность объекта изменять свое состояние после создания. Однако в платформе 1С это понятие стало своего рода «историческим артефактом». Когда вы видите ошибку о мутабельном значении, платформа на самом деле сигнализирует вам не о возможности изменения объекта, а о невозможности его сериализации.
Сериализация — это процесс превращения объекта в поток данных, пригодный для передачи по сети между клиентом и сервером. Если объект «привязан» к памяти конкретного процесса (например, Форма, ЭлементУправления или COM-объект), его невозможно передать на другую сторону, так как там этого объекта просто не существует. Платформа проверяет типы данных, и если тип не входит в список разрешенных для сериализации, вы получаете ошибку.
Архитектура «толстого клиента» исторически позволяла многое из того, что сейчас запрещено в «тонком». В толстом клиенте клиентская и серверная части нередко работали в одном адресном пространстве. Поэтому объекты, которые сейчас вызывают ошибку, могли успешно передаваться, так как по факту они никуда не «передавались», а лишь передавалась ссылка на область памяти.
В современных управляемых приложениях и при работе через тонкий клиент каждое обращение к серверу — это полноценный сетевой вызов. Именно поэтому ограничения стали строже: передавать можно только те типы данных, которые платформа умеет «запаковывать» (Массив, Структура, ТаблицаЗначений, Ссылка и т.д.).
Если вам необходимо передать сложный объект, который платформа не считает сериализуемым (например, ТабличныйДокумент), используйте проверенные методики, которые применяются, в том числе, в Библиотеке стандартных подсистем (БСП):
ВременноеХранилище. Платформа вернет вам адрес (строку), который легко передается между клиентом и сервером. На другой стороне вы просто получите данные по этому адресу.Структуру или Массив, содержащие только необходимые значения. После получения на сервере вы сможете «собрать» из них нужный объект обратно.ДвоичныеДанные. Вы можете сохранить объект в файл, считать его в двоичные данные и передать их.При проектировании вызовов помните о следующих правилах:
Рассмотрим, как лучше организовать передачу данных, если вы столкнулись с ограничением. Вместо того чтобы пытаться передать объект целиком, упакуйте его данные:
// На клиенте:
ДанныеДляСервера = Новый Структура;
ДанныеДляСервера.Вставить("ИмяКлиента", Объект.Наименование);
ДанныеДляСервера.Вставить("Сумма", Объект.СуммаДокумента);
// Вызов серверной процедуры
Результат = МойСерверныйМодуль.ОбработатьДанные(ДанныеДляСервера);
Таким образом, вы полностью исключаете вероятность ошибки мутабельности, так как передаете простые типы данных (строки, числа), которые гарантированно сериализуются платформой. Помните: если вы видите ошибку «мутабельное значение», это сигнал пересмотреть архитектуру взаимодействия и заменить сложные объекты на их сериализуемые аналоги.