YashanDB持久化框架操作示例（jpa-hibernate）

于 2024-08-13 18:06:57 发布
阅读量731 收藏 11
点赞数 26
文章标签： hibernate java 后端 数据库 spring boot
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_80281506/article/details/141169309
版权

1.背景介绍

基本概念：

1.JPA（Java Persistence API）是一种标准化的Java ORM（对象关系映射）规范，它定义了一套用于对象和关系数据库之间进行映射的API。 

2.Spring Data JPA是Spring框架对JPA的封装，它通过提供一系列接口和注解，简化了开发者对JPA的使用。

优势：

1.简化数据访问层开发：Spring Data JPA提供了一个自动生成常见数据访问层代码的机制，开发者只需要定义接口和方法命名规则，无需编写具体的实现代码。

2.提高代码的可读性：借助Spring Data JPA提供的接口和方法命名规则，开发者可以通过简单的方法命名来实现复杂的查询功能，使代码更加简洁和可读。

3.支持多种数据源：Spring Data JPA支持多种数据源（如关系数据库、NoSQL数据库等），开发者可以通过简单的配置切换数据源。

4.集成其他Spring组件：Spring Data JPA可以很方便地与其他Spring组件（如Spring MVC、Spring Boot等）集成，提供一体化的开发体验。

应用场景： 在应用程序开发中，Spring Data JPA可以用于处理各种数据库操作，包括增删改查、复杂查询、分页等。开发者只需要定义实体类和接口，Spring Data JPA会根据方法命名规则自动生成具体的查询语句。此外，Spring Data JPA还支持事务管理，可以保证数据库操作的一致性和完整性。极大地简化了数据访问层的开发，提高了开发效率和代码质量。

2.环境说明

以使用Maven为例：

Java环境：Jdk22（安装后需配置）

hibernate-core版本：5.4.32.Final（不高于6版本）

Springboot版本：2.3.12.RELEASE（JPA不高于3版本）

Maven版本：3.9.8（安装后需配置）

崖山驱动版本：1.6.9

崖山方言包版本：1.0.0

Maven的pom.xml文件：（用于验证整个jpa-hibernate与YashanDB的兼容性，所以涵盖很多的依赖包，如只需其中一种或者几种功能，保留相应的依赖即可。）

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId> 
        <artifactId>spring-boot-starter-data-jpa</artifactId>
        <version>2.3.12.RELEASE</version>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.10.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>RELEASE</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>javax.persistence</groupId>
        <artifactId>javax.persistence-api</artifactId>
        <version>2.2</version>
    </dependency>
</dependencies>

3.添加YashanDB驱动和方言包

打开Idea的ProjectStructure，使用Libraries添加YashanDB驱动，对于多模块，只需要添加到对应的模块即可。（YashanDB驱动：在产品软件包或安装目录的Drivers文件夹中，查找yasdb-jdbc-版本号.jar文件，例如yasdb-jdbc-1.6.9.jar）

也可以将YashanDB驱动上传到本地的Maven私服，然后在Pom文件中引入。

用同样的方式去添加崖山的方言包。（方言包：在产品软件包中，文件名为YashanDialect-for-hibernate5-版本号.jar，例如YashanDialect-for-hibernate5-1.0.0.jar）

注：若maven无法识别，直接在工程目录下建一个lib文件夹，把jar包放进去，然后引进来

 <dependency>
        <groupId>com.yashandb</groupId>
        <artifactId>yashandb-jdbc</artifactId>
        <version>1.6.9</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/lib/yashandb-jdbc-1.6.9.jar</systemPath> 
<!--项目根目录下的lib文件夹下-->
    </dependency>
    <dependency>
        <groupId>org.hibernate.dialect</groupId>
        <artifactId>YasDialect</artifactId>
        <version>1.0.0</version>
        <scope>system</scope>
      <systemPath>${project.basedir}/lib/YashanDialect-for-hibernate5-1.0.0.jar</systemPath> 
<!--项目根目录下的lib文件夹下-->
    </dependency>

4.数据源和jpa-hibernate配置

本文采用application.properties文件进行参数配置。请将下例中的host_ip、port、dbname、username和password修改为实际值。 注意spring.jpa.properties.hibernate.dialect这个配置项，必须设置为org.hibernate.dialect.YasDialect。

spring.application.name=demo
spring.datasource.url=jdbc:yasdb://127.0.0.1:1688/yasdb
spring.datasource.username=regress
spring.datasource.password=regress
spring.datasource.driver-class-name=com.yashandb.jdbc.Driver
#方言必须设置为崖山方言YasDialect
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.YasDialect
#是否自动建表
spring.jpa.properties.hibernate.hbm2ddl.auto=create
#字段名和数据库中对象名的映射关系:
spring.jpa.properties.hibernate.naming-strategy=org.hibernate.cfg.ImprovedNamingStrategy

