Hibernate 第一个程序的问题Unknown entity（新手必看）

一、在Eclipse下建立Java工程HibernateDemo

二、新建lib文件夹导入hibernate/ required文件夹下的包以及数据库所需要的包

我下的是hibernate版本为：
hibernate-release-5.2.10.Final
用的是MySQL数据库，包为：
mysql-connector-java-5.1.39-bin.jar

导入之后要BuildPath一下 到 Reference Libraries里。
有的IDE可能会自动导入，这个可忽略

三、建立数据库Student并创建student_table表

CREATE DATABASE studen;
USER student;
DROP TABLE IF EXISTS `student_table`;
CREATE TABLE `student_table` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(20) DEFAULT NULL,
  `age` int(11) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8;

四、创建Student实体类

	package com.pojo;
	
	public class Student {
	 private int id;
	 private String name;
	 private int age;
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
}

五、创建映射文件

Student.hbm.xml
这个文件要和实体类在同一个包下面

	<?xml version="1.0"?>
	<!DOCTYPE hibernate-mapping PUBLIC
		"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
		"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
	
	<hibernate-mapping>
	
		<class name="com.pojo.Student" table="student_table">
			<id name="id" type="integer">
				<!-- 主键生成策略 -->
				<generator class="native" />
			</id>
			<!-- 实体类的属性 -->
			<property name="name" type="string" />
			<property name="age" type="integer" />
		</class>
	
	</hibernate-mapping>

这里的头文件可以在下载的hibernate.jar包解压后的文件下搜索 version.hbm.xml

<?xml version="1.0"?>
<!--
  ~ Hibernate, Relational Persistence for Idiomatic Java
  ~
  ~ License: GNU Lesser General Public License (LGPL), version 2.1 or later.
  ~ See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
  -->
<!DOCTYPE hibernate-mapping PUBLIC
	"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
	"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="org.hibernate.test.schemaupdate">

	<class name="Version">
		<id name="id">
			<generator class="sequence"/>
		</id>
		<property name="description"/>	
	</class>

</hibernate-mapping>

可以直接复制过来。

六、创建Hibernate配置文件

在src下创建 hibernate.cfg.xml

<!DOCTYPE hibernate-configuration PUBLIC
	"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
	"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
	<session-factory>
		<!-- 配置数据库连接信息 -->
		<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
		<property name="connection.url">jdbc:mysql://localhost:3306/student?useUnicode=true&amp;characterEncoding=utf-8</property>
		<property name="connection.username">root</property>
		<property name="connection.password">950420</property>
		<!--数据库方言 指定链接语言 -->
		<property name="dialect">org.hibernate.dialect.MySQLDialect</property>
		<!-- 映射Student资源 -->
		<property name="hibernate.show_sql">true</property>
		<mapping resource="com/pojo/Student.hbm.xml" />
	</session-factory>
</hibernate-configuration>

这里的内容可以在api中直接copy过来。

六、编写测试类

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
import org.hibernate.cfg.Configuration;
import org.hibernate.service.ServiceRegistry;

import com.pojo.Student;

public class StudentTest {
	public static void main(String[] args) {
         //1.新建configuration对象
		Configuration configuration=new Configuration().configure();
		
		//configuration.addClass(Student.class);
		//2.通过configuration创建sessionFactory对象

		/*StandardServiceRegistry serviceRegistry=new StandardServiceRegistryBuilder().configure().build();


		SessionFactory sessionFactory=new MetadataSources(serviceRegistry).buildMetadata().buildSessionFactory();
		*/
		
		ServiceRegistry serviceRegistry = new StandardServiceRegistryBuilder().applySettings(configuration.getProperties()).build();
		SessionFactory sessionFactory=configuration.buildSessionFactory(serviceRegistry);
		
		//3.通过sessionFactory得到session
		Session session=sessionFactory.openSession();
		
		//4.通过session对象得到Transaction对象
		org.hibernate.Transaction transaction=session.beginTransaction();
		//5.保存数据
		Student student=new Student();
		student.setName("沈雪冰");
		student.setAge(23);
		session.save(student);
		//6.提交事务
		transaction.commit();
		//7.关闭session
		session.close();
		
	}
}

在这里我出了一个错误，Exception in thread “main” org.hibernate.MappingException: Unknown entity: com.pojo.Student

我相信有很多人会出现这个错误，也是我写这篇博客的初衷。
1.一定要保证你的hibernate.cfg.xml配置文件一定要映射你的实体类

	<mapping resource="com/pojo/Student.hbm.xml" />

在学习hibernate的时候看的书籍或者视频里边用到的hibernate不是最新的，我用的是官方最新版本的，而我看的视频老师讲的是4.3的，版本不一样 API 不一样，导致找不到实体类。

2.hibernate 5 创建 Session，代码如下：

SessionFactory factory = null;
Configuration configuration = new Configuration().configure();
configuration.addClass(News.class);
ServiceRegistry registry = new StandardServiceRegistryBuilder().applySettings(configuration.getProperties()).build();
factory = configuration.buildSessionFactory(registry);
Session session = factory.openSession();

注意：
与之前版本不同的：
1）
    configuration.addClass(News.class);
2）
    ServiceRegistry的实现需用StandardServiceRegistryBuilder
    之前版本用的是 ServiceRegistryBuilder

至此，需要加上：

configuration.addClass(Student.class);

这样程序就没问题了。

七、插入数据乱码问题

在我成功测试程序后查看数据库，发现中文是乱码，这个很好解决。

在hibernate.cfg.xml 里的url后面加一句话，这样就不是乱码了

<property name="connection.url">jdbc:mysql://localhost:3306/student??useUnicode=true&amp;characterEncoding=utf-8</property>

org.hibernate.MappingException: Unknown entity常见问题(新手需注意)
导入的包有问题

import org.hibernate.annotations.Entity;//这是就出问题了哦

import javax.persistence.Entity;//引入这个类就正确了

相关问题解决链接：
http://www.blogjava.net/xiaochao/articles/hibernatetopic.html