建站
咨詢
售后
建站咨詢
新聞中心
作為適合多平臺(tái)應(yīng)用的靜態(tài)編程語言，Kotlin比Java更簡潔、更有表現(xiàn)力、也更具有代碼的安全性。同時(shí)，Kotlin提供了與Java的無縫互操作性。也就是說，Java允許開發(fā)人員將他們的項(xiàng)目遷移到Kotlin處，而無需重寫整個(gè)代碼庫。當(dāng)然，針對(duì)此類遷移，我們可能需要在Kotlin應(yīng)用中使用JPA(Java Persistence API)。雖然許多開發(fā)者普遍認(rèn)為：沒有JPA，就不存在實(shí)體。但是他們?cè)贙otlin中定義JPA時(shí)，往往會(huì)遇到各種警告。下面，我們來一起討論：作為JPA的經(jīng)典實(shí)現(xiàn)—Hibernate，是如何避免各種常見的錯(cuò)誤，并充分利用Kotlin的。
JPA實(shí)體的各項(xiàng)規(guī)則
注意，此處的實(shí)體并非常規(guī)的數(shù)據(jù)傳輸對(duì)象(Data Transfer Object，DTO)。為了能夠順暢運(yùn)行，實(shí)體需要得到正確地定義。鏈接中詳細(xì)闡述了針對(duì)JPA的一系列規(guī)范和限制。其中最重要的是如下兩項(xiàng)：
- 實(shí)體類雖然可以擁有其他構(gòu)造函數(shù)，但是必須具有一個(gè)無參數(shù)(no-arg)的構(gòu)造函數(shù)。而且這個(gè)無參數(shù)構(gòu)造函數(shù)必須是公共的(public)或受保護(hù)的(protected)。
- 實(shí)體類的任何方法、或持久性實(shí)例變量，都不能為final類型。
上述規(guī)范足以讓實(shí)體類運(yùn)行起來。不過為了使之更流暢地運(yùn)行，我們需要附加如下兩條規(guī)則：
- 只有在明確的請(qǐng)求時(shí)，所有Lasy關(guān)聯(lián)才能被加載。否則，我們可能會(huì)遇到LazyInitializationException、或各種意外的性能問題。
- equals()和hashCode()的實(shí)現(xiàn)，必須考慮到實(shí)體的可變特性。
無參數(shù)的構(gòu)造函數(shù)
主構(gòu)造函數(shù)(Primary constructors)是Kotlin最受歡迎的特性之一。然而，主構(gòu)造函數(shù)在被加入的同時(shí)，替換了原有的默認(rèn)函數(shù)。因此，如果您在Hibernate中使用它，則可能會(huì)碰到諸如：org.hibernate.InstantiationException: No default constructor for entity的異常。
那么為了解決此問題，您可以在所有實(shí)體中，手動(dòng)定義無參數(shù)的構(gòu)造函數(shù)。同時(shí)，您最好使用kotlin-jpa編譯器插件，來確保在字節(jié)碼中，為每個(gè)JPA定義相關(guān)的類，如：@Entity、@MappedSuperclass或@Embeddable，生成無參數(shù)的構(gòu)造函數(shù)。
若想啟用該插件，您只需將其添加到kotlin-maven-plugin和compilerPlugins的依賴關(guān)系中即可，請(qǐng)參見如下代碼段：
org.jetbrains.kotlin kotlin-maven-plugin - ...
jpa - ...
- ...
org.jetbrains.kotlin kotlin-maven-noarg ${kotlin.version} - ...
與之對(duì)應(yīng)的在Gradle(譯者注：一個(gè)基于Apache Ant和Apache Maven概念的項(xiàng)目自動(dòng)化構(gòu)建開源工具)中的代碼段為：
- buildscript {
- dependencies {
- classpath "org.jetbrains.kotlin:kotlin-noarg:$kotlin_version"
- }
- }
- apply plugin: "kotlin-jpa"
打開各種類和屬性
根據(jù)JPA規(guī)范，所有與JPA相關(guān)的類和屬性都必須是open的。不過，某些JPA提供程序可能不會(huì)強(qiáng)制執(zhí)行該規(guī)范。例如，Hibernate在遇到最終實(shí)體類時(shí)，是不會(huì)拋出異常的。然而，由于final類無法被子類化(subclassed)，因此Hibernate的代理機(jī)制會(huì)就此關(guān)閉。而沒有了代理，又何談lazy加載呢?而且，由于程序急需獲取所有的ToOne關(guān)聯(lián)，因此它很可能會(huì)導(dǎo)致嚴(yán)重的性能問題。
不過，對(duì)于使用靜態(tài)編織(static weaving)的EclipseLink而言，情況則不同，畢竟它的lazy加載機(jī)制并不會(huì)用到子類化。
如下代碼段所示，與Java不同的是，在Kotlin中，所有的類、屬性、以及方法，默認(rèn)都是final類型的。您必須將它們明確地標(biāo)記為open：
- @Table(name = "project")
- @Entity
- open class Project {
- @Id
- @GeneratedValue(strategy = GenerationType.IDENTITY)
- @Column(name = "id", nullable = false)
- open var id: Long? = null
- @Column(name = "name", nullable = false)
- open var name: String? = null
- ...
- }
或者如下面的代碼段所示，您最好使用全開放(all-open)式的編譯器插件(https://kotlinlang.org/docs/all-open-plugin.html)，來默認(rèn)開啟所有與JPA相關(guān)的類和屬性。通過正確的配置，它能夠適用于所有被注釋為@Entity、 @MappedSuperclass、以及@Embeddable的類：
org.jetbrains.kotlin kotlin-maven-plugin - ...
all-open org.jetbrains.kotlin kotlin-maven-allopen ${kotlin.version}
與之對(duì)應(yīng)的在Gradle中的代碼段為：
- buildscript {
- dependencies {
- classpath "org.jetbrains.kotlin:kotlin-allopen:$kotlin_version"
- }
- }
- apply plugin: "kotlin-allopen"
- allOpen {
- annotations("javax.persistence.Entity", "javax.persistence.MappedSuperclass", "javax.persistence.Embedabble")
- }
針對(duì)JPA實(shí)體使用各種數(shù)據(jù)類
數(shù)據(jù)類(Data classes)是專為DTO設(shè)計(jì)的一項(xiàng)超棒的Kotlin功能。它被默認(rèn)設(shè)計(jì)、并配備了各種非常實(shí)用的針對(duì)equals()、hashCode()、以及toString()的實(shí)現(xiàn)。不過，此類實(shí)現(xiàn)并不太適合JPA實(shí)體。其原因在于，雖然數(shù)據(jù)類被設(shè)計(jì)為final類，但是它不能夠像Kotlin那樣被標(biāo)記為open。因此，為了適用于實(shí)體，而將它們標(biāo)記為open的唯一方法便是，啟用全開放式的編譯器插件。
如下代碼段所示，我們將使用以下實(shí)體，來進(jìn)一步檢查數(shù)據(jù)類。它帶有一個(gè)已生成的id、一個(gè)name屬性、以及兩個(gè)lazy的OneToMany關(guān)聯(lián)：
- @Table(name = "client")
- @Entity
- data class Client(
- @Id
- @GeneratedValue(strategy = GenerationType.IDENTITY)
- @Column(name = "id", nullable = false)
- var id: Long? = null,
- @Column(name = "name", nullable = false)
- var name: String? = null,
- @OneToMany(mappedBy = "client", orphanRemoval = true)
- var projects: MutableSet
= mutableSetOf(), - @JoinColumn(name = "client_id")
- @OneToMany
- var contacts: MutableSet
= mutableSetOf(), - )
意外獲取LAZY關(guān)聯(lián)
默認(rèn)情況下，所有ToMany關(guān)聯(lián)都是lazy的，其原因在于：非必要地加載它們，往往很容易會(huì)影響到程序性能。例如，equals()、hashCode()、以及toString()在實(shí)現(xiàn)的過程中，通常會(huì)用到包括lazy在內(nèi)的所有屬性。因此，調(diào)用它們會(huì)導(dǎo)致向數(shù)據(jù)庫產(chǎn)生不需要的請(qǐng)求、以及出現(xiàn)LazyInitializationException。而且，數(shù)據(jù)類的默認(rèn)行為是：在其方法中，使用來自主構(gòu)造函數(shù)的所有字段。
在此，我們可以使用IDE來生成toString()，以通過簡單的覆蓋方式，排除所有的LAZY字段。如下代碼段所示，由于JPA Buddy有著自己的toString()產(chǎn)生機(jī)制，因此它完全不會(huì)提供LAZY字段。
- @Override
- override fun toString(): String {
- return this::class.simpleName + "(id = $id , name = $name )"
- }
當(dāng)然，僅從equals()和hashCode()中排除LAZY字段是遠(yuǎn)遠(yuǎn)不夠的，畢竟它們可能仍然包含著可變的屬性。
Equals()和HashCode()的問題
由于JPA實(shí)體在本質(zhì)上是可變的，因此為其實(shí)現(xiàn)equals()和hashCode()，并不像常規(guī)的DTO那么簡單。某些實(shí)體的id甚至都是由數(shù)據(jù)庫所生成的，因此id會(huì)在實(shí)體首次被持久化后發(fā)生變化。這就意味著我們將沒有可依賴的字段，去計(jì)算hashCode。
下面，讓我們對(duì)Client實(shí)體進(jìn)行一個(gè)簡單的測(cè)試。
- val awesomeClient = Client(name = "Awesome client")
- val hashSet = hashSetOf(awesomeClient)
- clientRepository.save(awesomeClient)
- assertTrue(awesomeClient in hashSet)
如上面的代碼段所說，即便該實(shí)體被添加到前面幾行的集合中，它的最后一行斷言也會(huì)出現(xiàn)錯(cuò)誤。畢竟，id在被首次生成時(shí)，hashCode就會(huì)發(fā)生改變。這就導(dǎo)致了HashSet在不同的存儲(chǔ)桶中是無法查找到該實(shí)體的?？梢?，如果id是在實(shí)體對(duì)象的創(chuàng)建期間被設(shè)置的(例如，是由應(yīng)用程序設(shè)置的UUID)，那么就不會(huì)出現(xiàn)問題;而如果是由數(shù)據(jù)庫生成的id(其實(shí)更為常見)，就會(huì)出現(xiàn)上述問題。
對(duì)此，我們可以在使用實(shí)體的數(shù)據(jù)類時(shí)，持續(xù)性地覆蓋equals()和hashCode()。如果您想詳細(xì)地了解具體使用方法，請(qǐng)參見--https://vladmihalcea.com/the-best-way-to-implement-equals-hashcode-and-tostring-with-jpa-and-hibernate/。其中，對(duì)于Client實(shí)體而言，其對(duì)應(yīng)的代碼段為：
- override fun equals(other: Any?): Boolean {
- if (this === other) return true
- if (other == null ||Hibernate.getClass(this) !=Hibernate.getClass(other)) return false
- other as Client
- return id != null && id == other.id
- }
- override fun hashCode(): Int = 1756406093
使用由應(yīng)用程序設(shè)置的ID
其實(shí)，數(shù)據(jù)類的各種方法主要是由主構(gòu)造函數(shù)中那些指定的字段所生成的。如果只包含了eager immutable字段，那么數(shù)據(jù)類就不會(huì)存在上述問題。如下代碼段展示了由應(yīng)用程序設(shè)置的不可變id的字段：
- @Table(name = "contact")
- @Entity
- data class Contact(
- @Id
- @Column(name = "id", nullable = false)
- val id: UUID,
- ) {
- @Column(name = "email", nullable = false)
- val email: String? = null
- // other properties omitted
- }
如果您更喜歡使用由數(shù)據(jù)庫來生成id的話，則可以參照如下代碼段，以實(shí)現(xiàn)在構(gòu)造函數(shù)中使用不可變的自然id：
- @Table(name = "contact")
- @Entity
- data class Contact(
- @NaturalId
- @Column(name = "email", nullable = false, updatable = false)
- val email: String
- ) {
- @Id
- @GeneratedValue(strategy = GenerationType.IDENTITY)
- @Column(name = "id", nullable = false)
- var id: Long? = null
- // other properties omitted
- }
雖然您可以放心地使用上述方法，但是它幾乎違背了使用數(shù)據(jù)類的初衷。畢竟，該用法不但讓分解(decomposition)變得無效，而且讓toString()對(duì)于實(shí)體而言，還不如直接使用普通的舊類。
空指針安全性(null-safety)
Kotlin相對(duì)于Java的一項(xiàng)優(yōu)勢(shì)便是，內(nèi)置有空指針安全性的功能。我們可以通過非空約束(non-null constraints)在數(shù)據(jù)庫端確?？罩羔樀陌踩?。其最簡單的實(shí)現(xiàn)方法為，在主構(gòu)造函數(shù)中使用非空類型，來定義各種非空的屬性(請(qǐng)參考如下代碼段)：
- @Table(name= "contact")
- @Entity
- class Contact(
- @NaturalId
- @Column(name = "email", nullable = false, updatable = false)
- val email: String,
- @Column(name = "name", nullable = false)
- var name: String
- @ManyToOne(fetch = FetchType.LAZY, optional = false)
- @JoinColumn(name = "client_id", nullable = false)
- var client: Client
- ) {
- // id and other properties omitted
- }
當(dāng)然，如果您需要從構(gòu)造函數(shù)中(例如：在數(shù)據(jù)類中)排除它們，則可以提供默認(rèn)值，或?qū)ateinit的修飾符添加到其屬性之中(請(qǐng)參考如下代碼段)：
- @Entity
- data class Contact(
- @NaturalId
- @Column(name = "email", nullable = false, updatable = false)
- val email: String,
- ) {
- @Column(name = "name", nullable = false)
- var name: String = ""
- @ManyToOne(fetch = FetchType.LAZY, optional = false)
- @JoinColumn(name = "client_id", nullable = false)
- lateinit var client: Client
- // id and other properties omitted
- }
據(jù)此，如果該屬性在數(shù)據(jù)庫中被確認(rèn)為非空，那么我們便可以省略在Kotlin代碼中，對(duì)于所有空值的檢查。
小結(jié)
讓我們通過如下列表，一起來總結(jié)一下如何在Kotlin中定義JPA實(shí)體：
- 請(qǐng)將所有與JPA相關(guān)的類、及其屬性標(biāo)記為open，以避免出現(xiàn)顯著的性能問題。
- 為ManytoOne和OnetoOne關(guān)聯(lián)開啟lazy加載，或者將全開放式的編譯器插件，應(yīng)用到所有被注釋為@Entity、@MappedSuperclass、以及@Embeddable的類。
- 為了避免出現(xiàn)InstantiationException，請(qǐng)?jiān)谒信cJPA相關(guān)的類中，定義無參數(shù)的構(gòu)造函數(shù)，或使用kotlin-jpa編譯器插件。
- 通過啟用全開放式的插件，在已編譯的字節(jié)碼中創(chuàng)建數(shù)據(jù)類，并使之具有open屬性。
- 覆蓋equals()、hashCode()、以及toString()。
- 讓JPA Buddy生成諸如：equals()、hashCode()、以及toString()等有效的實(shí)體。
此外，如果您想深入研究此類實(shí)踐，請(qǐng)通過鏈接，參考我們?cè)贕itHub存儲(chǔ)庫中為您準(zhǔn)備的帶有測(cè)試的示例。
當(dāng)前標(biāo)題：使用帶有Kotlin的JPA(Hibernate)的優(yōu)秀實(shí)踐
網(wǎng)站網(wǎng)址：http://www.5511xx.com/article/codsshg.html
