Tags de Programação Baseada em Anotação

A programação baseada em anotação define uma coleção de tags de sintaxe Javadoc que você insere no seu código de origem.

Elementos de Tag de Anotação

  1. Tipos de Tags

    As tags de programação baseada em anotação são classificadas em três grupos:

    • Tags de Tecnologia

      As tags de tecnologia mapeiam diretamente para tecnologias-chave em J2EE e outros padrões. Muitas dessas tags são derivadas diretamente da comunidade XDoclet. Para obter mais informações, consulte XDoclet para obter mais detalhes

    • Tags de Ligações e Extensões

      Essas tags permitem especificar dados de extensões e ligações específicas do Websphere que não são parte de tecnologia padrão.

    • Tags de Comportamento

      As tags de comportamento anotam um comportamento ou qualidade de serviço desejado e não tecnologias de implementação especificadas. O programa determina a tecnologia de implementação apropriada mais adiante no processo.

  2. Escopo

    O escopo refere-se à localização das tags no arquivo de origem Java™. As quatro opções de escopo válidas são pacote, classe, método e campo.

    • Pacote

      É possível adicionar tags ao comentário do pacote. Esse escopo fornece informações aplicáveis ao pacote Java inteiro, ao módulo ou ao aplicativo como um todo.

    • Parâmetro class

      É possível adicionar tags ao comentário de classe. Esse escopo fornece informações sobre o tipo ou a interface Java como um todo.

    • Método

      É possível adicionar tags aos comentários de um método específico dentro da classe. Esse escopo fornece informações sobre o método de referência na classe.

    • Campo

      É possível adicionar tags aos comentários de um campo específico dentro da classe. Esse escopo fornece informações específicas sobre o campo de referência na classe.

  3. Multiplicidade

    Multiplicidade refere-se ao número de vezes que uma tag específica pode aparecer em um arquivo de origem Java. Na anotação XDoclet, a multiplicidade é indicada entre parênteses após o nome da tag

    Exemplo

    @ejb.bean (0..1) indica que a tag "@ejb.bean" pode ser usada zero ou uma vez em um arquivo de origem Java.

    @ejb.ejb-external-ref (0..*) indica que a tag "@ejb.ejb-external-ref" pode ser usada de zero a um número infinito de vezes em um arquivo de origem Java.


Feedback