說明

在前面我們學習了OneToOne、OneToMany、ManyToOne，將資料庫中不同表格的關聯轉換為spring中不同entity的關聯。但是在不少場景中，我們希望在一個entity的檢視中同檢視到這幾個表的資訊，而無需通過entity之間的關聯。

在這個小例子中，我們還將學習和討論到：

• 表格有Employee，Employee_Address中存放員工多個地址，Employee_Phone中存放員工多個聯絡電話，Employee_Property中存放員工不確定的屬性。我們將通過一個entity（Employee）來獲取員工的資訊，並實現對員工資訊的增刪改查。
• FetchType.EAGER和FetchType.LAZY的差異，以及程式碼的注意事項。
• 從jsp頁面到spring framework到資料庫中中文資訊寫入如何避免亂碼的一些注意事項。（放在下一學習）

基礎類（String）存放在集合（有順序的List）

-- 這是一個基礎的員工資訊表，很簡單，姓名和Id
CREATE TABLE `Employee` (
  `EmployeeId` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  `FirstName` varchar(50) COLLATE utf8_unicode_ci NOT NULL,
  `LastName` varchar(50) COLLATE utf8_unicode_ci NOT NULL,
  PRIMARY KEY (`EmployeeId`)
) ENGINE=InnoDB

-- 員工的電話號碼，一個員工可以有多個電話號碼，其中Protrity用於在電話列表中的優先排序。
CREATE TABLE `Employee_Phone` (
  `Employee` bigint(20) unsigned NOT NULL,
  `Priority` smallint(5) unsigned NOT NULL,
  `Number` varchar(20) COLLATE utf8_unicode_ci NOT NULL,
  CONSTRAINT `Employee_Phone_Employee` FOREIGN KEY (`Employee`) 
     REFERENCES `Employee` (`EmployeeId`) ON DELETE CASCADE
) ENGINE=InnoDB
 

@Entity
public class Employee {
    private long id;
    private String firstName;
    private String lastName;
    //【1】設定List屬性：將從Employee_Phone中獲取員工的電話資訊。
    private List<String> phoneNumbers = new ArrayList<>();

    //【2】從collection table中獲取獲取集合（本例子為List）的資訊。
    // 2.1）@ElementCollection：在小例子中，頁面分頁顯示時給出員工的姓名，也給出聯絡電話，
    //      因此在業務邏輯上獲取entity物件的同時，就需要獲取電話資訊，採用FetchType.EAGER。
    // 2.2）@CollectionTable：給出關聯表格資訊。表格Employee_Phone的外來鍵Employee指向
    //      entity對應表格的EmployeeId列。
    // 2.3）@
 
[email protected]：讀取CollectionTable中的Number列資訊，以Priority為排序，
    //      存放到集合（List）中。表格中的priority或是List的index，即0,1,2,... 
    @ElementCollection(fetch = FetchType.EAGER)
    @CollectionTable( name="Employee_Phone",
          joinColumns = { @JoinColumn(name = "Employee", referencedColumnName = "EmployeeId")})
    @OrderColumn(name="Priority")
    @Column(name="Number")
    public List<String> getPhoneNumbers() {
        return phoneNumbers;
    }  	
    ... ...
}

Embeddabel類作為集合（Set）

員工還有地址資訊，也是可以有多條。

CREATE TABLE `Employee_Address` (
  `Employee` bigint(20) unsigned NOT NULL,
  `Street` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
  `City` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
  `State` varchar(100) COLLATE utf8_unicode_ci DEFAULT NULL,
  `Country` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
  `PostalCode_Code` varchar(10) COLLATE utf8_unicode_ci NOT NULL,
  `PostalCode_Suffix` varchar(5) COLLATE utf8_unicode_ci DEFAULT NULL,
  CONSTRAINT `Employee_Address_Employee` FOREIGN KEY (`Employee`) 
        REFERENCES `Employee` (`EmployeeId`) ON DELETE CASCADE
) ENGINE=InnoDB

1）定義@Embeddable類

// 在javadoc中對@ElementCollection的解釋：
// Specifies a collection of instances of a basic type or embeddable class。
// 地址是個複雜的類，要能在entity中做為ElementCollection，這個類需要是Embeddable
@Embeddable
public class Address {
    private String street;
    private String city;
    private String state;
    private String country;
    private PostalCode postalCode;
    ... ...
}

2）獲取@Embeddable類的集合，在entity中指定@Embeddable類屬性對應的列

