如何完全根据官方下载包搭建hibernate框架

　　好久没有用s2sh的框架了，最近业务需要又要拾起来。在搭框架时，发现之前都是复制配置文件，对具体的细节却很懵懂，所以要从新来一遍，也是一次新的学习。

　　我使用的版本是hibernate-release-4.3.11.Final，因为需要使用基于xml的配置，这一版本关于xml的文档还是很友好的，最新的5.x主要针对注解，与业务有所出入。

　　下面开始搭建：

　　百度云：jar包链接  密码：h7o8

关于文件结构

　　搭建Hibernate的压缩文件解压后就是下面的结构：

　　

　　jdbc和log4j包是我后加的，其他是就是hibernate的，下面说下他这几个文件夹的大致用途

　　documentation文件夹：存放了Hibernate的使用文档和框架API等，下面会用到。

　　lib文件夹：存放的是hibernate所需要的jar包。

　　project文件夹：存放的是一些小项目实例，里面的etc会用到。

关于jar包

　　搭建Hibernate，首先就是jar包，而Hibernate的jar包就在lib/required文件夹里，下面是这些jar包的作用

　　

　　有了这些jar包，Hibernate的功能就全了，但是Hibernate是操作数据库的，所以我们还需要提供我们要使用的数据库的对应的驱动。如mysql的驱动包。

　　在开发过程中，我们必然还需要记录捕捉项目的运行情况，所以还需要log4j的支持，进官网下载即可

下载完的文件里有很多jar包，用哪个呢，官网的下面说的很清楚。

到这里，jar包就准备完成了，

 创建项目

　　创建一个项目。

　　一、file-new-javaProject 填写项目名即可，因为主要说明Hibernate的使用，不需要web，所以直接用JavaProject，如果使用web也是一样的道理。

　　导入jar包

　　一、创建一个文件夹，将上面Hibernate的required文件夹的jar包、jdbc的jar包、log4j的jar包都copy进来

　　二、全选，鼠标右键-buildPath-add to build path

　　创建一个数据表

　　创建一个数据库，并添加一个表，下面是一个示例。也可以自己随意创建。

DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
  `u_id` int(11) NOT NULL AUTO_INCREMENT,
  `u_email` varchar(60) DEFAULT NULL,
  `u_name` varchar(100) DEFAULT NULL,
  `u_username` varchar(100) DEFAULT NULL,
  `u_password` varchar(70) DEFAULT NULL,
  `u_age` varchar(255) DEFAULT NULL,
  `u_detail` varchar(255) DEFAULT NULL,
  `u_avatar` varchar(255) DEFAULT NULL,
  `is_admin` varchar(5) DEFAULT NULL,
  `createtime` timestamp NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP,
  `updatetime` timestamp NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`u_id`)
) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8;

　　创建一个表对应的实体类

　　先建一个com.xx.domain的包，将实体类放入包中

package com.cky.domain;

import java.sql.Timestamp;

public class User {
    private Integer uId;
    private String uEmail;
    private String uName;
    private String uUsername;
    private String uPassword;
    private String uAge;
    private String uDetail;
    private String uAvatar;
    private String isAdmin;
    private Timestamp createtime;
    private Timestamp updatetime;

    public Integer getuId() {
        return uId;
    }

    public void setuId(Integer uId) {
        this.uId = uId;
    }

    public String getuEmail() {
        return uEmail;
    }

    public void setuEmail(String uEmail) {
        this.uEmail = uEmail;
    }

    public String getuName() {
        return uName;
    }

    public void setuName(String uName) {
        this.uName = uName;
    }

    public String getuUsername() {
        return uUsername;
    }

    public void setuUsername(String uUsername) {
        this.uUsername = uUsername;
    }

    public String getuPassword() {
        return uPassword;
    }

    public void setuPassword(String uPassword) {
        this.uPassword = uPassword;
    }

    public String getuAge() {
        return uAge;
    }

    public void setuAge(String uAge) {
        this.uAge = uAge;
    }

    public String getuDetail() {
        return uDetail;
    }

    public void setuDetail(String uDetail) {
        this.uDetail = uDetail;
    }

    public String getuAvatar() {
        return uAvatar;
    }

    public void setuAvatar(String uAvatar) {
        this.uAvatar = uAvatar;
    }

