Як я можу уникнути @символу в javadoc? Я намагаюся використовувати його всередині {@code}тегу, який знаходиться всередині <pre>тегів.
Я вже пробував html @послідовність виходу , але це не спрацювало.
Як я можу уникнути @символу в javadoc? Я намагаюся використовувати його всередині {@code}тегу, який знаходиться всередині <pre>тегів.
Я вже пробував html @послідовність виходу , але це не спрацювало.
Відповіді:
Використовуйте {@literal}тег javadoc:
/**
* This is an "at" symbol: {@literal @}
*/
Явадок для цього буде читати:
This is an "at" symbol: @
Звичайно, це буде працювати для будь-яких персонажів, і це "офіційно підтримуваний" спосіб відображення будь-яких "спеціальних" символів.
Це також найяскравіше - вам не потрібно знати шістнадцятковий код символу, і ви можете прочитати те, що ви ввели!
}символу?
}не має особливого значення в html.
literalтеги.
{та просто використання @literal @робіт усередині {@code}тегу.
Просто напишіть це як сутність HTML:
@
З документа " javadoc - генератор документації Java API "
Якщо ви хочете почати рядок із символом @ і не інтерпретувати його, використовуйте сутність HTML @.
Це означає, що ви можете використовувати сутності HTML для будь-якого символу, який вам знадобиться втекти, і дійсно ви можете:
Текст повинен бути написаний у HTML із сутностями HTML та тегами HTML. Ви можете використовувати будь-яку версію HTML, яку підтримує ваш браузер. Стандартний doclet генерує код, що відповідає HTML 3.2, в іншому місці (поза коментарями до документації) з включенням каскадних таблиць стилів та кадрів. HTML 4.0 є кращим для згенерованих файлів через набори кадрів.
Наприклад, сутності для символу менше (<) і більше символу (>) повинні бути записані як
<і>. Аналогічно, ampersand (&) слід записати як&.
моє рішення таке
/**
* Mapper Test Helper.
*
* add the following annotations above the class
* <pre>{@code
* // junit5
* @literal @ExtendWith(SpringExtension.class)
* // junit4
* @literal @RunWith(SpringRunner.class)
* }</pre>
*/
У вас є загальна ідея, спробуйте використовувати восьмеричне подання: @
@має