Hibernate Configuration
Hibernate Configuration是hibernate的入口,在新建一个Configuration的实例的时候,hibernate会在classpath里面查找hibernate.properties文件,如果该文件存在,则将该文件的内容加载到一个Properties的实例GLOBAL_PROPERTIES里面如果不存在,将打印信息:hibernate.properties not found然后是将所有系统环境变量(System.getProperties())也添加到GLOBAL_PROPERTIES里面。如果hibernate.properties文件存在,系统还会验证一下这个文件配置的有效性,对于一些已经不支持的配置参数,系统将打印警告信息。
(1) 作用---实现对Hibernate进行配置
◆Configuration接口的作用是对Hibernate进行配置,以及对它进行启动。在Hibernate的启动过程中,Configuration类的实例首先定位映射文档的位置,读取这些配置,然后创建一个SessionFactory对象。
◆根据Configuration对象创建一个SessionFactory对象。为了能创建一个SessionFactory对象,你必须在Hibernate初始化时创建一个Configuration类的实例,并将已写好的映射文件交由它处理。
这样,Configuration对象就可以创建一个SessionFactory对象,当SessionFactory对象创建成功后,Configuration对象就没有用了,你可以简单地抛弃它。
(2) 它是启动Hibernate的对象
虽然Hibernate Configuration接口在整个Hibernate项目中只扮演着一个很小的角色,但它是启动hibernate时你所遇到的第一个对象。
(3) 使用方法链编程风格,可以改写为:
- Configuration config = new Configuration();
- config.addClass(Customer.class);
- sessionFactory = config.buildSessionFactory();
- sessionFactory = new Configuration().buildSessionFactory().
addClass(Customer.class).buildSessionFactory();
注意:方法链编程风格能使应用程序代码更加简捷。在使用这种编程风格时,最好把每个调用方法放在不同的行,否则在跟踪程序时,无法跳入每个调用方法中。
configuration
Configuration是 hibernate的入口,在新建一个Configuration的实例的时候,会生成一新的SettingsFactory,如果在构造参数中传入一个SettingsFactory则会将传入的SettingsFactory赋给Hibernate的SettingsFactory并执行reset()方法。
最常见的使用Configuration方式是:
Configuration cfg = new Configuration().configure();
将产生一个Configuation的实例并调用configure()方法。
configure()方法默认会在classpath下面寻找hibernate.cfg.xml文件,如果没有找到该文件,系统会打印如下信息并抛出HibernateException异常
/hibernate.cfg.xml not found
然后是将所有系统环境变量(System.getProperties())也添加到GLOBAL_PROPERTIES里面。如果hibernate.cfg.xml文件存在,系统还会验证一下这个文件配置的有效性,对于一些已经不支持的配置参数,系统将打印警告信息。
configure()方法会首先访问< session-factory >,并获取该元素的name属性,如果非空,将用这个配置的值来覆盖hibernate.properties的hibernate.session_factory_
name的配置的值,从这里我们可以看出,hibernate.cfg.xml里面的配置信息可以覆盖hibernate.properties的配置信息。
接着configure()方法访问< session-factory>的子元素,首先将使用所有的< property>元素配置的信息覆盖hibernate.properties里面对应的配置。
然后configure()会顺序访问以下几个元素的内容
< mapping>
< jcs-class-cache>
< jcs-collection-cache>
< collection-cache>
其中是必不可少的,必须通过配置< mapping>,configure()才能访问到我们定义的java对象和关系 数据库表的映射文件(hbm.xml),例如:
User.hbm.xml
通过以上的分析,我们对hibernate配置文件hibernate.properties和hibernate.cfg.xml的默认的加载过程就比较清楚了。
Configuration的其他用法:
Configuration的configure ()方法还支持带参数的访问方式,你可以指定hbm.xml文件的位置,而不是使用默认的classpath下面的hibernate.cfg.xml这种方式,例如:
Configuration cfg = new Configuration().configure("myexample.xml");
同时Configuration还提供了一系列方法用来定制hibernate的加载配置文件的过程,让你的应用更加灵活,常用的是以下几种:
addProperties(Element)
addProperties(Properties)
setProperties(Properties)
setProperty(String, String)
通过以上几个方法,除了使用默认的hibernate.properties文件,你还可以提供多个.properties配置文件,使用Hibernate的时候根据不同的情况使用不同的配置文件,例如:
Properties properties = Properties.load("my.properties");
Configuration config = new Configuration().setProperties (properties).configure();
除了指定.properties文件之外,还可以指定.hbm.xml文件,下面列出几个常用的方法:
addClass(Class)
addFile(File)
addFile(String)
addURL(URL)
前面我们已经讲了,configure() 方法默认是通过访问hibernate.cfg.xml的元素来加载我们提供的.hbm.xml文件,上面列出的方法可以直接指定hbm.xml文件,例如addClass()方法可以直接通过指定class来加载对应的映射文件,hibernate会将提供的class的全名(包括package)自动转化为文件路径,如
net.sf.hibernate.examples.quickstart.User.class
对应net/sf/hibernate/examples/quickstart/User.hbm.xml
还可以用addFile方法直接指定映射文件。例如:
Configuration config = new Configuration().addClass(Cat.class);
Configuration config = new Configuration().addURL(Configuration.class.getResource("Cat.hbm.xml"));
Configuration config = new Configuration().addFile("Cat.hbm.xml");
四 总结configuration.
Configuration提供的这些方法的好处如下:
1.一个应用中往往有很多.hbm.xml映射文件,开发的过程中如果只是为了测试某个或几个Java PO(Persistence Object),我们没有必要把所有的.hbm.xml都加载到内存,这样可以通过addClass或者addFile直接配置,显得非常灵活。
2.学习Hibernate的过程中,往往需要通过练习来体会Hibernate提供的各种特征,而很多特征是需要修改配置文件的,如果要观察相同的代码在不同的特征下的表现,就需要手工改配置文件,这样太麻烦了,而且容易出错,我们可以提供多个配置文件,每个配置文件针对需要的特征而配置,这样我们在调用程序的时候,把不同的配置文件作为参数传递进去,而程序代码里面使用setProperties和addFile指定传入的配置文件参数就可以了。
3.在单元测试中,特别是在集成测试里面,整个过程是自动化的,我们不能手工干预测试过程,往往需要准备多个配置文件针对不同的测试案例,这个时候 setProperties和addFile方法就显得特别有用了,在不同的测试案例中用这些方法来指定相应的配置文件,这样就可以做到自动化测试,保证了持续性。