如何正确使用maven配置hibernate

我今天一整天，都忙着在用maven配置hibernate。网上的教程很少，经常报错，官方的文档上也是语焉不详，后来在网上差了一整天的资料，有中文的，有外文的，有CSDN上的，有stackoverflow上的，最后终于配通了。在这里我把maven中配置Hibernate所遇到的问题如何解决给大家讲一下，希望大家少走弯路，省去不必要的麻烦。

目录

依赖路径的配置

hibernate.cfg.xml的配置

---

依赖路径的配置

配置Hibernate的时候，在pom.xml中要添加的全部dependency就是这几项。除此之外，不用再添加其他的依赖。

<dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
	<dependency>
	   <groupId>org.infinispan</groupId>
	   <artifactId>infinispan-directory-provider</artifactId>
	   <version>9.0.1.Final</version>
	</dependency>
	<dependency>
		<groupId>mysql</groupId>
		<artifactId>mysql-connector-java</artifactId>
		<version>8.0.28</version>
	</dependency>

	<dependency>
	   <groupId>org.hibernate</groupId>
	   <artifactId>hibernate-core</artifactId>
	   <version>5.4.0.Final</version>
	</dependency>
        
    <dependency>
        <groupId>jakarta.xml.bind</groupId>
        <artifactId>jakarta.xml.bind-api</artifactId>
        <version>2.3.2</version>
        </dependency>
    <dependency>
		<groupId>org.glassfish.jaxb</groupId>
		<artifactId>jaxb-runtime</artifactId>
		<version>2.3.5</version>
	</dependency>
  </dependencies>

但请注意，在上图的代码中，有几项你是需要修改的：

首先是mysql这项：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.28</version>
</dependency>

这项，很显然，是用来与MySQL数据库连接的。如果你用的不是MySQL数据库，那么你就要换成一些别的依赖。再有一点要注意的就是版本，也就是<version>这项，因你用的MySQL版本而异。你安装的MySQL是什么版本，就写什么版本。

在MySQL中，要想查询所使用的版本，方法很简单，你只需要在终端上输入用户名和密码，启动MySQL，在MySQL启动后输出的信息中，就会看到当前使用的MySQL版本。，如图所示：

在这其中可以看到，我用的mysql版本是8.0.28。图中输出信息的第四行明确写着：

        Server version: 8.0.28 MySQL Community Server - GPL

所以在pom.xml中，我把mysql这项依赖的版本设为8.0.28。

还有一项需要注意的，就是

<dependency>
    <groupId>org.hibernate</groupId>
	<artifactId>hibernate-core</artifactId>
	<version>5.4.0.Final</version>
</dependency>

首先需要注意的是它的版本。如果你用的是MySQL8,那么版本需要定为5.3以上，才能够支持，否则就会报出Unable to resolve name错误。

此外，Hibernate的配置官方文档可能会建议你作如下配置：

其中hibernate-search-orm这项可以换成hibernate-core。你可以不引入hibernate-search-orm，只引入hibernate-core。如果你在运行项目的时候，出现了像不支持方言之类的问题，可以考虑换一下。 

还有一个需要注意的就是这两项：

<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
    <version>2.3.2</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
	<artifactId>jaxb-runtime</artifactId>
    <version>2.3.5</version>
</dependency>

很多人是这样配的：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.0</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.0</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
    <version>2.3.0</version>
</dependency>
<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>activation</artifactId>
    <version>1.1.1</version>
</dependency>

如果出现了错误，建议你可以改过来。我最开始就是像后者这样配的，结果报出了错误，于是我改成了前者。

在配置jakarta.xml.bind-api依赖的时候，IDE可能会提示找不到这个包，这便是因为你使用的镜像源里缺乏所需要的包。解决方案也很简单，maven是可以添加多个镜像源的。你可以进入到settings.xml中，把maven官方的镜像源添加进去，不需要删除你原先的镜像源。这样，你原先的镜像源和新添加的镜像源完全可以同时使用。

maven官方的镜像源添加的代码如下：

<mirror>
    <id>repo1</id>
    <mirrorOf>central</mirrorOf>
    <name>Human Readable Name for this Mirror.</name>
    <url>http://repo1.maven.org/maven2/</url>
</mirror>
  
<!-- 中央仓库2 -->
<mirror>
    <id>repo2</id>
    <mirrorOf>central</mirrorOf>
    <name>Human Readable Name for this Mirror.</name>
    <url>http://repo2.maven.org/maven2/</url>
</mirror>

hibernate.cfg.xml的配置

然后就是配置hibernate.cfg.xml了，这个文件应当直接放在src/main/java目录下。注意不要放在包里。文件内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration SYSTEM 
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
   <session-factory>
<!--配置所使用的Hibernate方言-->
	   <property name="hibernate.dialect">org.hibernate.dialect.MySQL8Dialect</property>
	   <property name="hibernate.connection.driver_class">com.mysql.cj.jdbc.Driver</property>
	
	   <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/test？serverTimezone=UTC</property>
<!--配置数据库用户名-->      
	   <property name="hibernate.connection.username">root</property>
<!--配置数据库密码，我做了打码处理-->
	   <property name="hibernate.connection.password">×××××××××××</property>
	   
	   <property name="hibernate.validator.apply_to_ddl">false</property>  
	   <property name="hibernate.validator.autoregister_listeners">false</property> 
	
	   <!-- List of XML mapping files -->
	   <mapping resource="Employee.hbm.xml"/>
	
	</session-factory>
</hibernate-configuration> 

其中hibernate.dialect这项，表示的是你这个项目里的Hibernate用的是什么方言。不同的数据库使用不同的方言。对于MySQL，不同的版本，使用的方言也不同：

MySQL5使用的方言是：

org.hibernate.dialect.MySQL5Dialect

 MySQL8使用的方言是：

org.hibernate.dialect.MySQL8Dialect

而其他版本则是：

org.hibernate.dialect.MySQLDialect

还有值得注意的就是这两项：

<property name="hibernate.connection.driver_class">com.mysql.cj.jdbc.Driver</property>
<property name="hibernate.connection.url">jdbc:mysql://localhost:3306/test?serverTimezone=UTC</property>

或者也可以配成这样：

<property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="hibernate.connection.url">jdbc:mysql://localhost:3306/test

留意一下这两者中driver_class和url有什么区别吧。用后一个还是前一个，因数据库版本而异。你看看哪个能用，不出问题，就用哪个吧。如果你发现数据库连接不了，可以换另外一个试试。

接下来就是给每个类配置.hbm.xml文件了，具体教程可以看一看这里：Hibernate 映射文件https://www.w3cschool.cn/hibernate/1vlx1iej.html

具体我就不再赘述了。.hbm.xml文件是和hibernate.cfg.xml一样，也是直接放在src/main/java目录下的。