Как отформатировать фрагмент кода в Javadoc с символами @ и {внутри? - PullRequest
34 голосов
/ 06 ноября 2011

Вот что я пытаюсь сделать:

<code>/**
 * <pre>
 * {@code
 * &#64;XmlRootElement
 * public final class Page &#123;
 * &#125;
 * }
 * 
* /

Я ожидаю, что он будет отформатирован как:

@XmlRootElement
public final class Page {
}

НоЯ получаю:

&#64;XmlRootElement
public final class Page &#123;
&#125;

Замена этих сущностей HTML реальными символами (@, {, }) приводит к предупреждениям Javadoc и абсолютно неправильному форматированию.Что такое обходной путь?

Ответы [ 4 ]

37 голосов
/ 06 ноября 2011

Вот как это наконец работает для меня:

<code>/**
 * <pre>
 * &#64;XmlRootElement
 * public final class Page {
 * }
 * 
* /
28 голосов
/ 26 сентября 2013
<pre>
<code>
{@literal@}Override
public String toString() {
    return "blah";
}

Это работает для меня.

7 голосов
/ 06 ноября 2011

оберните ваш фрагмент кода с <pre><code>.Это специальные теги HTML, которые позволяют забыть о экранировании специальных символов.

1 голос
/ 09 ноября 2017

Это старый вопрос, но я понял, почему он не работает для меня.

Это не работает:

<pre>{@code 
@Autowired

Но когда все написано в одну строку, это работает.

<pre>
{@code @Autowired
...