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
- @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;