    public String getIsAdmin() {
        return isAdmin;
    }

    public void setIsAdmin(String isAdmin) {
        this.isAdmin = isAdmin;
    }

    public Timestamp getCreatetime() {
        return createtime;
    }

    public void setCreatetime(Timestamp createtime) {
        this.createtime = createtime;
    }

    public Timestamp getUpdatetime() {
        return updatetime;
    }

    public void setUpdatetime(Timestamp updatetime) {
        this.updatetime = updatetime;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;

        User user = (User) o;

        if (uId != user.uId) return false;
        if (uEmail != null ? !uEmail.equals(user.uEmail) : user.uEmail != null) return false;
        if (uName != null ? !uName.equals(user.uName) : user.uName != null) return false;
        if (uUsername != null ? !uUsername.equals(user.uUsername) : user.uUsername != null) return false;
        if (uPassword != null ? !uPassword.equals(user.uPassword) : user.uPassword != null) return false;
        if (uAge != null ? !uAge.equals(user.uAge) : user.uAge != null) return false;
        if (uDetail != null ? !uDetail.equals(user.uDetail) : user.uDetail != null) return false;
        if (uAvatar != null ? !uAvatar.equals(user.uAvatar) : user.uAvatar != null) return false;
        if (isAdmin != null ? !isAdmin.equals(user.isAdmin) : user.isAdmin != null) return false;
        if (createtime != null ? !createtime.equals(user.createtime) : user.createtime != null) return false;
        if (updatetime != null ? !updatetime.equals(user.updatetime) : user.updatetime != null) return false;

        return true;
    }

    @Override
    public String toString() {
        return "User{" +
                "uId=" + uId +
                ", uEmail='" + uEmail + '\'' +
                ", uName='" + uName + '\'' +
                ", uUsername='" + uUsername + '\'' +
                ", uPassword='" + uPassword + '\'' +
                ", uAge='" + uAge + '\'' +
                ", uDetail='" + uDetail + '\'' +
                ", uAvatar='" + uAvatar + '\'' +
                ", isAdmin='" + isAdmin + '\'' +
                ", createtime=" + createtime +
                ", updatetime=" + updatetime +
                "}\n";
    }

    @Override
    public int hashCode() {
        Integer result = uId;
        result = 31 * result + (uEmail != null ? uEmail.hashCode() : 0);
        result = 31 * result + (uName != null ? uName.hashCode() : 0);
        result = 31 * result + (uUsername != null ? uUsername.hashCode() : 0);
        result = 31 * result + (uPassword != null ? uPassword.hashCode() : 0);
        result = 31 * result + (uAge != null ? uAge.hashCode() : 0);
        result = 31 * result + (uDetail != null ? uDetail.hashCode() : 0);
        result = 31 * result + (uAvatar != null ? uAvatar.hashCode() : 0);
        result = 31 * result + (isAdmin != null ? isAdmin.hashCode() : 0);
        result = 31 * result + (createtime != null ? createtime.hashCode() : 0);
        result = 31 * result + (updatetime != null ? updatetime.hashCode() : 0);
        return result;
    }

    
}

　　在创建实体类时，属性最好使用包装类，例如：Integer，因为与基本类型(int)相比，包装类多了一种null状态。可以表示不存在，而基本类型带有默认值（如int默认0），这时就会有歧义,不知道是值为0还是不存在。

　　创建Hibernate配置文件

　　在项目鼠标右键-new-SourceFolder，创建一个资源文件。

　　（资源文件是为了方便我们阅读而设计的，当程序编译后，所有的资源文件会进行合并最后全部放到classes文件中，所以我们可以通过classpath进行获取）

　　创建hibernate.cfg.xml文件（这个文件名是hibernate默认文件名，当程序启动时，hibernate会自动在classpath中寻找名为hibernate.cfg.xml的文件，如果不是这个名字，就需要后期手动指定，会比较麻烦）

　　下面我们需要为文件添加约束，那么约束在哪里呢？

　　其实hibernate早已经为我们准备好了，打开hibernate核心包下的org.hibernate,最下面会有dtd文件

　　

　　双击打开hibernate-configuration-3.0.dtd文件（3.0向下兼容，4.0不向下兼容，所以要选择3.0的文件），会发现，上面注释里说明了约束头怎么写：

　　 