5.jpa-hibernate功能验证

创建entity

创建User用户的entity，并使其与Table对应。

package com.example.pojo;

import lombok.Data;

import org.hibernate.annotations.ColumnDefault;

import javax.persistence.Column;

import javax.persistence.Entity;

import javax.persistence.GeneratedValue;

import javax.persistence.GenerationType;

import javax.persistence.Id;

import javax.persistence.SequenceGenerator;

import javax.persistence.Table;

import java.time.LocalTime;

@Data@Entity@Table(name = "user1")

public class User {

    @Id //hibernate要求必须要一个id（主键）,不然会报错

    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "ID_GENERATOR")

    @SequenceGenerator(name = "ID_GENERATOR", sequenceName = "user_sequence")

    @ColumnDefault("user_sequence.nextval")

    private int id;

    

    @Column(name = "name")

    private String name;

    public User() {

    }

    public User(String name) {

        this.name = name;

    }

    public User(int id, String name) {

        this.id = id;

        this.name = name;

    }}

定义Repository接口，可以继承JpaRepository，也可以继承CrudRepository，视个人使用习惯或者团队要求自由选择，本例子中使用JpaRepository：

package com.example.dao;

import com.example.pojo.User;

import org.springframework.data.jpa.repository.JpaRepository;

import org.springframework.stereotype.Repository;

@Repository

public interface UserRepository extends JpaRepository<User,Integer> {//注意JpaRepository<User,Integer>这里传入的泛型类型,第一个是我们上面定义的Entity,第二个是Entity的主键的类型//里面可以不实现任何接口,JpaRepository的默认接口已经足够我们使用了。}

主类

package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

创建单元测试类

package com.example;

import com.example.dao.UserRepository;

import com.example.pojo.User;

import org.junit.Before;

import org.junit.Test;

import org.junit.runner.RunWith;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.boot.test.context.SpringBootTest;

import org.springframework.test.context.junit4.SpringRunner;

import java.util.List;

import static org.junit.Assert.assertEquals;

@RunWith(SpringRunner.class)

@SpringBootTest

public class UserTest {

    @Autowired

    private UserRepository repository;

    @Before

    public void deleteAllUser(){

        repository.deleteAll();

    }



    @Test

    public void testAddUser() {

        User user = new User("sasa");

        repository.save(user);

        List<User> list = repository.findAll();

        assertEquals(1, list.size());

    }}

6.常见问题

(1) 版本不匹配导致崖山方言包失效

目前崖山方言包只支持hibernate5版本，JPA不超过3版本（JPA 3以上版本只支持hibernate 6）示例如下：

解决方法：调整安装版本

(2) 重新加载maven项目后YashanDB驱动和方言包丢失

通过Libraries添加的YashanDB驱动和方言包在重新加载maven项目后可能会丢失导致报错

解决方法：直接在工程目录下建一个lib文件夹，把jar包放进去，然后引进

(3) SpringBoot项目报错：：Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.

根据问题看出：springboot启动时会自动注入数据源和配置jpa

解决方法：在@SpringBootApplication中排除其注入

@SpringBootApplication(exclude=DataSourceAutoConfiguration.class)

(4) 自增主键的使用

一般情况下，在使用Hibernate持久化框架时，需要定义Entity实体类，实体类中存在一个Id属性，将该属性作为业务表的自增主键列，示例如下：

@Id
@SequenceGenerator(name="generator",sequenceName="user_sequence", allocationSize =1)
@ColumnDefault("user_sequence.nextval")
@GeneratedValue(strategy= GenerationType.AUTO, generator = "generator")
private int id;

在上述示例中，user_sequence为序列名，由您自定义命名。

Note:

  1. 注意保持@SequenceGenerator参数sequenceName和@ColumnDefault中的序列名称一致。

