20

Enquanto eu mexia no netbeans usando linguagem java não entendi para que servia esse comando /** , fui atrás e apareceu alguma coisa sobre Javadoc, não entendi bem o que isso queria dizer alguém poderia me explicar?

2 Respostas 2

16

Para inserir comentários no código-fonte, em Java, pode-se utilizar uma de duas formas:

// Comentário em uma única linha

/* Comentário
   que se divide em várias
   linhas
 */

Quando se escreve comentários da forma (note os dois asteriscos na primeira linha)

/**
 *
 */

Os comentários podem ser interpretados por uma ferramenta - chamada Javadoc - que gera uma documentação baseada no código-fonte utilizando, além dos comentários entre /** */, outras anotações especiais, como @author e @date, que fornecem, respectivamente, informações de autoria e a data de criação do arquivo.

O artigo da wikipédia fornece uma boa noção sobre Javadoc.

A API do Java é um exemplo de documentação gerada utilizando-se a ferramenta.

3
  • então esse comando serve apenas para comentar mais que uma linha?
    – Nicolas
    Commented 20/02/2014 às 17:12
  • @Nicolas Editei a resposta dando mais detalhes Commented 20/02/2014 às 17:15
  • 1
    Interessante notar que o /** é um mero /*, o * a mais é apenas parte do texto "comentado", e é ignorado pelo Java como qualquer outro caractere que está dentro do comment, até que se encontre um */ . Ou seja, o 'pessoal" do Javadoc poderia ter escolhido /*#, /*{ ou mesmo /*JD, tanto faz o caractere, desde que seja dentro de um comment de várias linhas (ou seja, começado por /*).
    – Largato
    Commented 21/03/2014 às 21:51
2

Complementando, seguem algumas tags:

  • {@code} todo texto dentro das chaves não é interpretado, incluindo texto com marcação HTML e tags Java
  • {@docRoot} contém o diretório raiz da documentação gerada
  • @deprecated indica que o arquivo ou método está obsoleto, descontinuado, portanto não é indicado o seu uso
  • @exception serve para indicar os possíveis exceções
  • @throws serve para indicar os possíveis lançamentos
  • {@link} faz refência (link) à outra documentação de algum metodo
  • @param serve para descrever parâmetros
  • {@value} contém o valor de uma constante
  • @version especifica a versão atual da classe ou interface
  • @since especifica a versão em que o método foi incluido

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .