love fish大鵬一曰同風起，扶搖直上九萬里

解說Entity

從EJB3.0開始，Entity Bean持久化規范與EJB的其他規范如Session Bean, Message Driven Bean和EJB3容器規范開始分離，單獨作為一個持久化API。而在將來，該持久化API很可能會從EJB3.0規范中脫離出來成為一個獨立的規范Java Persistence API。作為Java平臺上的通用數據訪問標準接口。 為了跟規范一致，我們將在開發手冊中將Entity Bean稱為Entity。

雖然EJB3 Entity可以是很簡單的java bean，只要批注了@Entity或者在xml配置中作了說明，就被做一個可持久化的Entity處理。 但還是需要遵行一定的規則：

• Entity類必須要有一個無參數的public或者protected的Constructor。
• 如果在應用中需要將該Entity類分離出來在分布式環境中作為參數傳遞，該Entity Class需要實現java.io.Serialzable接口。
• Entity類不可以是final，也不可有final的方法。
• abstract類和Concrete實體類都可以作為Entity類。
• Entity類中的屬性變量不可以是public。Entity類的屬性必須通過getter/setter或者其他的商業方法獲得。

定義對Entity中屬性變量的訪問

在絕大部分的商業應用，開發人員都可以忽略這部分無需關心。但如果你需要編寫復雜的Entity類的話，你需要了解這個部分。復雜的Entity類是指在Entity類的getter/setter和商業方法中包含比較復雜的業務邏輯而不是僅僅返回/符值某個屬性。

在大部分的情況下，我們都建議使Entity類中setter/getter中的邏輯盡可能簡單，除了必要的校驗符值外，不要包含復雜的業務邏輯，例如對關聯的其他Entity類進行操作。但有些情況下，我們還是需要在Entity類的setter/getter方法中包含商業邏輯。這時候，采用何種屬性訪問方式就可能會影響代碼的性能甚至是邏輯正確產生影響。

EJB3持久化規范中,在默認情況下所有的屬性都會自動的被持久化，除非屬性變量用@Transient元數據進行了標注。針對可持久化屬性定義了兩種屬性訪問方式(access): FIELD和PROPERTY。

• 如果采用access=FIELD, EJB3 Persistence運行環境（EJB3持久化產品，如Liberator EJB3)直接訪問對象的屬性變量，而不是通過getter。這種訪問方式也不要求每個屬性必須有getter/setter。如果需要在getter中包含商業邏輯，應該采用access=FIELD的方式。
• 如果采用access=PROPERTY, EJB3 Persistence運行環境將通過Entity類上的getter來訪問對象的屬性變量，這就要求每個屬性變量要有getter/setter方法。在EJB3中，默認的屬性訪問方式是PROPERTY。access=PROPERTY時getter/setter的邏輯應該盡量簡單。

規范中access方式還有多一層含義。就是采用access=FIELD時，元數據應該批注在屬性上。

                
    @Id(generate=GeneratorType.NONE)
    private int id;
    private String foo;

    /**
     * The entity class must have a no-arg constructor.
     */
    public HelloEntityBean() {
    }

    
    public int getId() {
        return id;
    } 
            

采用access=PROPERTY(默認方式)時，元數據應該批注在對應屬性變量的getter上。

                     
    private int id;
    private String foo;

    /**
     * The entity class must have a no-arg constructor.
     */
    public HelloEntityBean() {
    }

    @Id(generate=GeneratorType.NONE)
    public int getId() {
        return id;
    } 
                 

為了方便開發，Liberator EJB3實現對元數據批注的位置比規范規定的寬松，針對屬性變量或它的getter進行批注都可以，不受access類型的影響。

對Entity類中，getter/setter的命名規則遵從java bean規范。

Entity類中的屬性變量可以是以下數據類型：

• 原始數據類型和他們的對象類型
• java.lang.String
• java.math.BigInteger
• java.math.BigDecimal
• java.util.Date
• java.util.Calendar
• java.sql.Date
• java.sql.Time
• java.sql.Timestamp
• byte[]
• Byte[]
• char[]
• Character[]
• enums
• Entity類
• 嵌入實體類(embeddable classes)

還可以是以下集合類型:

• java.util.Collection和它的實體類
• java.util.Set和它的實體類
• java.util.List和它的實體類
• java.util.Map和它的實體類

主鍵和實體標識（Primary Key and Entity Identity)

每個Entity類都必須有一個主鍵。在EJB3中定義了兩種主鍵：

• 鍵單主鍵
• 復合主鍵

簡單主鍵必須對應Entity中的一個屬性變量（Instance Variable)，而該屬性對應數據庫表中的一列。使用簡單主鍵，我們只需要用@Id元數據對一個屬性變量或者她的getter方法進行批注。

當我們需要使用一個或多個屬性變量（表中的一列或多列）聯合起來作為主鍵，我們需要使用復合主鍵。復合主鍵要求我們編寫一個復合主鍵類( Composite Primary Key Class )。復合主鍵類需要符合以下一些要求：

• 復合主鍵類必須是public和具備一個沒有參數的constructor
• 復合主鍵類的每個屬性變量必須有getter/setter，如果沒有，每個屬性變量則必須是public或者protected
• 復合主鍵類必須實現java.io.serializable
• 復合主鍵類必須實現equals()和hashcode()方法
• 復合主鍵類中的主鍵屬性變量的名字必須和對應的Entity中主鍵屬性變量的名字相同
• 一旦主鍵值設定后，不要修改主鍵屬性變量的值

                
    @Id
    private String firstName;
    
    @Id
    private String lastName;

    public Person() {
    }
   
    
    
            

                
public class PersonPK implements java.io.Serializable{
    
    private String firstName;
    private String lastName;

    public PersonPK() {
    }

    public String getFirstName() {
        return firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    public String getLastName() {
        return lastName;
    }

    public void setLastName(String lastName) {
        this.lastName = lastName;
    }

    public boolean equals(Object o) {
        if (this == o) return true;
        if (!(o instanceof PersonPK)) return false;

        final PersonPK personPK = (PersonPK) o;

        if (!firstName.equals(personPK.firstName)) return false;
        if (!lastName.equals(personPK.lastName)) return false;

        return true;
    }

    public int hashCode() {
        int result;
        result = firstName.hashCode();
        result = 29 * result + lastName.hashCode();
        return result;
    }
}