复制到配置文件中：

这时我们写一个<然后alt+？，会有提示标签，什么？你没有？那可以看看另一篇博客

　　配置文件的基本结构如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
    
<hibernate-configuration>
    <!-- 先配置SessionFactory标签，一个数据库对应一个SessionFactory标签 -->
    <session-factory>
        <!-- 必须的配置的参数5个，4大参数，数据库方言  -->
        <!--
        #hibernate.connection.driver_class com.mysql.jdbc.Driver
        #hibernate.connection.url jdbc:mysql:///test
        #hibernate.connection.username gavin
        #hibernate.connection.password 
        数据库方言
        #hibernate.dialect org.hibernate.dialect.MySQLDialect
         -->
        <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="hibernate.connection.url">jdbc:mysql:///blog</property>
        <property name="hibernate.connection.username">root</property>
        <property name="hibernate.connection.password">123456</property>
         <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
        <!-- 可选配置 -->
        <!-- 显示sql语句 -->
        <property name="hibernate.show_sql">true</property>
        <!-- 格式化sql语句 -->
        <property name="hibernate.format_sql">true</property>
        <!-- 生成数据库的表结构 
        (hbm2dd全称hibernate mapping to db define language auto create)
        update 没表会自动创建，有表添加数据。
            如果开发中间需要添加字段，可以在实体类添加属性。update会自动在数据库添加字段，并且不改变原来数据库值
        validate 校验实体属性和数据库是否一致
        -->
        <property name="hibernate.hbm2ddl.auto">update</property>
        
        <!-- 映射配置文件，可以在map配置文件右键copy qualified name-->
        <mapping resource="com/cky/domain/User.hbm.xml"/>
    </session-factory>
</hibernate-configuration>

上面配置的属性都可以在hibernate-release-4.3.11.Final\project\etc\hibernate.properties文件中找到

　　创建mapping映射文件

关于mapping映射文件的一些默认的规则。

　　1、Hibernate的mapping映射文件默认需要和实体类在同一文件夹中。

　　2、mapping映射文件默认命名规则：实体类名.hbm.xml。hbm（全称：hibernate mapping）

User.hbm.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<!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.cky.domain.User" table="user">
<!-- 配置id
    name实体类属性，column表字段，如果一样，column可以省略。
 -->
    <id name="uId" column="u_id">
    <!-- 主键生成策略 -->
        <generator class="native"></generator>
    </id>
    <property name="uEmail" column="u_email"></property>
    <property name="uName" column="u_name"></property>
    <property name="uUsername" column="u_username"></property>
    <property name="uPassword" column="u_password"></property>
    <property name="uAge" column="u_age"></property>
    <property name="uDetail" column="u_detail"></property>
    <property name="uAvatar" column="u_avatar"></property>
    <property name="isAdmin" column="is_admin"></property>
    <property name="createtime" column="createtime"></property>
    <property name="updatetime" column="updatetime"></property>
</class>
</hibernate-mapping>

User实体类文件

package com.cky.domain;

import java.sql.Timestamp;

public class User {
    private Integer uId;
    private String uEmail;
    private String uName;
    private String uUsername;
    private String uPassword;
    private String uAge;
    private String uDetail;
    private String uAvatar;
    private String isAdmin;
    private Timestamp createtime;
    private Timestamp updatetime;

    public Integer getuId() {
        return uId;
    }

    public void setuId(Integer uId) {
        this.uId = uId;
    }

    public String getuEmail() {
        return uEmail;
    }

    public void setuEmail(String uEmail) {
        this.uEmail = uEmail;
    }

    public String getuName() {
        return uName;
    }

    public void setuName(String uName) {
        this.uName = uName;
    }

    public String getuUsername() {
        return uUsername;
    }

    public void setuUsername(String uUsername) {
        this.uUsername = uUsername;
    }

    public String getuPassword() {
        return uPassword;
    }

    public void setuPassword(String uPassword) {
        this.uPassword = uPassword;
    }

    public String getuAge() {
        return uAge;
    }

    public void setuAge(String uAge) {
        this.uAge = uAge;
    }

    public String getuDetail() {
        return uDetail;
    }

