本文轉載自:http://lib.csdn.net/article/javaee/34092
1、@Entity(name=”EntityName”)
必須,name為可選,對應資料庫中一的個表
2、@Table(name=”“,catalog=”“,schema=”“)
可選,通常和@Entity配合使用,隻能标注在實體的class定義處,表示實體對應的資料庫表的資訊
name:可選,表示表的名稱.預設地,表名和實體名稱一緻,隻有在不一緻的情況下才需要指定表名
catalog:可選,表示Catalog名稱,預設為Catalog(“”).
schema:可選,表示Schema名稱,預設為Schema(“”).
3、@id
必須
@id定義了映射到資料庫表的主鍵的屬性,一個實體隻能有一個屬性被映射為主鍵.置于getXxxx()前.
4、@GeneratedValue(strategy=GenerationType,generator=”“)
可選
strategy:表示主鍵生成政策,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4種,分别表示讓ORM架構自動選擇,
根據資料庫的Identity字段生成,根據資料庫表的Sequence字段生成,以有根據一個額外的表生成主鍵,預設為AUTO
generator:表示主鍵生成器的名稱,這個屬性通常和ORM架構相關,例如,Hibernate可以指定uuid等主鍵生成方式.
示例:
@Id
@GeneratedValues(strategy=StrategyType.SEQUENCE)
public int getPk() {
return pk;
}
5、@Basic(fetch=FetchType,optional=true)
可選
@Basic表示一個簡單的屬性到資料庫表的字段的映射,對于沒有任何标注的getXxxx()方法,預設即為@Basic
fetch: 表示該屬性的讀取政策,有EAGER和LAZY兩種,分别表示主支抓取和延遲加載,預設為EAGER.
optional:表示該屬性是否允許為null,預設為true
示例:
@Basic(optional=false)
public String getAddress() {
return address;
}
6、@Column
可選
@Column描述了資料庫表中該字段的詳細定義,這對于根據JPA注解生成資料庫表結構的工具非常有作用.
name:表示資料庫表中該字段的名稱,預設情形屬性名稱一緻
nullable:表示該字段是否允許為null,預設為true
unique:表示該字段是否是唯一辨別,預設為false
length:表示該字段的大小,僅對String類型的字段有效
insertable:表示在ORM架構執行插入操作時,該字段是否應出現INSETRT語句中,預設為true
updateable:表示在ORM架構執行更新操作時,該字段是否應該出現在UPDATE語句中,預設為true.對于一經建立就不可以更改的字段,該屬性非常有用,如對于birthday字段.
columnDefinition:表示該字段在資料庫中的實際類型.通常ORM架構可以根據屬性類型自動判斷資料庫中字段的類型,但是對于Date類型仍無法确定資料庫中字段類型究竟是DATE,TIME還是TIMESTAMP.此外,String的預設映射類型為VARCHAR,如果要将String類型映射到特定資料庫的BLOB或TEXT字段類型,該屬性非常有用.
示例:
@Column(name="BIRTH",nullable="false",columnDefinition="DATE")
public String getBithday() {
return birthday;
}
7、@Transient
可選
@Transient表示該屬性并非一個到資料庫表的字段的映射,ORM架構将忽略該屬性.
如果一個屬性并非資料庫表的字段映射,就務必将其标示為@Transient,否則,ORM架構預設其注解為@Basic
示例:
//根據birth計算出age屬性
@Transient
public int getAge() {
return getYear(new Date()) - getYear(birth);
}
8、@ManyToOne(fetch=FetchType,cascade=CascadeType)
可選
@ManyToOne表示一個多對一的映射,該注解标注的屬性通常是資料庫表的外鍵
optional:是否允許該字段為null,該屬性應該根據資料庫表的外鍵限制來确定,預設為true
fetch:表示抓取政策,預設為FetchType.EAGER
cascade:表示預設的級聯操作政策,可以指定為ALL,PERSIST,MERGE,REFRESH和REMOVE中的若幹組合,預設為無級聯操作
targetEntity:表示該屬性關聯的實體類型.該屬性通常不必指定,ORM架構根據屬性類型自動判斷targetEntity.
示例:
//訂單Order和使用者User是一個ManyToOne的關系
//在Order類中定義
@ManyToOne()
@JoinColumn(name="USER")
public User getUser() {
return user;
}
9、@JoinColumn
可選
@JoinColumn和@Column類似,介量描述的不是一個簡單字段,而一一個關聯字段,例如.描述一個@ManyToOne的字段.
name:該字段的名稱.由于@JoinColumn描述的是一個關聯字段,如ManyToOne,則預設的名稱由其關聯的實體決定.
例如,實體Order有一個user屬性來關聯實體User,則Order的user屬性為一個外鍵,
其預設的名稱為實體User的名稱+下劃線+實體User的主鍵名稱
示例:
見@ManyToOne
10、@OneToMany(fetch=FetchType,cascade=CascadeType)
可選
@OneToMany描述一個一對多的關聯,該屬性應該為集體類型,在資料庫中并沒有實際字段.
fetch:表示抓取政策,預設為FetchType.LAZY,因為關聯的多個對象通常不必從資料庫預先讀取到記憶體
cascade:表示級聯操作政策,對于OneToMany類型的關聯非常重要,通常該實體更新或删除時,其關聯的實體也應當被更新或删除
例如:實體User和Order是OneToMany的關系,則實體User被删除時,其關聯的實體Order也應該被全部删除
示例:
@OneTyMany(cascade=ALL)
public List getOrders() {
return orders;
}
11、@OneToOne(fetch=FetchType,cascade=CascadeType)
可選
@OneToOne描述一個一對一的關聯
fetch:表示抓取政策,預設為FetchType.LAZY
cascade:表示級聯操作政策
示例:
@OneToOne(fetch=FetchType.LAZY)
public Blog getBlog() {
return blog;
}
12、@ManyToMany
可選
@ManyToMany 描述一個多對多的關聯.多對多關聯上是兩個一對多關聯,但是在ManyToMany描述中,中間表是由ORM架構自動處理
targetEntity:表示多對多關聯的另一個實體類的全名,例如:package.Book.class
mappedBy:表示多對多關聯的另一個實體類的對應集合屬性名稱
示例:
User實體表示使用者,Book實體表示書籍,為了描述使用者收藏的書籍,可以在User和Book之間建立ManyToMany關聯
@Entity
public class User {
private List books;
@ManyToMany(targetEntity=package.Book.class)
public List getBooks() {
return books;
}
public void setBooks(List books) {
this.books=books;
}
}
@Entity
public class Book {
private List users;
@ManyToMany(targetEntity=package.Users.class, mappedBy="books")
public List getUsers() {
return users;
}
public void setUsers(List users) {
this.users=users;
}
}
兩個實體間互相關聯的屬性必須标記為@ManyToMany,并互相指定targetEntity屬性,
需要注意的是,有且隻有一個實體的@ManyToMany注解需要指定mappedBy屬性,指向targetEntity的集合屬性名稱
利用ORM工具自動生成的表除了User和Book表外,還自動生成了一個User_Book表,用于實作多對多關聯
13、@MappedSuperclass
可選
@MappedSuperclass可以将超類的JPA注解傳遞給子類,使子類能夠繼承超類的JPA注解
示例:
@MappedSuperclass
public class Employee() {
....
}
@Entity
public class Engineer extends Employee {
.....
}
@Entity
public class Manager extends Employee {
.....
}
14、@Embedded
可選
@Embedded将幾個字段組合成一個類,并作為整個Entity的一個屬性.
例如User包括id,name,city,street,zip屬性.
我們希望city,street,zip屬性映射為Address對象.這樣,User對象将具有id,name和address這三個屬性.
Address對象必須定義為@Embededable
示例:
@Embeddable
public class Address {city,street,zip}
@Entity
public class User {
@Embedded
public Address getAddress() {
..........
}
}
Hibernate驗證注解
注解
适用類型
說明
示例
@Pattern
String
通過正規表達式來驗證字元串
@attern(regex=”[a-z]{6}”)
@Length
String
驗證字元串的長度
@length(min=3,max=20)
String
驗證一個Email位址是否有效
@Range
Long
驗證一個整型是否在有效的範圍内
@Range(min=0,max=100)
@Min
Long
驗證一個整型必須不小于指定值
@Min(value=10)
@Max
Long
驗證一個整型必須不大于指定值
@Max(value=20)
@Size
集合或數組
集合或數組的大小是否在指定範圍内
@Size(min=1,max=255)
以上每個注解都可能性有一個message屬性,用于在驗證失敗後向使用者傳回的消息,還可以三個屬性上使用多個注解
[email protected]
通過注釋@Entity或者(@Entity())表示被标示的類對應資料庫中的一張表。
}
@Entity
public class TravelProfile {
…
}
上面的例子告訴O/R映射引擎,類TravelProfile是可以持久化的,同時它對應資料庫中的一張表。但是它沒有指明對應哪個資料庫中的哪張表。
2.中繼資料映射标記
2.1 @Table
@Table()标記為實體初始化一張表,定義如下:
@Target({TYPE}) @Retention(RUNTIME)
public @interface Table {
String name() default “”;
String catalog() default “”;
String schema() default “”;
UniqueConstraint[] uniqueConstraints() default {};
}
Name:指明表的名字。(可選)
Catalog:表示表的catalog.(可選)
Schema:表示表的schema.(可選)
uniqueConstraints:制定表的唯一限制。(可選)
因為所有的屬性都是可選的,也就是說@Table可以在進行映射的時候可以不标明。當不标明的情況下表的名字就是實體的類名。表屬于的schema就是所屬實體單元集的schema(就是目前連接配接資料庫的使用者)。
下面給出的例子中,指明表為CUST,所屬的schema為RECORDS:
@Entity
@Table(name=”CUST”, schema=”RECORDS”)
public class Customer { … }
2.2 @UniqueConstraint标記
@UniqueConstraint用來指定表字段的唯一限制,定義如下:
@Target({}) @Retention(RUNTIME)
public @interface UniqueConstraint {
String[] columnNames();
}
columnNames:制定唯一限制的字段。
@Entity
@Table(
name=”EMPLOYEE”,
uniqueConstraints=
@UniqueConstraint(columnNames={“EMP_ID”, “EMP_NAME”})
)
public class Employee { … }
上面的例子,唯一限制标記指定字段EMP_ID和字段EMP_NAME在表中EMPLOYEE中是唯一的。
[email protected]标記
@Column标記把實體的屬性或域映射到表的字段,當沒有在實體的屬性或域中使用該标記那資料庫的對應表的字段名就是實體的屬性名或域名。其定義為:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface Column {
String name() default “”;
boolean unique() default false;
boolean nullable() default true;
boolean insertable() default true;
boolean updatable() default true;
String columnDefinition() default “”;
String table() default “”;
int length() default 255;
int precision() default 0; // decimal precision
int scale() default 0; // decimal scale
}
Name:指定字段名。
Unique:指明該字段是否唯一,預設為false。
Nullable:指明是否可以為空,預設是true。
Insertable:指明該字段在産生SQL INSERT語句中是否産生該字段。
Updatable:指明該字段在産生SQL INSERT語句中是否産生該字段。
columnDefinition:指定産生表的時候,使用它指定該字段一些屬性。
Table:當一個實體對應多個表的時候,指定該字段屬于哪個表。
Length:制定該字段的長度(隻有在字段為字元類型的才有用),預設是255。
Precision: 指明字段的精度(在字段為decimal類型的時候使用),預設是0
Scale:為字段為number型指定标量,預設為0。
下面給出例子:
@Column(name=”DESC”, nullable=false, length=512)
public String getDescription() { return description; }
@Column(name=”DESC”,
columnDefinition=”CLOB NOT NULL”,
table=”EMP_DETAIL”)
@Lob
public String getDescription() { return description; }
@Column(name=”ORDER_COST”, updatable=false, precision=12, scale=2)
public BigDecimal getCost() { return cost; }
[email protected]标記
@JoinColumn标記用來映射實體之間的關聯關系,定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface JoinColumn {
String name() default “”;
String referencedColumnName() default “”;
boolean unique() default false;
boolean nullable() default true;
boolean insertable() default true;
boolean updatable() default true;
String columnDefinition() default “”;
String table() default “”;
}
Name:指定外鍵字段名,預設的名字是被引用實體在引用實體内部的屬性标量名或域名加上下劃線”_”,再加上被引用實體的主鍵字段名構成。
ReferencedColumnName:被引用表的字段,如果沒有那預設的就是該表的主鍵。
Unique:指明該字段是否唯一,預設為false。
Nullable:外鍵是否可以為空,預設是true。
Insertable:指明該字段在産生SQL INSERT語句中是否産生該字段。
Updatable:指明該字段在産生SQL INSERT語句中是否産生該字段。
columnDefinition:指定産生表的時候,使用它指定該字段一些屬性。
Table:當一個實體對應多個表的時候,指定該字段屬于哪個表。
下面例子的多對一關系中,指明了被引用實體在本實體的外鍵為ADDR_ID。
@ManyToOne
@JoinColumn(name=”ADDR_ID”)
public Address getAddress() { return address; }
[email protected]标記
@JoinColumns标記用在符合外鍵的時候,這個時候屬性name和referencedColumnName必須在@JoinColumn中進行初始化。例如:
@ManyToOne
@JoinColumns({
@JoinColumn(name=”ADDR_ID”, referencedColumnName=”ID”),
@JoinColumn(name=”ADDR_ZIP”, referencedColumnName=”ZIP”)
})
public Address getAddress() { return address; }
[email protected]标記
@Id标記把實體屬性或域映射到表的主鍵。其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface Id {}
下面例子通過标記@Id初始化實體的主鍵為id,也可以通過加上标記@Column(name=”PrimaryKey”)自定義表的主鍵。
@Id
public Long getId() { return id; }
[email protected]标記
提供産生主鍵的政策,這就意味着它隻能在出現标記@Id的情況下使用。其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface GeneratedValue {
GenerationType strategy() default AUTO;
String generator() default “”;
}
public enum GenerationType { TABLE, SEQUENCE, IDENTITY, AUTO };
政策類型為枚舉類型,共有四種類型分别為:TABLE, SEQUENCE, IDENTITY, AUTO。
TABLE:提示持久化引擎實作者,使用資料庫的表來産生和維護主鍵。
SEQUENCE和IDENTITY:分别指定使用目前資料庫的序列号和辨別字段來産生唯一表識。
AUTO:制定持久化引擎實作者,為不同的資料庫選擇合适的政策産生唯一辨別。
Generator:制定主鍵産生器,預設有持久化實作者提供。例如:
@Id
@GeneratedValue(strategy=SEQUENCE, generator=”CUST_SEQ”)
@Column(name=”CUST_ID”)
public Long getId() { return id; }
@Id
@GeneratedValue(strategy=TABLE, generator=”CUST_GEN”)
@Column(name=”CUST_ID”)
Long id;
[email protected]标記
這個标記用來指定一個實體類作為一個另外一個實體的主鍵。這個時候要求實體的複合主鍵的每個屬性或域必須和複合主鍵類對應的屬性或域是一樣的。其定義如下:
@Target({TYPE}) @Retention(RUNTIME)
public @interface IdClass {
Class value();
}
下面例子中,複合主鍵類為EmployeePK,包含域empName和birthday類型分别為String,Date。
@IdClass(com.jl.hr.EmployeePK.class)
@Entity
public class Employee {
@Id String empName;
@Id Date birthDay;
[email protected]标記
标記訓示實體的屬性或域是非持久化的。其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface Transient {}
下面的例子說明實體 Employee的域currentUser是非持久化的。
@Entity
public class Employee {
@Id int id;
@Transient User currentUser;
…
}
[email protected]标記
初始化實體的樂觀鎖的值,這個标記在大量并發通路的實體中非常有用。如果要對實體使用這個标記那最好的政策是一個實體使用一個@Version标記,同時這個标記對應字段的類型一般為:int,Integer,short,Short,long,Long,Timestamp中的一種。其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface Version {}
給出相關的例子如下:
@Version
@Column(name=”OPTLOCK”)
protected int getVersionNum() { return versionNum; }
[email protected]标記
此标記初始化實體的屬性或域映射成資料庫支援的大對象類型。大對象可以是字元也可以是二進制類型。除了字元串和字元類型的預設映射成Blob類型,其它的類型根據實體屬性或域的類型來決定資料庫大對象的類型。例如:
@Lob
@Column(name=”REPORT”)
protected String report;
@Lob @Basic(fetch=LAZY)
@Column(name=”EMP_PIC”, columnDefinition=”BLOB NOT NULL”)
protected byte[] pic;
[email protected]标記
用來指定實體持久化屬性的為枚舉類型,其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface Enumerated {
EnumType value() default ORDINAL;
}
public enum EnumType {
ORDINAL,
STRING
}
如果标記沒有顯性給出或者EnumType沒有指定,那枚舉類型預設為ORDINAL數字辨別。例如:
public enum EmployeeStatus {FULL_TIME, PART_TIME, CONTRACT}
public enum SalaryRate {JUNIOR, SENIOR, MANAGER, EXECUTIVE}
@Entity public class Employee {
…
public EmployeeStatus getStatus() {…}
@Enumerated(STRING)
public SalaryRate getPayScale() {…}
…
}
上面例子中,定義了兩個枚舉類型EmployeeStatus和SalaryRate。在實體兩個屬性status類型為EmployeeStatus,而payScale為SalaryRate類型。其中一個顯性給出了标記@Enumerated(STRING)來說明枚舉類型的值當成字元串使用,而預設的是從1開始的數字來辨別的。也可以通過标記@Enumerated(ORDINAL)訓示枚舉裡面類型的值是數字類型的。例如在EmployeeStatus
中的FULL_TIME, PART_TIME, CONTRACT分别代表的數字是1,2,3,4而SalaryRate
中的JUNIOR, SENIOR, MANAGER, EXECUTIVE代表的分别是字元串”JUNIOR”, “SENIOR”, “MANAGER”, “EXECUTIVE”。
[email protected]标記
當實體之間的關系是多對一的時候,該标記定義一個單值的字段與其它實體相關聯。其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface ManyToOne {
Class targetEntity() default void.class;
CascadeType[] cascade() default {};
FetchType fetch() default EAGER;
boolean optional() default true;
}
public enum CascadeType { ALL, PERSIST, MERGE, REMOVE, REFRESH};
targetEntity:表示相關聯的實體類。
Cascade:級聯操作選項,PERSIST, MERGE, REMOVE, REFRESH分别對應增加,更新,删除和查找的聯級設定選項。如果選擇ALL就使得前面這些聯級都生效,也就是cascade=ALL 等同于cascade={PERSIST, MERGE, REMOVE,REFRESH}
Fetch:制定關聯實體的加載方式,包括EAGER和LAZY兩種方式。當為EAGER選選項的時候,當查詢實體的時候會把它相關聯的實體執行個體也加載。當為LAZY的時候加載實體執行個體的時候與之相關聯的實體執行個體不會加載,預設為EAGER。
Optional:指定關聯實體關系是否可以為空,預設是為true。當為false的時候,那當有實體執行個體的存在總會有與之相關實體執行個體的存在。
例如:
@ManyToOne(optional=flase)
@JoinColumn(name=”CUST_ID”, nullable=false, updatable=false)
public Customer getCustomer() { return customer; }
[email protected]标記
标記定義實體一對一關系的聯系,通過一個字段來進行關聯。其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface OneToOne {
Class targetEntity() default void.class;
CascadeType[] cascade() default {};
FetchType fetch() default EAGER;
boolean optional() default true;
String mappedBy() default “”;
}
前面四個選項和8.2.13中的意義是一樣的。
mappedBy:代表這個屬性或域是關系的擁有者,也就是說mappedBy選擇應該是在非關系擁有者方才會出現。所謂關系的擁有者就是在表中包含了關系字段的那張表。
現在假設有實體Customer和實體CustomerRecoder它們之間是一對一的關系,同時實體Customer是關系的擁有者。這個時候通過标記@OneToOne來完成關聯,在實體Customer相關代碼如下:
@OneToOne(optional=false)
@JoinColumn(
name=”CUSTREC_ID”, unique=true, nullable=false, updatable=false)
public CustomerRecord getCustomerRecord() { return customerRecord; }
在實體CustomerRecord相關代碼如下:
@OneToOne(optional=false, mappedBy=”customerRecord”)
public Customer getCustomer() { return customer; }
因為CustomerRecord是關系的非擁有者所有mappedBy隻能在這邊出現。
[email protected]标記
用來标記實體之間的一對多的關系,其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface OneToMany {
Class targetEntity() default void.class;
CascadeType[] cascade() default {};
FetchType fetch() default LAZY;
String mappedBy() default “”;
}
值得注意的是表示關聯實體的集合要使用範形來制定集合内部的關聯實體,否則必須要指定targetEntity的實體類型。Fetch類型預設為LAZY而@OneToOne和ManyToOne則預設的為EAGER。
假設現在有實體Customer和Order它們之間的關系是一對多的關系,同時Order是關系的擁有者。
在實體Customer中的代碼為:
@OneToMany(cascade=ALL, mappedBy=”customer”)
public Set getOrders() { return orders; }
在實體Order中的代碼為:
@ManyToOne
@JoinColumn(name=”CUST_ID”, nullable=false)
public Customer getCustomer() { return customer; }
[email protected]标記
用來映射多對多和單項的一對多關系,當不是用該标記的時候會根據預設的映射原則産生關系連接配接表。其定義如下:
public @interface JoinTable {
String name() default “”;
String catalog() default “”;
String schema() default “”;
JoinColumn[] joinColumns() default {};
JoinColumn[] inverseJoinColumns() default {};
UniqueConstraint[] uniqueConstraints() default {};
}
Name:指定連接配接表的名字。
Catalog:指定表所屬的catalog。
Schema:指定表所屬的schema。
joinColumns:指定關系擁有方作為外鍵的主鍵。
inverseJoinColumns:指定關系非擁有方作為外鍵的主鍵。
uniqueConstraints:指定表中的唯一限制。
例如:
@JoinTable(
name=”CUST_PHONE”,
joinColumns=
@JoinColumn(name=”CUST_ID”, referencedColumnName=”ID”),
inverseJoinColumns=
@JoinColumn(name=”PHONE_ID”, referencedColumnName=”ID”)
)
上面例子,連接配接表的名字為CUST_PHONE裡面有兩個外鍵,一個來自關系擁有方的主鍵ID對應外鍵為CUST_ID;另一個是來自于關系的非擁有方的主鍵ID對應外鍵為PHONE_ID。
[email protected]标記
标記實體之間的多對多的關系,如果不通過範形來制定集合中的關聯實體類型那必須指定相應的關聯實體類型。其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface ManyToMany {
Class targetEntity() default void.class;
CascadeType[] cascade() default {};
FetchType fetch() default LAZY;
String mappedBy() default “”;
}
各個屬性的意義和标記@OneToMany是一樣的,請參照8.2.1.15。
如果關聯是雙向的兩邊都可以是關系的擁有方,可以通過标記@JoinTable來制定關系擁有方,請參照2.16。
設有實體Customer和PhoneNumber,則它們的關系映射代碼如下:
在實體Customer中為:
@ManyToMany
@JoinTable(name=”CUST_PHONES”)
public Set getPhones() { return phones; }
在實體PhoneNumber中為:
@ManyToMany(mappedBy=”phones”)
public Set getCustomers() { return customers; }
在實際開發中,對于多對多關系我們經常使用标記@JoinTable來制定關系的擁有方,則對于上面的映射為:
@ManyToMany
@JoinTable(
name=”CUST_PHONE”,
joinColumns=
@JoinColumn(name=”CUST_ID”, referencedColumnName=”ID”),
inverseJoinColumns=
@JoinColumn(name=”PHONE_ID”, referencedColumnName=”ID”)
)
public Set getPhones() { return phones; }
@ManyToMany(mappedBy=”phones”)
public Set getCustomers() { return customers; }
[email protected]标記
指定批量查詢執行個體執行個體的時候指定排序的屬性或域,其定義如下:
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface OrderBy {
String value() default “”;
}
對于使用該标記對應的字段必須是可以比較的,預設的使用的是ASC也可以根據需求改變成DESC。當沒有指定value的時候,那預設的就是對實體的主鍵進行排序,例如:
@Entity public class Course {
…
@ManyToMany
@OrderBy(“lastname ASC”)
public List getStudents() {…};
…
}
@Entity public class Student {
…
@ManyToMany(mappedBy=”students”)
@OrderBy // PK is assumed
public List getCourses() {…};
…
}
歡迎使用Markdown編輯器寫部落格
本Markdown編輯器使用StackEdit修改而來,用它寫部落格,将會帶來全新的體驗哦:
- Markdown和擴充Markdown簡潔的文法
- 代碼塊高亮
- 圖檔連結和圖檔上傳
- LaTex數學公式
- UML序列圖和流程圖
- 離線寫部落格
- 導入導出Markdown檔案
- 豐富的快捷鍵
快捷鍵
- 加粗
Ctrl + B
- 斜體
Ctrl + I
- 引用
Ctrl + Q
- 插傳入連結接
Ctrl + L
- 插入代碼
Ctrl + K
- 插入圖檔
Ctrl + G
- 提升标題
Ctrl + H
- 有序清單
Ctrl + O
- 無序清單
Ctrl + U
- 橫線
Ctrl + R
- 撤銷
Ctrl + Z
- 重做
Ctrl + Y
Markdown及擴充
Markdown 是一種輕量級标記語言,它允許人們使用易讀易寫的純文字格式編寫文檔,然後轉換成格式豐富的HTML頁面。 —— [ 維基百科 ]
使用簡單的符号辨別不同的标題,将某些文字标記為粗體或者斜體,建立一個連結等,詳細文法參考幫助?。
本編輯器支援 Markdown Extra , 擴充了很多好用的功能。具體請參考Github.
表格
Markdown Extra 表格文法:
項目 | 價格 |
---|---|
Computer | $1600 |
Phone | $12 |
Pipe | $1 |
可以使用冒号來定義對齊方式:
項目 | 價格 | 數量 |
---|---|---|
Computer | 1600 元 | 5 |
Phone | 12 元 | 12 |
Pipe | 1 元 | 234 |
定義清單
- Markdown Extra 定義清單文法: 項目1 項目2
- 定義 A
- 定義 B 項目3
- 定義 C
- 定義 D
定義D内容
代碼塊
代碼塊文法遵循标準markdown代碼,例如:
@requires_authorization
def somefunc(param1='', param2=):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + ) or None
class SomeClass:
pass
>>> message = '''interpreter
... prompt'''
腳注
生成一個腳注1.
目錄
用
[TOC]
來生成目錄:
- 歡迎使用Markdown編輯器寫部落格
- 快捷鍵
- Markdown及擴充
- 表格
- 定義清單
- 代碼塊
- 腳注
- 目錄
- 數學公式
- UML 圖
- 離線寫部落格
- 浏覽器相容
數學公式
使用MathJax渲染LaTex 數學公式,詳見math.stackexchange.com.
- 行内公式,數學公式為: Γ(n)=(n−1)!∀n∈N 。
- 塊級公式:
x=−b±b2−4ac−−−−−−−√2a
更多LaTex文法請參考 這兒.
UML 圖:
可以渲染序列圖:
或者流程圖:
- 關于 序列圖 文法,參考 這兒,
- 關于 流程圖 文法,參考 這兒.
離線寫部落格
即使使用者在沒有網絡的情況下,也可以通過本編輯器離線寫部落格(直接在曾經使用過的浏覽器中輸入write.blog.csdn.net/mdeditor即可。Markdown編輯器使用浏覽器離線存儲将内容儲存在本地。
使用者寫部落格的過程中,内容實時儲存在浏覽器緩存中,在使用者關閉浏覽器或者其它異常情況下,内容不會丢失。使用者再次打開浏覽器時,會顯示上次使用者正在編輯的沒有發表的内容。
部落格發表後,本地緩存将被删除。
使用者可以選擇 把正在寫的部落格儲存到伺服器草稿箱,即使換浏覽器或者清除緩存,内容也不會丢失。
注意:雖然浏覽器存儲大部分時候都比較可靠,但為了您的資料安全,在聯網後,請務必及時發表或者儲存到伺服器草稿箱。
浏覽器相容
- 目前,本編輯器對Chrome浏覽器支援最為完整。建議大家使用較新版本的Chrome。
- IE9以下不支援
- IE9,10,11存在以下問題
- 不支援離線功能
- IE9不支援檔案導入導出
- IE10不支援拖拽檔案導入
- 這裡是 腳注 的 内容. ↩