Admin: 1 revision imported

2022-07-17T11:22:44Z

1 revision imported

1>Admin at 07:29, 17 July 2022

2022-07-17T07:29:03Z

New page

{{infobox function
|name=SaveJSONToString
|caption=Функции работы со строками
|type=1
|status=1
|db=0
|exception=Неверный входящий объект
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Функция экспортирует (превращает) объект дерева, ветки или списка в текст JSON. Функция позволяет восстановить JSON документ из объекта, который обмено создается с помощью функции [[LoadJSONFromString]]. Обычно необходимо модифицировать объект перед превращением его в текст, при модификации (удалении или добавлении веток или списков) нужно руководствоваться следующими правилами, чтобы получить корректный конечный результат:
* При экспорте дерева к строке-результату будут добавлены символы '''{''' и '''}'''. При экспорте списка они будут добавлены, если результат уже не является массивом. При экспорте ветки дерева результат не будет модифицирован.
* И для дерева и для списка при экпорте используется поле ''Check'' ([[Tree.Checked]], [[List.Check]]). Это поле может иметь следующие значения:
** Для веток, содержащих подчиненные ветки или для элементов списков, значением которых является список, в случае, если это поле равно '''0''', будут включенные элементы будут считаться объектом JSON ('''{''' и '''}'''), если поле равно единице, они будут считаться массивом ('''[''' и ''']'''). Это позволяет корректно отличить пустой объект ''{}'' от пустого массива ''[]''.
** Для остальных веток поле ''Check'' ([[Tree.Checked]], [[List.Check]]) используется для указания типа объекта, если объект является строкой. Если поле равно нулю, экспортируемое строковое значение будет заключено в кавычки и перекодировано в формат JSON (см. [[EncodeString]]), т.е. <code>"Имя":"<Перекодированное значение>"</code>. Если поле не равно нулю, перекодирование и кавычки добавлены не будут, т.е. <code>"Имя":<Значение></code>. Данная возможность используется для корректного сохранения особых значений типа ''true'', ''false'' и ''null''.
* Поле ''Check'' для строковых значений также можно использовать для быстрой вставки в объект массива или объекта JSON, заданного в виде строки. Так как в случае ''Check<>0'' перекодирование производиться не будет, результат будет выглядеть, как корректный объект или массив JSON без необходимости его предварительного превращения в ветки дерева или списки (см. пример ниже).

== Синтаксис ==
<code>
'''SaveJSONToString'''(''<Объект дерева, ветки или списка (STRING)>''):''<Результат (STRING)>''
</code>

==== Возвращаемое значение ====
Будет возвращено строковое значение.

== Примеры ==
<pre>
//"Отпечаток" сертификата (здесь дан для примера)
пОтпечаток:="ABC123";

//Загрузка простого объекта JSON
Стр:="{""Результат"":{""Вложения"":[{""Файл"":{""Имя"":""Файл1"",""Тип"":0},""Удален"":0},{""Файл"":{""Имя"":""Файл2"",""Тип"":1},""Удален"":1},{""Файл"":{""Имя"":""Файл3"",""Тип"":2},""Удален"":0}]}}";
aTree:=LoadJSONFromString(Стр,0);
aBr:=aTree["Результат","Вложения"];
If _And(TypeStr(aBr)="TREE.BRANCH",aBr.Size()>0) Then
For i:=1 to aBr.Size() Do
//Получим ветку текущего вложения по его индексу
aBr2:=aBr.ByIndex(i);
//Удалим ветку файл в текущем вложении
aBr3:=aBr2.FindByName("Файл");
If not IsEmpty(aBr3) Then
aBr2.Remove(aBr3.Index);
EndIf;

//Добавим ветку подпись, как массив, добавим объект сертификат в первый элемент массива
aBr3:=aBr2.Add(,"Подпись");
//Указание на то, что это массив объектов (здесь не обязательно)
aBr3.Checked:=1;
//Добавим новую ветку в массив
aBr3:=aBr3.Add();
//Добавим заранее подготовленный кусок JSON
aBr4:=aBr3.Add("{""Отпечаток"":"""+EncodeString(пОтпечаток,"JSON")+"""}","Cертификат");
//Указание на то, что текст нельзя перекодировать, а необходимо использовать "как есть"
aBr4.Checked:=1;
EndDo;
EndIf;

Стр:=SaveJSONToString(aTree);
//Будет выведено: {"Результат":{"Вложения":[{"Удален":0,"Подпись":[{"Cертификат":{"Отпечаток":"ABC123"}}]},
// {"Удален":1,"Подпись":[{"Cертификат":{"Отпечаток":"ABC123"}}]},{"Удален":0,"Подпись":[{"Cертификат":{"Отпечаток":"ABC123"}}]}]}}
Message(Стр);
//Мы смогли не только удалить нужные ветки, но и добавить целые куски текста JSON без необходимости в более трудоемком добавлении веток.
</pre>

← Older revision	Revision as of 11:22, 17 July 2022
(No difference)

SaveJSONToString - Revision history

Admin: 1 revision imported

1>Admin at 07:29, 17 July 2022