hypersistence utils

กำลังย้ายไปยังเวอร์ชัน 3

ชื่อโปรเจ็กต์เปลี่ยนจาก Hibernate Types เป็น Hypersistence Utils เนื่องจากขอบเขตของโปรเจ็กต์กว้างขึ้นมากในขณะนี้ โดยนำเสนอยูทิลิตี้ Spring ด้วยเช่นกัน

ด้วยเหตุนี้ เมื่อย้ายจาก Hibernate Types 2.x ไปเป็น Hypersistence Utils 3.x คุณจะต้องทำตามขั้นตอนเหล่านี้:

1. ขั้นแรก คุณจะต้องเปลี่ยนการพึ่งพา Maven หรือ Gradle ดังที่แสดงในคู่มือการติดตั้ง
2. ประการที่สอง คุณจะต้องเปลี่ยนชื่อแพ็กเกจจาก com.vladmihalcea.hibernate เป็น io.hypersistence.utils.hibernate
3. ประการที่สาม คุณจะต้องเปลี่ยนชื่อแพ็กเกจจาก com.vladmihalcea.spring เป็น io.hypersistence.utils.spring

แค่นั้นแหละ!

การแนะนำ

โครงการ Hypersistence Utils มอบยูทิลิตี้อเนกประสงค์สำหรับทั้ง Spring และ Hibernate

ข้อได้เปรียบหลักของโปรเจ็กต์นี้คือ รองรับเวอร์ชัน Hibernate ที่หลากหลาย ครอบคลุมตั้งแต่ Hibernate ORM 6.6 , 6.5 , 6.4 , 6.3 ถึง 6.2 , 6.1 , 6.0 , 5.6 และ Hibernate 5.5

คู่มือการติดตั้ง

ขึ้นอยู่กับเวอร์ชัน Hibernate ที่คุณใช้ คุณต้องเพิ่มการขึ้นต่อกันต่อไปนี้:

ไฮเบอร์เนต 6.6, 6.5, 6.4 และ 6.3

 <dependency>
    <groupId>io.hypersistence</groupId>
    <artifactId>hypersistence-utils-hibernate-63</artifactId>
    <version>3.9.0</version>
</dependency>

ไฮเบอร์เนต 6.2

 <dependency>
    <groupId>io.hypersistence</groupId>
    <artifactId>hypersistence-utils-hibernate-62</artifactId>
    <version>3.9.0</version>
</dependency>

ไฮเบอร์เนต 6.1 และ 6.0

 <dependency>
    <groupId>io.hypersistence</groupId>
    <artifactId>hypersistence-utils-hibernate-60</artifactId>
    <version>3.9.0</version>
</dependency>

ไฮเบอร์เนต 5.6 และ 5.5

 <dependency>
    <groupId>io.hypersistence</groupId>
    <artifactId>hypersistence-utils-hibernate-55</artifactId>
    <version>3.9.0</version>
</dependency>

การพึ่งพา Maven ทางเลือก

โปรเจ็กต์ Hypersistence Utils กำหนดรายการการขึ้นต่อกันที่เป็นตัวเลือกที่คุณจะต้องประกาศอย่างชัดเจนในโปรเจ็กต์ของคุณเพื่อใช้งาน

เหตุผลที่การขึ้นต่อกันเหล่านี้เป็นทางเลือก เช่น Guava, Jackson หรือ PostgreSQL JDBC Driver ก็คือไม่ใช่ทุกโปรเจ็กต์อาจจำเป็นต้องใช้

นอกจากนี้ เวอร์ชันที่ขึ้นต่อกันมีความสำคัญอย่างยิ่ง เนื่องจากในบางครั้งอาจพบปัญหาด้านความปลอดภัยที่ได้รับการแก้ไขในเวอร์ชันที่ใหม่กว่า

ดังนั้นการใช้ไลบรารี่นี้ในการจัดหาเวอร์ชันที่ต้องพึ่งพาให้กับคุณจึงเป็นสิ่งที่อันตรายมาก

ตัวอย่างเช่น มีปัญหาด้านความปลอดภัย 65 รายการที่พบในไลบรารี Jackson Data Bind ที่โปรเจ็กต์นี้ต้องพึ่งพาอย่างมาก

