Can't use @ character in javadocs: "wrong tag"?

Permanently deleted user

创建于 2009年07月29日 19:21

Hello,

I was writing a javadoc for a class that includes a sample code which uses an annotation, like this:

/**
* <pre><code>public class Subclasse extends EnderecoAssociadoATipo {
*     @AttirbuteOverride(name = "ID_ASSOCIADO_ENDERECO", column = @Column(name = "NOME_CORRETO_DO_CAMPO"))
*     private EnderecoAssociadoATipo.Id id;
*     // resto da classe
* </code></pre>
*/
class BlaBla {

The line which start with '@' is marked with this message: "Wrong tag 'AttributeOverride'"

Is there a way to use @ without messing the javadoc's tag?

2 条评论

Wi Wi

创建于 2009年07月30日 06:34

according to javadoc specification: "The tag section starts with the first block tag, which is defined by the first

character that begins a line (ignoring leading asterisks, white space, and leading separator"
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html

so the only way is to use unicode html code for '@' at the start of line

/**
* <pre><code>public class Subclasse extends EnderecoAssociadoATipo {
*     @AttirbuteOverride(name = "ID_ASSOCIADO_ENDERECO", column = @Column(name = "NOME_CORRETO_DO_CAMPO"))
*     private EnderecoAssociadoATipo.Id id;
*     // resto da classe
* </code></pre>
*/
class BlaBla {

Permanently deleted user

创建于 2009年07月31日 01:38

Thank you Wi Wi

请先登录再写评论。