@Entity
public class Employee {
    //【1】假定這些資訊沒有先後順序，存放在集合Set中。
    private Set<Address> addresses = new HashSet<>();

    //【2】從collection table中獲取獲取集合（本例為Set）的資訊。
    /* - @ElementCollection：在小例子中，頁面分頁顯示時給出員工的姓名，也給出聯絡電話，但並不提
         供地址資訊，只有點員工詳細檢視時才提供。也就是隻有需要的時候才獲取Adress資訊，這種情況
         採用FetchType.LAZY。
     - @Embeddable類如果是entity的屬性，則必須在同一個表格（之前學習），如果是collection的
         一個元素，則可以在不同的表格（現在學習），這個表的預設名字為entity表名_屬性名，本例為
         Employee_Address，符合預設定義，安全地，我們仍在@CollectionTable中設定。
       - @AttributeOverrides：本例子中列名和屬性名是一致的，如果不一致，可以通過
         @AttributeOverrides來設定。當然也可以在@Embeddable類中屬性採用@Column來指定。但是如
         果這個@Embeddable最終對映到兩個或者以上表，列名不一樣時，就需要在entity中指定。*/ 
    @ElementCollection(fetch = FetchType.LAZY)
    @CollectionTable(name="Employee_Address",
                     joinColumns ={@JoinColumn(name = "Employee", referencedColumnName = "EmployeeId")})
    @AttributeOverrides({ @AttributeOverride(name="street",column = @Column(name="Street")),	
                          @AttributeOverride(name = "city", column = @Column(name = "City")),
                          @AttributeOverride(name = "state", column = @Column(name = "State")),
                          @AttributeOverride(name = "country", [email protected](name = "Country")) })
    public Set<Address> getAddresses() {
        return addresses;
    }	
    ... ...
}

FetchType.LAZY

在這個例子中，Set<Address>採用了fetch = FetchType.LAZY，也就是程式碼中涉及該屬性處理時，才會去資料庫中獲取。我們有可能會碰到下面的異常：

org.hibernate.LazyInitializationException: failed to lazily initialize a collection of role: 
       cn.wei.flowingflying.chapter24.entities.Employee.addresses, could not initialize proxy - no Session

我們如果要對entity進行處理，如果後續用使用到lazy的屬性，就沒有初始化，會報錯。例如，需要save entity，即使沒有對Adress的資訊進行改動，但在Spring data中也是對完整資訊進行處理。解決方式就是要確保整獲完整的entity的資料。我們在Service中增加一個public Employee getEmployee(long id) 介面來替代Spring data中的findOne介面，用於獲取完整的entity資訊。

@Inject EmployeeRepository employeeRepository;

@Override
//【1】加入到transactional中。這裡讀了兩次，第一次是普通讀（不獲取LAZY屬性）；第二次是獲取LAZY屬
//     性。兩次操作有管理，放在一個事務中。
@Transactional
public Employee getEmployee(long id) {
    Employee employee = this.employeeRepository.findOne(id);
    //【2】實現初始化，例如呼叫employee.getAddresses()進行某個操作，例如.size()，觸發在資料庫中
    //     獲取相關的資訊。
    employee.getAddresses().size(); 
    return employee;
}

對映到集合Map

給員工資料增加一個擴充套件屬性說明

CREATE TABLE `Employee_Property` (
  `Employee` bigint(20) unsigned NOT NULL,
  `KeyName` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
  `Value` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  CONSTRAINT `Employee_Property_Employee` FOREIGN KEY (`Employee`) 
      REFERENCES `Employee` (`EmployeeId`) ON DELETE CASCADE
) ENGINE=InnoDB;

@Entity
public class Employee {
    //【1】這些擴充套件資訊放在key-value對中。
    private Map<String, String> extraProperties = new HashMap<>();

    /*【2】從collection table中獲取獲取鍵值對（本例為Map）的資訊。
       @Column和@MapKeyColumn分別代表CollectionTable中的value所在列和key所在列。如果是列舉做為
       值，則分別對應@Enumerated和@MapKeyEnumerated，如果是時間，則對應@Temporal和
       @MapKeyTemporal。不僅僅可以使用基礎類，還可以通過convert轉換為其他型別，或者是embeddable類 */
    @ElementCollection(fetch=FetchType.EAGER)
    @CollectionTable(name="Employee_Property",
                     joinColumns ={@JoinColumn(name = "Employee", referencedColumnName = "EmployeeId")})
    @Column(name = "Value")
    @MapKeyColumn(name = "KeyName")
    public Map<String, String> getExtraProperties() { ... }
    ... ...
}