เพื่อหลีกเลี่ยงปัญหาด้านความปลอดภัยที่เสี่ยง คุณต้องรับผิดชอบในการอัพเกรดการขึ้นต่อกันทั้งหมดที่คุณใช้ร่วมกับไลบรารี Hypersistence Utils อย่างต่อเนื่อง

การพึ่งพา Maven เสริมของ JSON

หากคุณใช้ประเภท JSON คุณอาจสนใจตั้งค่าการขึ้นต่อกันต่อไปนี้ตามเวอร์ชัน Hibernate ของคุณ:

ไฮเบอร์เนต 6

< dependency >
    < groupId >com.fasterxml.jackson.module</ groupId >
    < artifactId >jackson-module-jakarta-xmlbind-annotations</ artifactId >
    < version >${jackson-module-jakarta-xmlbind-annotation}</ version >
</ dependency >

ไฮเบอร์เนต 5

< dependency >
    < groupId >com.fasterxml.jackson.core</ groupId >
    < artifactId >jackson-databind</ artifactId >
    < version >${jackson-databind.version}</ version >
</ dependency >

< dependency >
    < groupId >com.fasterxml.jackson.module</ groupId >
    < artifactId >jackson-module-jaxb-annotations</ artifactId >
    < version >${jackson-module-jaxb-annotation}</ version >
</ dependency >

การพึ่งพา Maven เสริมของฝรั่ง

หากคุณกำลังแมป Range โดยใช้ Guava คุณจะต้องระบุการพึ่งพา Guava อย่างชัดเจน:

< dependency >
    < groupId >com.google.guava</ groupId >
    < artifactId >guava</ artifactId >
    < version >${guava.version}</ version >
</ dependency >

Java Money และสกุลเงิน API ตัวเลือกการพึ่งพา Maven

หากคุณกำลังแมป MonetaryAmount คุณต้องระบุการขึ้นต่อกันของ Moneta อย่างชัดเจน:

< dependency >
    < groupId >org.javamoney</ groupId >
    < artifactId >moneta</ artifactId >
    < version >${moneta.version}</ version >
    < type >pom</ type >
</ dependency >

การพึ่งพา Maven เสริมของ PostgreSQL

หากคุณกำลังแมปประเภทคอลัมน์เฉพาะของ PostgreSQL (เช่น inet , hstore , array , interval ) คุณจะต้องระบุการพึ่งพา PostgreSQL อย่างชัดเจน:

< dependency >
    < groupId >org.postgresql</ groupId >
    < artifactId >postgresql</ artifactId >
    < version >${postgresql.version}</ version >
</ dependency >

คุณสมบัติ

เจสัน

ประเภท JSON ทั่วไป

JsonType ช่วยให้คุณจับคู่ประเภทคอลัมน์ JSON ได้ ไม่ว่าคุณจะใช้ Oracle, SQL Server, PostgreSQL หรือ MySQL ก็ตาม

ไฮเบอร์เนต 6

หากคุณใช้ Hibernate 6 คุณสามารถแมปคอลัมน์ JSON ใดๆ กับคุณสมบัติเอนทิตี Map , List , POJO, String หรือ JsonNode ได้:

 @ Type ( JsonType . class )
private Map < String , String > properties = new HashMap <>();

ไฮเบอร์เนต 5

หากคุณใช้ Hibernate 5 คุณสามารถระบุชื่อประเภท Hibernate ที่มีคุณสมบัติครบถ้วนได้:

 @Type(type = "io.hypersistence.utils.hibernate.type.json.JsonType")

หรือคุณสามารถเพิ่มการแม็พต่อไปนี้ให้กับคลาส package-info.java ของคุณในแพ็คเกจเดียวกันกับที่เอนทิตี JPA ของคุณอยู่:

 @ TypeDef (
    name = "json" , typeClass = JsonType . class
)
package io . hypersistence . optimizer ;

import io . hypersistence . utils . hibernate . type . json . JsonType ;
import org . hibernate . annotations . TypeDef ;

