Escopo e colocação de anotações

É possível incluir anotações ao seu código-fonte no nível de classe, método e campo.

Usando anotações

O EJB 3.1 e a API de Persistência Java™ utilizam anotações de metadados, um recurso que foi introduzido no J2SE 5.0. Uma anotação consiste no sinal @ antes do tipo de anotação, às vezes seguido por uma lista parentética de pares de valores do elemento. A especificação EJB 3.1 define vários tipos de anotação, por exemplo:
  • Anotação que define componentes, como @Stateless, que especifica o tipo de bean
  • @Remote e @Local especificam se um bean é acessível remotamente ou localmente
  • @TransactionAttribute especifica os atributos da transação
  • @MethodPermissions, @Unchecked e @SecurityRoles especificam as permissões de segurança e de método
A API de Persistência Java inclui anotações específicas à criação de entidades, por exemplo:
  • @Entity é uma anotação que define componentes, que especifica que uma classe é uma entidade
  • @Table especifica a origem de dados a ser utilizada na classe
Nota: As anotações de mapeamento JPA (@Id, @Column, por exemplo) podem ser aplicadas aos campos e métodos, mas, para qualquer classe de entidade, é possível aplicar somente a um ou outro; isto é, todas as anotações devem ser aplicadas a campos ou todas elas devem ser aplicadas a métodos. Os campos podem ter somente visibilidade privada, protegida ou de pacote e os clientes de uma entidade não podem acessar os campos diretamente, portanto, é preciso definir os compradores e configuradores públicos.
  • @MethodPermissions, @Unchecked e @SecurityRoles especificam as permissões de segurança e de método

Escopo e colocação de anotações

As anotações operam no nível de classe, interface, método ou campo. Por exemplo, anotações que definem componentes (como @Stateless ou @Entity) são de nível de classe e são inseridas na seção de comentários antes da declaração de classe:
package com.ibm.websphere.ejb3sample.counter;

import javax.ejb.Stateless;
import javax.interceptor.Interceptors;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;

@Stateless
@Interceptors ( Audit.class )

public class StatelessCounterBean implements LocalCounter, RemoteCounter {
A ordem dessas anotações não é significativa; geralmente, a anotação que define componentes é colocada antes de outras anotações, mas esse posicionamento não é necessário. As anotações de nível de método e de campo aparecem na classe ou método:
public class JPACounterEntity {

    @Id
    private String primarykey = "PRIMARYKEY";

    private int value = 0;
Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: cusingannotations.html