ЧтениеFastInfoset.ПрефиксАтрибута

Методы · AttributePrefix

Получает префикс атрибута с указанным индексом. Так как атрибуты могут быть только у элемента XML, доступ к ним может осуществляться только при прочтении узла, имеющего тип НачалоЭлемента.

Синтаксис

ПрефиксАтрибута(<Индекс>)
Полное описание, параметры и ограничения

ЧтениеFastInfoset.ПрефиксАтрибута (FastInfosetReader.AttributePrefix)

ЧтениеFastInfoset (FastInfosetReader)

ПрефиксАтрибута (AttributePrefix)

Доступен, начиная с версии 8.1.

Синтаксис:
ПрефиксАтрибута(<Индекс>)
Параметры:

<Индекс> (обязательный)
Тип: Строка.
Индекс атрибута.
Возвращаемое значение:
Тип: Строка.

Описание:

Получает префикс атрибута с указанным индексом. Так как атрибуты могут быть только у элемента XML, доступ к ним может осуществляться только при прочтении узла, имеющего тип НачалоЭлемента.

Доступность:

Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация

Практические примеры

Найти атрибут единицы по URI, не по его порядковому номеру

Префиксы g и m принадлежат двум собственным пространствам имён. Все индексные методы вызываются только на НачалоЭлемента.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Учебная база на платформе 8.5.1.1343. Создайте серверный общий модуль УчебныеЗадачи и процедуру ВыполнитьПример() Экспорт; код урока без директив вставляйте в её тело. Каждый урок запускайте отдельно.

  2. Все документы создаются из собственных строк и чисел в памяти. Не подставляйте файл XML, бинарный архив обмена, ссылки или данные рабочей базы вместо учебных значений.

  3. Fast Infoset — двоичное представление XML. Для чтения нужен соответствующий reader, а не преобразование байтов в UTF-8-строку. Это не формат API Avito и не автоматическое сжатие произвольного JSON.

  4. Запуск в 1С ещё не подтверждён; выполните контрольные проверки в учебной базе. Не сравнивайте точные байты двух кодировщиков: в заданиях проверяется восстановленная структура и значения.

Запись = Новый ЗаписьFastInfoset;
Запись.УстановитьДвоичныеДанные();
Попытка
    Запись.ЗаписатьНачалоЭлемента("g:product");
    Запись.ЗаписатьСоответствиеПространстваИмен("g", "urn:guide:product");
    Запись.ЗаписатьСоответствиеПространстваИмен("m", "urn:guide:units");
    Запись.ЗаписатьАтрибут("code", "A-01");
    Запись.ЗаписатьАтрибут("unit", "urn:guide:units", "шт");
    Сообщить(Запись.НайтиПрефикс("urn:guide:units") = "m");
    Сообщить(Запись.КонтекстПространствИмен.НайтиURIПространстваИмен("g") = "urn:guide:product");
    Запись.ЗаписатьТекст("Книга");
    Запись.ЗаписатьКонецЭлемента();
    Данные = Запись.Закрыть();
Исключение
    Запись.Закрыть();
    ВызватьИсключение;
КонецПопытки;
Если ТипЗнч(Данные) <> Тип("ДвоичныеДанные") Тогда
    ВызватьИсключение "Не получены собственные Fast Infoset-данные";
КонецЕсли;
Сообщить(Данные.Размер() > 0);
Чтение = Новый ЧтениеFastInfoset;
Чтение.УстановитьДвоичныеДанные(Данные);
Попытка
    НайденКорень = Ложь;
    Пока Чтение.Прочитать() Цикл
        Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
            НайденКорень = Истина;
            Прервать;
        КонецЕсли;
    КонецЦикла;
    Если Не НайденКорень Тогда
        ВызватьИсключение "Не найден собственный корневой элемент";
    КонецЕсли;
    Сообщить(Чтение.ЛокальноеИмя = "product");
    Сообщить(Чтение.Префикс = "g");
    Сообщить(Чтение.URIПространстваИмен = "urn:guide:product");
    Сообщить(Чтение.КонтекстПространствИмен.НайтиURIПространстваИмен("m") = "urn:guide:units");
    Сообщить(Чтение.ПолучитьАтрибут("unit", "urn:guide:units") = "шт");
    Сообщить(Чтение.ЗначениеАтрибута("code") = "A-01");
    НайденаЕдиница = Ложь;
    Для Индекс = 0 По Чтение.КоличествоАтрибутов() - 1 Цикл
        Сообщить(СтрШаблон("Атрибут %1; тип %2", Чтение.ИмяАтрибута(Индекс), Чтение.ТипАтрибута(Индекс)));
        Если Чтение.ЛокальноеИмяАтрибута(Индекс) = "unit"
            И Чтение.URIПространстваИменАтрибута(Индекс) = "urn:guide:units" Тогда
            НайденаЕдиница = Истина;
            Сообщить(Чтение.ЗначениеАтрибута(Индекс) = "шт");
            Сообщить("Префикс по индексу: " + Чтение.ПрефиксАтрибута(Строка(Индекс)));
        КонецЕсли;
    КонецЦикла;
    Сообщить(НайденаЕдиница);
Исключение
    Чтение.Закрыть();
    ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();

Разбор по шагам

  1. Записываем соответствия префиксов после начала элемента и до дочерних данных.

  2. Идентичность элемента и атрибута определяем парой локальное имя/URI; g и m лишь выбранные сокращения.

  3. Перебор индексов не меняет текущую позицию reader: все методы вызываются на НачалоЭлемента.

  4. Не считаем xmlns и порядок атрибутов стабильным контрактом. У ПрефиксАтрибута локальная справка задаёт строковый индекс, поэтому здесь Строка(Индекс).

Как проверить результат

  1. Проверки URI, префиксов, кода и единицы Истина; НайденаЕдиница Истина.

  2. Если замените m на u во всех соответствиях источника, поиск unit по URI остаётся правильным; текст префикса изменится.

Ожидаемый результат

Разобраны пространства имён и безопасный индексный обход атрибутов.

На что обратить внимание

  1. URI вида urn:guide:units — идентификатор, не URL для скачивания.

  2. Справка ПрефиксАтрибута указывает Строка для индекса, в отличие от соседних методов; отдельно проверьте этот вызов в своём runtime.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.