หลังจากนั้น คุณสามารถแมปคุณสมบัติเอนทิตี Map , List , POJO, String หรือ JsonNode กับคอลัมน์ JSON ได้ดังนี้:

 @ Type ( type = "json" )
private Map < String , String > properties = new HashMap <>();

สำหรับรายละเอียดเพิ่มเติม โปรดดูบทความนี้

แนวทางปฏิบัติที่ดีที่สุด

เมื่อแมปประเภทคอลัมน์ JSON กับ POJO , List<POJO> หรือ Map<String, POJO> คุณต้องแน่ใจว่าประเภท POJO จะแทนที่วิธี equals และ hashCode เริ่มต้น และนำไปใช้ตามเนื้อหาออบเจ็กต์ JSON

มิฉะนั้น กลไกการตรวจสอบสกปรกของไฮเบอร์เนตอาจทำให้เกิดคำสั่ง UPDATE ที่ไม่คาดคิด ตรวจสอบฉบับ #134 สำหรับรายละเอียดเพิ่มเติม

ประเภท JSON เฉพาะฐานข้อมูล

ออราเคิล

เมื่อใช้ Oracle คุณมีหลายตัวเลือก:

• คุณสามารถใช้ JsonType ทั่วไปที่สามารถทำงานกับประเภทคอลัมน์ JSON , VARCHAR หรือ BLOB ได้ ตราบใดที่คุณบอกใบ้ประเภทคอลัมน์โดยใช้แอตทริบิวต์ columnDefinition ของคำอธิบายประกอบ JPA @Column
• คุณสามารถใช้ JsonStringType เพื่อแมปประเภทคอลัมน์ VARCHAR2 ที่จัดเก็บ JSON
• คุณสามารถใช้ JsonBlobType เพื่อแมปประเภทคอลัมน์ BLOB ที่จัดเก็บ JSON

สำหรับรายละเอียดเพิ่มเติม โปรดดูบทความนี้

เซิร์ฟเวอร์ SQL

เมื่อใช้ SQL Server คุณสามารถใช้ JsonType ทั่วไปหรือ JsonStringType เพื่อแมปประเภทคอลัมน์ NVARCHAR ที่จัดเก็บ JSON

สำหรับรายละเอียดเพิ่มเติม โปรดดูบทความนี้

PostgreSQL

เมื่อใช้ PostgreSQL คุณสามารถใช้ JsonType ทั่วไปหรือ JsonBinaryType เพื่อแมปทั้งประเภทคอลัมน์ jsonb และ json

สำหรับรายละเอียดเพิ่มเติม โปรดดูบทความนี้

MySQL

เมื่อใช้ MySQL คุณสามารถใช้ JsonType ทั่วไปหรือ JsonStringType เพื่อแมปประเภทคอลัมน์ json

สำหรับรายละเอียดเพิ่มเติม โปรดดูบทความนี้

ตัวอย่างการแมป JSON

• วิธีแมป POJO กับคอลัมน์ JSON โดยใช้ JPA และ Hibernate
• วิธีแมปคุณสมบัติ String JPA กับคอลัมน์ JSON โดยใช้ Hibernate
• วิธีแมป Jackson JsonNode กับคอลัมน์ JSON
• วิธีแมปคอลเลกชัน JSON โดยใช้ JPA และ Hibernate
• วิธีแมปคุณสมบัติเอนทิตี Java Map เป็นคอลัมน์ JSON ด้วย JPA และ Hibernate
• วิธีแมป Java Records กับคอลัมน์ JSON โดยใช้ Hibernate
• วิธีแมปวัตถุ polymorphic JSON ด้วย JPA และ Hibernate
• วิธีเข้ารหัสและถอดรหัสคุณสมบัติ JSON ด้วย JPA และ Hibernate
• เหตุใดคุณจึงควรใช้ Hibernate Dynamic Update สำหรับคุณสมบัติ JSON
• วิธีแมปคอลัมน์ Oracle JSON โดยใช้ JPA และ Hibernate
• วิธีแมปคอลัมน์ SQL Server JSON โดยใช้ JPA และ Hibernate
• วิธีปรับแต่ง Jackson ObjectMapper ที่ใช้โดย Hypersistence Utils
• วิธีปรับแต่ง JSON Serializer ที่ใช้โดย Hypersistence Utils
• วิธีแก้ไข No Dialect mapping for JDBC type: 1111 เมื่อผสมประเภท JSON กับแบบสอบถาม SQL ดั้งเดิม
• วิธีแก้ไข column is of type jsonb but expression is of type record หรือปัญหา bytea

