web-dev-qa-db-fra.com

Comment formater l'extrait de code dans Javadoc avec les symboles @ et {à l'intérieur?

Voici ce que j'essaie de faire:

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

Je m'attends à ce qu'il soit formaté comme:

@XmlRootElement
public final class Page {
}

Mais je reçois:

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

Remplacement de ces entités HTML par de vrais symboles (@, {, }) entraîne des avertissements javadoc et une mise en forme absolument incorrecte. Qu'est-ce qu'une solution de contournement?

35
yegor256

Voici comment cela fonctionne finalement pour moi:

/**
 * <pre>
 * &#64;XmlRootElement
 * public final class Page {
 * }
 * </pre>
 */
39
yegor256
<pre>
<code>
{@literal@}Override
public String toString() {
    return "blah";
}
</code>
</pre>

Cela fonctionne pour moi.

29
Patrick

envelopper votre extrait de code avec <pre><code></code></pre>. Ce sont des balises HTML spéciales qui vous permettent d'oublier l'échappement de caractères spéciaux.

7
AlexR

C'est une vieille question mais j'ai compris pourquoi cela ne fonctionnait pas pour moi.

Cela ne fonctionnait pas:

<pre>{@code 
@Autowired

Mais quand tout est écrit sur une seule ligne, cela fonctionne.

<pre>
{@code @Autowired
1
Chandresh Mishra