前言 對於java開發者而言，註解應該不是一個陌生的概念，早在JavaSE階段，例如@Override標記重寫父類方法或實現介面方法，@Test標記單元測試方法，所以我們可以簡單地把它理解為一種有特殊含義的標記...在開發過程中，我們還可以用註解方式替代配置文件實現相關功能，例如Java web開發 ...
前言
對於java開發者而言，註解應該不是一個陌生的概念，早在JavaSE階段，例如@Override標記重寫父類方法或實現介面方法，@Test標記單元測試方法，所以我們可以簡單地把它理解為一種有特殊含義的標記...在開發過程中，我們還可以用註解方式替代配置文件實現相關功能，例如Java web開發中，3.0版本後，利用@WebServlet、@WebListener等註解分別可以替代web項目XML配置文件中相關內容。而本文中講述的就是Hibernate的映射配置文件與映射註解的對比，這兩種方式均可以實現映射功能，為了避免先入為主，在此先不闡述孰優孰劣，接下來以實體類基本映射示例，分別用配置文件和註解方式實現。
hibernate.cfg.xml配置文件在使用兩種方式時的變動
<?xml version="1.0"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- 以下四行分別為：資料庫驅動類、Drivermanager獲取連接的參數URL、用戶名、密碼 --> <property name="connection.driver_class">com.mysql.jdbc.Driver</property> <property name="connection.url">jdbc:mysql://127.0.0.1/web?characterEcoding=utf-8</property> <property name="connection.username">root</property> <property name="connection.password">123456</property> <!-- 設置方言，hibernate會根據資料庫的類型相應生成SQL語句 --> <property name="dialect">org.hibernate.dialect.MySQLDialect</property> <!-- 1.使用映射文件時 --> <!-- 映射配置源文件的位置 --> <mapping resource="demo/pojo/Person.hbm.xml"/> <!-- 2.使用映射註解時 --> <!-- 註冊關係映射類 --> <mapping class="demo.pojo.Person" /> </session-factory> </hibernate-configuration>
實體類映射
背景：資料庫中一個用戶表person，欄位四個，包涵自增主鍵id、姓名name、性別sex、年齡age，映射實體類為Person,屬性四個，id、name、gender、age。註意這裡實體類屬性名和數據表中欄位名如果不一致，例如這裡的sex和gender，在映射文件中<property>標簽中name和colum兩個屬性都要寫上，在註解中也不能簡化省略@column，column從譯意上大家應該都能知道它是對應資料庫的欄位上，如果不指定欄位，預設情況下，系統會把映射文件中的name屬性值作為欄位名，註解方式時會把屬性名作為欄位名。另外一個要註意的地方就是類屬性是區分大小寫的，而欄位是不區分大小寫的。
映射配置文件
<?xml version="1.0"?> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> <hibernate-mapping> <!-- name是實體類全名，table為數據表名 --> <class name="demo.pojo.Person" table="Person"> <id name="id" column="id"> <!-- 主鍵生成方式，native是讓hibernate自動識別 --> <generator class="native"></generator> </id> <!-- 註意點： 0.name值為實體類中屬性名，column為數據表中欄位名； 1.當實體類中屬性名與對應數據表欄位名相同時，後面的column可以省略，hibernate會自動匹配，例如下麵age ； 2.反之當實體類中屬性名與對應數據表欄位名不相同時，兩項都要寫上，例如下麵gender和sex --> <property name="name" column="name"></property> <property name="gender" column="sex"></property> <property name="age"></property> </class> </hibernate-mapping>
映射註解方式
package demo.pojo; import javax.persistence.Column; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; import javax.persistence.Table; //實體類屬性註解，這裡統一寫在各屬性的get方法上 @Entity//標記實體類 @Table(name="person",catalog="web")//name對應數據表名，catalog對應資料庫名 public class Person { private Integer id; private String name; private String gender; private Integer age; @Id//標記主鍵 @Column(name="id")//主鍵欄位名，這裡與類屬性id是對應相同的，此行可以簡化不寫 @GeneratedValue(strategy=GenerationType.AUTO)//主鍵生成策略，自動識別 public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } @Column(name="name")//主鍵欄位名，這裡與類屬性name是對應相同的，此行可以簡化不寫 public String getName() { return name; } public void setName(String name) { this.name = name; } @Column(name="sex")//主鍵欄位名，這裡與類屬性gender是對應，但不相同，不可省略 public String getGender() { return gender; } public void setGender(String gender) { this.gender = gender; } //省略註解 public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } @Override public String toString() { return "Person [id=" + id + ", name=" + name + ", gender=" + gender + ", age=" + age + "]"; } }
註意點
0.在hibernate.cfg.xml配置文件中，使用兩種映射方式分別要填映射配置源文件的位置和映射類的全名，一個是<mapping resource="XX/XX/XXX">，一個是<mapping class="XXX.XXX.XXX" />；
1.在使用註解方式時，實體類中導入不要導成Hibernate下的，這裡引入都是JPA（Java Persistence API）範疇下的類，不要因為是hibernate框架下，順其自然地以為是那個Hibernate下的類，圖示如下
小結
相較於冗長的一段段代碼和各個單獨的配置文件，註解無疑會顯得小巧方便一些，特別是還有後面的關聯映射(一對一、一對多、多對一、多對多)，映射多了，所需要的配置文件更多，使用註解直接省略了這些文件。深入理解好註解對框架的學習也很有幫助，許多框架中都引入了註解的技術，不論是否認可註解的優勢，個人認為掌握好註解的使用都是很有必要的。