อาเรย์

• วิธีแมป PostgreSQL ARRAY กับ List Java ด้วย JPA และ Hibernate
• วิธีแมป PostgreSQL ARRAY กับ Java Arrays ด้วย JPA และ Hibernate
• การแมปอาร์เรย์หลายมิติด้วย JPA และ Hibernate
• วิธีแมปประเภท HSQLDB ARRAY กับ JPA และ Hibernate

ประเภท PostgreSQL (เช่น ENUM, INET, HSTORE, RANGE)

• ประเภท Java Enum ถึง PostgreSQL Enum
• วิธีแมปประเภท PostgreSQL Inet กับ JPA และ Hibernate
• วิธีแมปคุณสมบัติเอนทิตี PostgreSQL HStore กับ JPA และ Hibernate
• วิธีแมป PostgreSQL Enum ARRAY กับคุณสมบัติเอนทิตี JPA โดยใช้ Hibernate
• วิธีแมปประเภทคอลัมน์ PostgreSQL Range ด้วย JPA และ Hibernate
• วิธีแมปช่วงเวลา PostgreSQL กับ Java Duration ด้วย Hibernate

ประเภททั่วไป

• วิธีที่ดีที่สุดในการแมป MonetaryAmount กับ JPA และ Hibernate
• วิธีแมปคอลัมน์ java.time.YearMonth ถึง DATE หรือ INTEGER
• วิธีแมป java.time.Year และ java.time.Month ด้วย JPA และ Hibernate
• Character เป็นคอลัมน์ CHAR ที่เป็นโมฆะ
• ยูทิลิตี้ ImmutableType เพื่อลดความซับซ้อนในการใช้งาน UserType

สาธารณูปโภค

ฤดูใบไม้ผลิ

• BaseJpaRepository ที่ยอดเยี่ยม
• Spring Data JpaRepository ที่ดีที่สุด
• ข้อมูลสปริง findAll รูปแบบต่อต้านทั้งหมด
• คำอธิบายประกอบ Spring @Retry เพื่อลองอีกครั้งโดยอัตโนมัติเมื่อเกิดความล้มเหลว

BaseJpaRepository

BaseJpaRepository เป็นทางเลือกที่ดีกว่ามากสำหรับ Spring Data JpaRepository เริ่มต้น เนื่องจากไม่มีเมธอด findAll หรือเมธอด save ที่ไม่สมเหตุสมผลในคำศัพท์ของ JPA

หากต้องการใช้ยูทิลิตี BaseJpaRepository ตรวจสอบให้แน่ใจว่าคุณได้ระบุแอ็ตทริบิวต์ repositoryBaseClass ในคอนฟิกูเรชัน @EnableJpaRepositories เพื่ออ้างอิง BaseJpaRepositoryImpl จากโปรเจ็กต์ Hypersistence Utils:

 @ Configuration
@ EnableJpaRepositories (
    value = "your.repository.package" ,
    repositoryBaseClass = BaseJpaRepositoryImpl . class
)
public class JpaConfiguration {
    ...
}

your.repository.package เป็นแพ็คเกจ Java ของที่เก็บ Spring ของคุณ

พื้นที่เก็บข้อมูลไฮเบอร์เนต

แม้ว่า BaseJpaRepository จะเป็นที่ต้องการ แต่ในกรณีที่คุณต้องการใช้ JpaRepository เริ่มต้น อย่างน้อยคุณก็สามารถขยาย HibernateRepository ได้เช่นกันเพื่อเลิกใช้วิธีการที่อาจทำให้เกิดปัญหาได้

หากต้องการใช้ HibernateRepository ให้แน่ใจว่าคุณรวมแพ็คเกจ io.hypersistence.utils.spring.repository ในการกำหนดค่า @EnableJpaRepositories ของคุณ:

 @ Configuration
