Как вставить комментарий в XML документ?
Ниже код моей функции. Возможно, моя проблема заключается в том, что я неправильно понял как работает insertBefore. Работу этого метода я понял так, insertBefore имеет два параметра: первый параметр — узел, который хотим вставить, второй параметр — перед каким узлом хотим вставить. Вызываем сам метод insertBefore у того узла, для которого нововставленный узел будет дочерним. Если все так, тогда не могу понять, почему данный код не вставляет комментарий там, где нужно.
Ниже код XML. Перед каждым тегом, кроме родительского нужно вставить комментарий.
Но вставка происходит такая:
Что не так я делаю?
Ответы (1 шт):
Элемент вставлялся неправильно из-за того, что узел-комментарий был один и просто передвигался от одного элемента к другому, передвигаясь к самому последнему внутреннему элементу родительского тега. Решением оказалось создание на каждой итерации нового узла-коммента и добавлением его к нужному элементу.
Как вставить комментарий в XML документ?
Ниже код моей функции. Возможно, моя проблема заключается в том, что я неправильно понял как работает insertBefore. Работу этого метода я понял так, insertBefore имеет два параметра: первый параметр — узел, который хотим вставить, второй параметр — перед каким узлом хотим вставить. Вызываем сам метод insertBefore у того узла, для которого нововставленный узел будет дочерним. Если все так, тогда не могу понять, почему данный код не вставляет комментарий там, где нужно.
Ниже код XML. Перед каждым тегом, кроме родительского нужно вставить комментарий.
XML – Комментарии
В этой главе объясняется, как работают комментарии в документах XML. Комментарии XML похожи на комментарии HTML. Комментарии добавляются в виде примечаний или строк для понимания цели XML-кода.
Комментарии могут быть использованы для включения связанных ссылок, информации и терминов. Они видны только в исходном коде; не в коде XML. Комментарии могут появляться в любом месте XML-кода.
Синтаксис
XML-комментарий имеет следующий синтаксис –
Комментарий начинается с <! – и заканчивается -> . Вы можете добавить текстовые заметки в качестве комментариев между персонажами. Вы не должны вкладывать один комментарий в другой.
пример
Следующий пример демонстрирует использование комментариев в документе XML –
Любой текст между символами <! – и -> считается комментарием.
Как вставить комментарии XML в код Java в IntelliJ IDEA?
Возможно, я упускаю что-то очевидное, но я не могу найти способ включить вставку XML-комментариев в код Java с помощью редактора IntelliJ IDEA (v. 12 Community Edition).
Я про такие комментарии:
задан 05 сен ’13, 22:09
2 ответы
Поместите курсор клавиатуры над вашим методом. Тип /** затем нажмите ВВОД. Intelj создаст шаблон комментария JavaDoc, в который можно добавить описание параметров и возвращаемое значение, например:
Чтобы увидеть всплывающее окно с отформатированным текстом комментария, поместите курсор внутрь /** . */ и введите Ctrl+Q
Да, это больше похоже на то, о чем я говорю. Но что, если я предпочитаю комментарии XML вместо комментариев JavaDoc? Есть ли поддержка для этого в IntelliJ IDEA? — РенниПет
Я не знаю ни одного (Visual Studio) «XML-комментария», эквивалентного в java. В java Javadoc — это способ документирования методов и классов. Затем документация по API может быть сгенерирована в формате html. — Сергей Паник
Спасибо за ваши старания. Если никто не даст лучшего ответа в течение дня или двух, я предположу, что вы правы, и приму этот. (И я еще раз повторю, что я действительно видел такие комментарии в программе Java, поэтому я подумал, что их можно создавать полуавтоматически.) — РенниПет
Возможно, те комментарии xml, которые вы где-то видели, были созданы с помощью Док-О-Матик or Доксиген которые поддерживают комментарии Xml Doc для C# и Java. Эти инструменты могут интегрироваться с IDE, например с Visual Studio, но неизвестно, поддерживают ли они IntelliJ. Чтобы быть уверенным, спросите на Форум IntelliJ — Сергей Паник