  2. 如果sequenceName指定的序列名是驼峰格式，hibernate会把它改成下划线，和表名，列名等一样处理；但是@ColumnDefault这个注解的value是不处理驼峰格式的，所以就会导致sequenceName和ColumnDefault里面序列器名称不一致，启动时建表会失败，所以注意这里不要用驼峰命名，直接用下划线风格命名。

此外，也可以不指定@ColumnDefault，和@SequenceGenerator。

这时hibernate使用默认序列hibernate_sequence去自增，示例如下：

@Id
@GeneratedValue(strategy= GenerationType.AUTO)
private int id;

(5) 服务启动失败

使用hibernate配置hbm2ddl.auto=validate时，服务启动时会进行校验；当数据库表结构数据类型与Java实体类数据类型不一致时，Schema-validation校验失败；从而导致容器初始化Hibernate SessionFactory时失败。

spring.jpa.properties.hibernate.hbm2ddl.auto=validate

出现这个问题时，我们需要修改数据库表结构，或修改Java实体类数据类型，保持数据库表结构与Java实体类数据类型一致。

或者，将hbm2ddl.auto配置设置为none，服务启动时不进行校验。

(6) 不支持TEXT数据类型

MySQL迁移前，业务中可能使用了TEXT这一数据类型，示例如下：

@Column(name = "file_types", columnDefinition = "TEXT")
private String fileTypes;

迁移后，YashanDB不支持TEXT数据类型，导致报错。

YashanDB虽不支持TEXT类型，但支持CLOB类型，用于保存大量字符数据。因此，建议将TEXT改为CLOB，即columnDefinition = "TEXT"改为columnDefinition = "CLOB"。

书白666
关注
  • 26
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
java jpa 使用_JAVA JPA - 示例用法
weixin_42676678的博客
02-13 1013
JPA(Java Persistence API)是JSR(Java Specification Requests)的一部分，定义了一系列对象持久化的标准，目前实现这一规范的产品有Hibernate、TopLink等。下面的示例程序是在jboss quickStart的基础上修改而来的1、实体Bean：Member类1 packageorg.jboss.as.quickstart.hibernat...
imed-dojo-jpa-hibernate:示例项目展示了 JPA 和Hibernate的使用
06-04
JPA提供了实体管理器（EntityManager）来处理对象的持久化，包括创建、读取、更新和删除（CRUD）操作，以及查询语言JPQL（Java Persistence Query Language），用于执行复杂的数据库查询。 接下来，Hibernate是JPA...
springDataJpa---hibernate&Jpa的简单实现---01
weixin_53058174的博客
12-20 207
springDataJpa-----hibernate&Jpa的简单实现---01
Java中的数据持久化与ORM框架：JPA与Hibernate的比较
微赚淘客系统开发者博客
08-06 902
本篇文章将详细探讨JPA与Hibernate的特点和比较，并通过代码示例展示它们的使用。Hibernate作为JPA的实现，不仅完全支持JPA，还扩展了许多高级功能，适用于复杂场景。Hibernate是一个成熟的ORM框架，提供了JPA的实现。对于需要高级功能的应用，Hibernate是一个更强大的选择。而Hibernate不仅支持JPA，还提供了丰富的API和配置选项，使得在复杂场景中也能高效处理。Hibernate则是JPA的实现之一，并且提供了比JPA更多的功能和优化。
java：jpa、Hibernate、Spring Data JPA、ORM以及和mybatis的区别
分享前端开发工程师的一些日常生活、前端知识点、职业发展、对一些问题的看法、感悟等等
11-28 345
java：jpa、Hibernate、Spring Data JPA、ORM以及和mybatis的区别
Spring Data JPA与Hibernate的关系是什么？
java永无止境！
05-30 503
Spring Data JPA 和 Hibernate 的关系可以用术语“抽象层”和“实现”来描述。在这种关系中，Spring Data JPA 表现为一个更高级别的抽象层，而 Hibernate 是这一层下面的一个具体实现。
Spring （20）Spring Data JPA和Hibernate有什么区别
qq_43012298的博客
05-27 972
Spring Data JPA 和 Hibernate 在 Java 社区中都是非常流行的持久化技术。尽管二者经常一起使用，但它们各自扮演着不同的角色并且解决了不同层面的问题。了解这两者之间的区别，对于设计和实现Java应用程序中的数据访问层是非常重要的。
JPA+Hibernate中常用的注解
妃妃不妃的小博客
03-06 292
JPA+Hibernate中常用的注解 JPA是Java Persistence API的简称，中文名Java持久层API，是JDK 5.0注解或XML描述对象－关系表的映射关系，并将运行期的实体[对象持久化](https://baike.baidu.com/item/对象持久化/7316192)到数据库中。 Sun引入新的JPA ORM规范出于两个原因：其一，简化现有Java EE和Java SE应用开发工作；其二，Sun希望整合ORM技术，实现天下归一。 JPA的总体思想和现有Hibernate、T
走进Java接口测试之持久层框架Spring-data-jpa
Mo小泽的技术博客
12-23 1188
文章目录引言Spring-data-jpa介绍JPA是什么？Spring-data-jpaSpring-data-jpa使用基本查询预先生成方法使用默认方法自定义简单查询多数据源的支持同源数据库的多源支持异构数据库多源支持使用示例工程配置创建实体创建数据访问接口Junit单元测试工程结构 引言 在接口测试中把Case存储至数据库中，是比较常见的“数据驱动”做法。而在实际的接口测试用例开发中，对数据...
持久化框架ibatis、hibernate和Jpa优缺点分析
iCoding91
10-23 7386
简介 Java中的对象-关系映射是一项棘手的业务，诸如JDBC和实体bean一类的解决方案并未受到多大的欢迎，不过新一代的ORM解决方案倒是因此而出现了。这些工具使得编程更加的容易，并且是更加严格地遵循面向对象编程和多层次架构开发的理念。学习如何基于诸如查询语言支持、性能以及跨不同关系数据库的移植性等因素来比较Hibernate、iBATIS和Java Persistence API。
简洁持久层开发之Spring Data JPA
qq_27890899的博客
07-05 384
Spring项目开发中，持久层的框架常用的有MyBatis、Mybatis Plus、Hibernate和Spring Data JPA等，国内常用的是前两种，本人最先接触的也是MyBatis。下面我列举了常用的三类框架的一些对比信息。今天我们要聊一聊一种解放双手的持久成框架Spring Data JPA。
jpa-hibernate-alura:Alura的Java和JPA课程
04-28
Alura-Java和JPA课程：使用JPA2和Hibernate持久化对象 这是我在课程之后开发的代码。 我已经对原始版本进行了一些更改。 内容 JPA和Hibernate简介 使用数据库 面向对象范式 在Java代码中避免使用SQL JDBC和SQL维护...
jpa-hibernate:JPA和Hibernate
03-30
在名为"jpa-hibernate-master"的压缩包中，通常会包含一个Java项目结构，包括pom.xml文件（Maven配置）、src/main/java（源代码目录）、src/main/resources（资源配置，如数据库连接信息）以及相关的实体类、配置...
jpa-hibernate-sample
02-18
标题"jpa-hibernate-sample"表明这是一个关于Java Persistence API (JPA) 和 Hibernate 框架的示例项目。Hibernate 是一个流行的开源对象关系映射（ORM）工具，它实现了JPA规范，使得Java开发者能够更方便地在关系型...
Jpa-Hibernate
03-22
**JPA（Java Persistence API）与Hibernate：Java持久化框架详解** 在Java开发中，数据库操作是不可或缺的一部分。为了简化数据库交互，Java引入了JPA（Java Persistence API），这是一个标准的API，允许开发者以...
深入探索Stage #2：属性中的XSS注入技术
weixin_43822401的博客
06-04 690
在Web安全的学习旅程中，XSS（跨站脚本）注入是一个不可忽视的话题。"XSS Challenges"闯关游戏的Stage #2专为进阶学习者设计，专注于属性中的XSS注入技术。本文将详细介绍这一阶段的实操过程和关键概念。
SpringBoot快速入门（手动创建）
m0_74124657的博客
08-11 310
代码如下//引导类项目的入口//注解添加导入进来你可以浏览器中查看自己编写的代码，看是否正确localhost：你命名的端口号（默认是8080。后面你也可以在配置文件修改）
springboot民办高校科研项目管理系统-计算机毕业设计源码54009
VX_DZbishe的博客
08-11 321
论文主要是对基于springboot的民办高校科研项目管理系统进行了介绍，包括研究的现状，还有涉及的开发背景，然后还对系统的设计目标进行了论述，还有系统的需求以及整个的设计方案，对系统的设计以及实现，也都论述的比较细致，最后对基于springboot的民办高校科研项目管理系统进行了一些具体测试。本次报告，首先分析了研究的背景、作用、意义，为研究工作的合理性打下了基础。
软件测试需要具备的基础知识【功能测试】---后端知识（三）
最新发布
yang_xs的博客
08-12 853
为了更好的学习软件测试的相关技能，需要具备一定的基础知识。需要学习的基础知识包括：1、计算机基础2、前端知识3、后端知识4、软件测试理论后期分四篇文章进行编写，这是第三篇CS架构BS架构效率：c/s效率高，某些内容已经安装在系统中了，b/s每次都要加载最新的数据升级：b/s无缝升级；c/s删除老版本再安装新版本安全：c/s更安全，需要安装、注册、登录；b/s有浏览器即可使用，安全程度低开发成本：b/s成本低；c/s需要不同的系统要不同的开发人员，成本高。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值