@ EnableJpaRepositories (
    value = {
        "io.hypersistence.utils.spring.repository" ,
        "your.repository.package" ,
        ...
    }
)
public class JpaConfiguration {
    ...
}

your.repository.package เป็นแพ็คเกจ Java ของที่เก็บ Spring ของคุณ

เครื่องกำเนิดไฟฟ้าระบุ

• BatchSequenceGenerator - ตัวสร้างลำดับชุดไฮเบอร์เนต

กลยุทธ์การตั้งชื่อ

• CamelCaseToSnakeCaseNamingStrategy - วิธีแมปคุณสมบัติ CamelCase กับชื่อคอลัมน์ Snake_case ด้วย Hibernate

การฉายภาพ DTO และผลลัพธ์ Transformer

• ClassImportIntegrator - วิธีเขียนแบบสอบถามการฉายภาพ DTO แบบกะทัดรัดด้วย JPA
• ListResultTransformer - วิธีที่ดีที่สุดในการใช้ Hibernate ResultTransformer
• MapResultTransformer - วิธีส่งคืนผลลัพธ์แผนที่จากแบบสอบถาม JPA หรือ Hibernate

เครื่องมือตรวจสอบการนับคำสั่ง SQL

• SQLStatementCountValidator - วิธีตรวจสอบปัญหาแบบสอบถาม Hibernate N+1 ในระหว่างการทดสอบ

ยูทิลิตี้แบบสอบถาม

• SQLExtract - วิธีรับแบบสอบถาม SQL จาก JPQL หรือ JPA Criteria
• QueryStackTraceLogger - วิธีค้นหาแหล่งที่มาของการสืบค้น SQL ที่สร้างโดย Hibernate

ความต้องการ

• เวอร์ชัน Java รองรับโดยเวอร์ชัน Hibernate ORM ที่คุณใช้
• SLF4J
• แจ็คสัน ดาต้าบินด์

การแก้ไขข้อบกพร่องและการปรับปรุง

โปรเจ็กต์นี้ฟรี เช่นเดียวกับใน Libre ไม่ใช่แบบฟรี

ไม่มีการสนับสนุนฟรี เฉพาะซอร์สโค้ดและไบนารีเท่านั้นที่สามารถใช้งานได้ฟรี

หากคุณต้องการความช่วยเหลือเกี่ยวกับปัญหาที่กำหนด คุณจะต้องซื้อโปรแกรม Coaching Basic หรือ Coaching Pro

จัดให้มีการแก้ไขของคุณเอง

นอกจากตัวเลือกการสนับสนุนแบบชำระเงินแล้ว คุณยังมีตัวเลือกในการแก้ไขด้วยตนเองอีกด้วย ต่อไปนี้คือสิ่งที่คุณต้องทำ:

1. จัดทำกรณีทดสอบการจำลองโดยใช้กรณีทดสอบที่มีอยู่เป็นเทมเพลต
2. เสนอข้อเสนอการแก้ไข
3. ส่งคำขอดึงพร้อมกับข้อเสนอการแก้ไขและกรณีทดสอบ

อย่างไรก็ตาม เนื่องจากไม่มีเวลา ฉันจะตรวจสอบคำขอดึงที่ส่งมาเป็นครั้งคราว ดังนั้นคุณอาจต้องรอหลายเดือนจนกว่าคำขอดึงจะได้รับการตรวจสอบและรวมเข้าด้วยกัน

คุณกำลังดิ้นรนกับปัญหาประสิทธิภาพของแอปพลิเคชันหรือไม่?

ลองนึกภาพการมีเครื่องมือที่สามารถตรวจจับได้โดยอัตโนมัติว่าคุณใช้ JPA และ Hibernate อย่างถูกต้องหรือไม่ ไม่มีปัญหาด้านประสิทธิภาพอีกต่อไป ไม่ต้องเสียเวลานับไม่ถ้วนในการพยายามคิดว่าเหตุใดแอปพลิเคชันของคุณจึงแทบไม่มีการรวบรวมข้อมูลอีกต่อไป

