hibernate 注釋說明，hibernate注釋
1 * @Entity —— 將一個類聲明為一個實體 bean(即一個持久化 POJO
2 類)
3 * @Id —— 注解聲明了該實體 bean 的標識屬性（對應表中的主
4 鍵）。
5 * @Table —— 注解聲明了該實體 bean 映射指定的表（table）,目錄
6 （catalog）和 schema 的名字
7 * @Column —— 注解聲明了屬性到列的映射。該注解有如下的屬
8 性
9 * name 可選，列名（默認值是屬性名）
10 * unique 可選，是否在該列上設置唯一約束（默認值 false）
11 * nullable 可選，是否設置該列的值可以為空（默認值 false）
12 * insertable 可選，該列是否作為生成的 insert 語句中的一個列（默認
13 值 true）
14 * updatable 可選，該列是否作為生成的 update 語句中的一個列（默認
15 值 true）
16 * columnDefinition 可選，為這個特定列覆蓋 sql ddl 片段（這可能導
17 致無法在不同數據庫間移植）
18 * table 可選，定義對應的表（默認為主表）
19 * length 可選，列長度（默認值 255）
20 * precision 可選，列十進制精度（decimal precision)(默認值
21 0）
22 * scale 可選，如果列十進制數值范圍（decimal scale）可用，在此設
23 置（默認值 0）
24 * @GeneratedValue —— 注解聲明了主鍵的生成策略。該注解有如下屬
25 性
26 * strategy 指定生成的策略（JPA 定義的），這是一個 GenerationType。
27 默認是 GenerationType. AUTO
28 * GenerationType.AUTO 主鍵由程序控制
29 * GenerationType.TABLE 使用一個特定的數據庫表格來保存主鍵
30 * GenerationType.IDENTITY 主鍵由數據庫自動生成（主要是自動增長類
31 型）
32 * GenerationType.SEQUENCE 根據底層數據庫的序列來生成主鍵，條件是
33 數據庫支持序列。（這個值要與 generator 一起使用）
34 * generator 指定生成主鍵使用的生成器（可能是 orcale 中的序
35 列）。
36 * @SequenceGenerator —— 注解聲明了一個數據庫序列。該注解有如
37 下屬性
38 * name 表示該表主鍵生成策略名稱，它被引用在@GeneratedValue 中設
39 置的“gernerator”值中
40 * sequenceName 表示生成策略用到的數據庫序列名稱。
41 * initialValue 表示主鍵初始值，默認為 0.
42 * allocationSize 每次主鍵值增加的大小，例如設置成 1，則表示每次
43 創建新記錄後自動加 1，默認為 50.
44 * @GenericGenerator —— 注解聲明了一個 hibernate 的主鍵生成策略。
45 支持十三種策略。該注解有如下屬性
46 * name 指定生成器名稱
47 * strategy 指定具體生成器的類名（指定生成策略）。
48 * parameters 得到 strategy 指定的具體生成器所用到的參數。
49 * 其十三種策略（strategy 屬性的值）如下：
50 * 1.native 對於 orcale 采用 Sequence 方式，對於 MySQL 和
51 SQL Server 采用 identity(處境主鍵生成機制)，
52 * native 就是將主鍵的生成工作將由數據庫完成，hibernate 不
53 管（很常用）
54 * 例：
55 @GeneratedValue(generator = "paymentableGenerator")
56 * @GenericGenerator(name = "paymentableGenera
57 tor", strategy = "native")
58 * 2.uuid 采用 128 位的 uuid 算法生成主鍵，uuid 被編碼為
59 一個 32 位 16 進制數字的字符串。占用空間大（字符串類型）。
60 * 例：
61 @GeneratedValue(generator = "paymentableGenerator")
62 * @GenericGenerator(name = "paymentableGenera
63 tor", strategy = "uuid")
64 * 3.hilo 要在數據庫中建立一張額外的表，默認表名為
65 hibernate_unque_key，默認字段為 integer 類型，名稱是 next_hi（比較
66 少用）
67 * 例：
68 @GeneratedValue(generator = "paymentableGenerator")
69 * @GenericGenerator(name = "paymentableGen
70 erator", strategy = "hilo")
71 * 4.assigned 在插入數據的時候主鍵由程序處理（很常用），
72 這是<generator>元素沒有指定時的默認生成策略。等同於 JPA 中的
73 AUTO。
74 * 例：
75 @GeneratedValue(generator = "paymentableGenerator")
76 * @GenericGenerator(name = "paymentableGenera
77 tor", strategy = "assigned")
78 * 5.identity 使用 SQL Server 和 MySQL 的自增字段，這個
79 方法不能放到 Oracle 中，Oracle 不支持自增字段，要設定 sequence(MySQL
80 和 SQL Server 中很常用)。等同於 JPA 中的 IDENTITY
81 * 例：
82 @GeneratedValue(generator = "paymentableGenerator")
83 * @GenericGenerator(name = "paymentableGenera
84 tor", strategy = "identity")
85 * 6.select 使用觸發器生成主鍵（主要用於早期的數據庫主
86 鍵生成機制，少用）
87 * 例：
88 @GeneratedValue(generator = "paymentableGenerator")
89 * @GenericGenerator(name = "paymentableGenera
90 tor", strategy = "select")
91 * 7.sequence 調用謹慎數據庫的序列來生成主鍵，要設定序
92 列名，不然 hibernate 無法找到。
93 * 例：
94 @GeneratedValue(generator = "paymentableGenerator")
95 * @GenericGenerator(name = "paymentableGenerator", strat
96 egy = "sequence",
97 * parameters = { @Parameter(name = "sequence", value
98 = "seq_payablemoney") })
99 * 8.seqhilo 通過 hilo 算法實現，但是主鍵歷史保存在 Sequence 中，
100 適用於支持 Sequence 的數據庫，如 Orcale(比較少用）
101 * 例：
102 @GeneratedValue(generator = "paymentableGenerator")
103 * @GenericGenerator(name = "paymentableGenerator", strat
104 egy = "seqhilo",
105 * parameters = { @Parameter(name = "max_lo", value =
106 "5") })
107 * 9.increnment 插入數據的時候 hibernate 會給主鍵添加一個自增
108 的主鍵，但是一個 hibernate 實例就維護一個計數器，所以在多個實例運行
109 的時候不能使用這個方法。
110 * 例：
111 @GeneratedValue(generator = "paymentableGenerator")
112 * @GenericGenerator(name = "paymentableGenera
113 tor", strategy = "increnment")
114 * 10.foreign 使用另一個相關的對象的主鍵。通常和<one-
115 to-one>聯合起來使用。
116 * 例：@Id
117 * @GeneratedValue(generator = "idGenerator")
118 * @GenericGenerator(name = "idGenerator", strategy = "
119 foreign",
120 * parameters = { @Parameter(name = "property
121 ", value = "info") })
122 * Integer id;
123 * @OneToOne
124 * EmployeeInfo info;
125 * 11.guid 采用數據庫底層的 guid 算法機制，對應 MySQL 的 uuid()
126 函數，SQL Server 的 newid()函數，ORCALE 的 rawtohex(sys_guid())函數
127 等
128 * 例：
129 @GeneratedValue(generator = "paymentableGenerator")
130 * @GenericGenerator(name = "paymentableGenerator", strat
131 egy = "guid")
132 * 12.uuid.hex 看 uudi,建議用 uuid 替換
133 * 例：
134 @GeneratedValue(generator = "paymentableGenerator")
135 * @GenericGenerator(name = "paymentableGenerator", strat
136 egy = "uuid.hex")
137 * 13.sequence-identity sequence 策略的擴展，采用立即檢索策略
138 來獲取 sequence 值，需要 JDBC3.0 和 JDK4 以上（含 1.4）版本
139 * 例：
140 @GeneratedValue(generator = "paymentableGenerator")
141 * @GenericGenerator(name = "paymentableGenerator", strat
142 egy = "sequence-identity",
143 * parameters = { @Parameter(name = "sequence
144 ", value = "seq_payablemoney") })
145 *
146 * @OneToOne 設置一對一個關聯。cascade 屬性有五個值(只有
147 CascadeType.ALL 好用？很奇怪)，分別是 CascadeType.PERSIST(級聯新建)，
148 CascadeType.REMOVE（級聯刪除），CascadeType.REFRESH（級聯刷新），
149 CascadeType.MERGE（級聯更新），CascadeType.ALL（全部四項）
150 * 方法一
151 * 主表： ?@OneToOne(cascade = CascadeType.ALL)
152 * @PrimaryKeyJoinColumn
153 * public 從表類 get 從表類(){return 從表對象}
154 * 從表：沒有主表類。
155 * 注意：這種方法要求主表與從表的主鍵值想對應。
156 * 方法二
157 * 主表：?@OneToOne(cascade = CascadeType.ALL)
158 * @JoinColumn(name="主表外鍵") //這裡指定的是
159 數據庫中的外鍵字段。
160 * public 從表類 get 從表類(){return 從表
161 類}
162 * 從表：@OneToOne(mappedBy = "主表類中的從表屬性")//
163 例主表 User 中有一個從表屬性是 Heart 類型的 heart，這裡就填
164 heart
165 * public 主表類 get 主表類(){return 主表對
166 象}
167 * 注意：@JoinColumn 是可選的。默認值是從表變量名+"_"+從
168 表的主鍵（注意，這裡加的是主鍵。而不是主鍵對應的變量）。
169 * 方法三
170 * 主表：@OneToOne(cascade=CascadeType.ALL)
171 * @JoinTable( name="關聯表名",
172 * joinColumns = @JoinColumn(name="主表外鍵"),
173 * inverseJoinColumns = @JoinColumns(name="從表外鍵
174 ")
175 * )
176 * 從表：@OneToOne(mappedBy = "主表類中的從表屬性")//
177 例主表 User 中有一個從表屬性是 Heart 類型的 heart，這裡就填
178 heart
179 * public 主表類 get 主表類(){return 主表對
180 象}
181 * @ManyToOne 設置多對一關聯
182 * 方法一
183 * @ManyToOne(cascade={CasCadeType.PERSIST,CascadeType.MERGE
184 })
185 * @JoinColumn(name="外鍵")
186 * public 主表類 get 主表類(){return 主表對象}
187 * 方法二
188 * @ManyToOne(cascade={CascadeType.PERSIST,CascadeType.MERGE
189 })
190 * @JoinTable(name="關聯表名"，
191 * joinColumns = @JoinColumn(name="主表外鍵"),
192 * inverseJoinColumns = @JoinColumns(name="從表外鍵")
193 * )
194 * @OneToMany 設置一對多關聯。cascade 屬性指定關聯級別,參考
195 @OneToOne 中的說明。fetch 指定是否延遲加載，值為 FetchType.LAZY 表示
196 延遲，為 FetchType.EAGER 表示立即加載
197 * 方法一 使用這種配置，在為“一端”添加“多端”時，
198 不會修改“多端”的外鍵。在“一端”加載時，不會得到“多端”。如果使
199 用延遲加載，在讀“多端”列表時會出異常，立即加載在得到多端時，是一
200 個空集合（集合元素為 0）。
201 * “一端”配置
202 * @OneToMany(mappedBy="“多端”的屬性")
203 * public List<“多端”類> get“多端”列表(){return “多
204 端”列表}
205 * “多端”配置參考@ManyToOne.
206 * 方法二
207 * “一端”配置
208 * @OneToMany(mappedBy="“多端”的屬性")
209 * @MapKey(name="“多端”做為 Key 的屬性")
210 * public Map<“多端”做為 Key 的屬性的類,主表類> get“多端”
211 列表（）{return “多端”列表}
212 * “多端”配置參考@ManyToOne.
213 * 方法三 使用這種配置，在為“一端”添加“多端”時，可以修
214 改“多端”的外鍵。
215 * “一端”配置
216 * @OneToMany
217 * @JoinColumn(name="“多端”外鍵")
218 * public List<“多端”類> get“多端”列表(){return “多
219 端”列表}