    public void setuDetail(String uDetail) {
        this.uDetail = uDetail;
    }

    public String getuAvatar() {
        return uAvatar;
    }

    public void setuAvatar(String uAvatar) {
        this.uAvatar = uAvatar;
    }

    public String getIsAdmin() {
        return isAdmin;
    }

    public void setIsAdmin(String isAdmin) {
        this.isAdmin = isAdmin;
    }

    public Timestamp getCreatetime() {
        return createtime;
    }

    public void setCreatetime(Timestamp createtime) {
        this.createtime = createtime;
    }

    public Timestamp getUpdatetime() {
        return updatetime;
    }

    public void setUpdatetime(Timestamp updatetime) {
        this.updatetime = updatetime;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;

        User user = (User) o;

        if (uId != user.uId) return false;
        if (uEmail != null ? !uEmail.equals(user.uEmail) : user.uEmail != null) return false;
        if (uName != null ? !uName.equals(user.uName) : user.uName != null) return false;
        if (uUsername != null ? !uUsername.equals(user.uUsername) : user.uUsername != null) return false;
        if (uPassword != null ? !uPassword.equals(user.uPassword) : user.uPassword != null) return false;
        if (uAge != null ? !uAge.equals(user.uAge) : user.uAge != null) return false;
        if (uDetail != null ? !uDetail.equals(user.uDetail) : user.uDetail != null) return false;
        if (uAvatar != null ? !uAvatar.equals(user.uAvatar) : user.uAvatar != null) return false;
        if (isAdmin != null ? !isAdmin.equals(user.isAdmin) : user.isAdmin != null) return false;
        if (createtime != null ? !createtime.equals(user.createtime) : user.createtime != null) return false;
        if (updatetime != null ? !updatetime.equals(user.updatetime) : user.updatetime != null) return false;

        return true;
    }

    @Override
    public String toString() {
        return "User{" +
                "uId=" + uId +
                ", uEmail='" + uEmail + '\'' +
                ", uName='" + uName + '\'' +
                ", uUsername='" + uUsername + '\'' +
                ", uPassword='" + uPassword + '\'' +
                ", uAge='" + uAge + '\'' +
                ", uDetail='" + uDetail + '\'' +
                ", uAvatar='" + uAvatar + '\'' +
                ", isAdmin='" + isAdmin + '\'' +
                ", createtime=" + createtime +
                ", updatetime=" + updatetime +
                "}\n";
    }

    @Override
    public int hashCode() {
        Integer result = uId;
        result = 31 * result + (uEmail != null ? uEmail.hashCode() : 0);
        result = 31 * result + (uName != null ? uName.hashCode() : 0);
        result = 31 * result + (uUsername != null ? uUsername.hashCode() : 0);
        result = 31 * result + (uPassword != null ? uPassword.hashCode() : 0);
        result = 31 * result + (uAge != null ? uAge.hashCode() : 0);
        result = 31 * result + (uDetail != null ? uDetail.hashCode() : 0);
        result = 31 * result + (uAvatar != null ? uAvatar.hashCode() : 0);
        result = 31 * result + (isAdmin != null ? isAdmin.hashCode() : 0);
        result = 31 * result + (createtime != null ? createtime.hashCode() : 0);
        result = 31 * result + (updatetime != null ? updatetime.hashCode() : 0);
        return result;
    }

    
}

　　添加测试

package com.cky.Demo;

import java.util.List;

import org.hibernate.Query;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.Configuration;
import org.junit.Test;

import com.cky.domain.User;
import com.cky.utils.HibernateUtils;

public class DemoTest {
    @Test
    public void testSave() {
        //1.加载配置文件
        Configuration cfg=new Configuration();
        //默认加载src目录下的hibernate.cfg.xml的配置文件
        cfg.configure();
        //2.创建sessionFactory
        SessionFactory sessionFactory = cfg.buildSessionFactory();
        //3.创建session
        Session session = sessionFactory.openSession();
        //4.开启事务
        Transaction tr = session.beginTransaction();
        //5.编写更新代码
        User user=new User();
        user.setuName("小红");
        user.setuPassword("123456");
        session.save(user);
        
        //6.提交事务
        tr.commit();
        //7.释放资源
        session.close();
        sessionFactory.close();
    }
}