ลองนึกภาพการค้นพบตั้งแต่เนิ่นๆ ในระหว่างวงจรการพัฒนาว่าคุณกำลังใช้การแมปที่ต่ำกว่าปกติและความสัมพันธ์ของเอนทิตี หรือว่าคุณพลาดการตั้งค่าที่เกี่ยวข้องกับประสิทธิภาพ

ยิ่งไปกว่านั้น ด้วย Hypersistence Optimizer คุณสามารถตรวจพบปัญหาดังกล่าวทั้งหมดในระหว่างการทดสอบ และตรวจสอบให้แน่ใจว่าคุณไม่ได้ปรับใช้การเปลี่ยนแปลงที่จะส่งผลต่อประสิทธิภาพของชั้นการเข้าถึงข้อมูลในการผลิต

Hypersistence Optimizer เป็นเครื่องมือที่คุณรอคอยมานาน!

การฝึกอบรม

หากคุณสนใจการฝึกอบรมนอกสถานที่ ฉันสามารถเสนอการฝึกอบรม Java Persistence ประสิทธิภาพสูง ซึ่งสามารถปรับให้เข้ากับเซสชันหนึ่ง สอง หรือสามวันได้ สำหรับรายละเอียดเพิ่มเติม โปรดดูที่เว็บไซต์ของฉัน

การให้คำปรึกษา

หากคุณต้องการให้ฉันตรวจสอบใบสมัครของคุณและให้ข้อมูลเชิงลึกเกี่ยวกับวิธีเพิ่มประสิทธิภาพเพื่อให้ทำงานเร็วขึ้น โปรดดูหน้าให้คำปรึกษาของฉัน

หลักสูตรวิดีโอ Java Persistence ประสิทธิภาพสูง

หากคุณต้องการวิธีที่เร็วที่สุดในการเรียนรู้วิธีเพิ่มความเร็วแอปพลิเคชันฐานข้อมูล Java คุณควรลงทะเบียนในหลักสูตรวิดีโอ Java Persistence ประสิทธิภาพสูงของฉันอย่างแน่นอน

หนังสือคงอยู่ Java ประสิทธิภาพสูง

หรือหากคุณชอบอ่านหนังสือ คุณจะต้องชอบหนังสือ High-Performance Java Persistence ของฉันด้วยเช่นกัน

คู่มือการมีส่วนร่วม

โปรเจ็กต์ใช้ Maven Toolchains เนื่องจากโมดูลต่างๆ ได้รับการคอมไพล์และทดสอบโดยใช้ Java เวอร์ชันต่างๆ

Hypersistence Utils 6 ต้องการ Java 11 ในขณะที่โมดูลอื่นๆ คอมไพล์ด้วย Java 8

หากต้องการดูวิธีกำหนดค่า Maven Toolchains โปรดดูบทความนี้

โปรเจ็กต์ใช้ระบบฐานข้อมูลที่หลากหลายสำหรับการทดสอบการรวม และคุณสามารถกำหนดการตั้งค่าการเชื่อมต่อ JDBC โดยใช้อินสแตนซ์ DatasourceProvider (เช่น PostgreSQLDataSourceProvider ) และโปรเจ็กต์ใช้ Testcontainers เพื่อบูตคอนเทนเนอร์ Docker ด้วย Oracle, SQL Server, PostgreSQL หรือ MySQL ที่จำเป็น ตัวอย่างตามความต้องการ

หากคุณเป็นผู้มีส่วนร่วมเป็นประจำ ขอแนะนำให้ตั้งค่าฐานข้อมูลที่จำเป็นในเครื่อง หรือใช้การกำหนดค่า Docker Compose ที่ให้ไว้ในโฟลเดอร์ docker เนื่องจากการบูตสแตรปคอนเทนเนอร์ตามความต้องการจะช้าลง และการทดสอบของคุณจะใช้เวลานานกว่าในการรัน

หากคุณต้องการแก้ไขปัญหาหรือเพิ่มการสนับสนุนสำหรับคุณลักษณะใหม่ โปรดระบุกรณีทดสอบการผสานรวมที่เกี่ยวข้องซึ่งพิสูจน์ว่าการปรับปรุงทำงานได้ตามที่คาดไว้