註釋的範圍和位置

您可以在類別、方法和欄位層次,新增註釋至原始碼。

使用註釋

EJB 3.1 和 Java™ 持續性 API 會利用 meta 資料註釋,這是 J2SE 5.0 中所建立的特性。註釋是由 @ 符號後面接註釋類型所組成,有時候後面加上以括弧包含的「元素-值」配對清單。EJB 3.1 規格有定義各種註釋類型,例如:
  • 元件定義的註釋,例如 @Stateless 可指定 Bean 類型
  • @Remote 和 @Local 指定 Bean 是否可從遠端或本端存取
  • @TransactionAttribute 指定交易屬性
  • @MethodPermissions、@Unchecked 和 @SecurityRoles 指定安全與方法權限
Java 持續性 API 會新增建立實體時專用的註釋,例如:
  • @Entity 是元件定義的註釋,可指定類別為實體
  • @Table 指定要用在類別中的資料來源
註: JPA 對映註釋(例如 @Id、@Column)可以套用至欄位,也可以套用至方法,但是針對任何一個實體類別,只能將其套用至欄位或方法其中一項;也就是說,所有註釋都必須套用至欄位,或全部套用至方法。欄位只能有私密、受保護或套件可見性,而實體的用戶端不能直接存取欄位,所以您需要定義公用 getter 和 setter。
  • @MethodPermissions、@Unchecked 和 @SecurityRoles 指定安全與方法權限

註釋的範圍和位置

註釋會在類別、介面、方法或欄位層次運作。例如,元件定義的註釋(像是 @Stateless 或 @Entity)是類別層次註釋,會插入在類別宣告前面的註解區段中。
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 {
這些註釋的順序並不重要;通常元件定義的註釋會放在其他註釋前面,但不一定要這樣放。方法層次和欄位層次註釋會出現在類別或方法內:
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