在OSGI(felix)里整合hibernate

早前的时候写了一篇《在插件里应用hsqldb和hibernate》

但是之前的方法只适用于equinox环境,并不能算是hibernate和osgi的完整整合,昨天终于完成了felix+hibernate的整合方式,现做一个完整记录。源码地址如下:

SVN:http://ext-eclipse.googlecode.com/svn

位置在trunck/mos下,主要是三个maven project: mos.hibernate,mos.hibernate.extender,mos.hibernate.manager

还有一个demo: mos.hibernate.demo,该插件并不完善,只提供了基本的使用方式,启动它需要blueprint配置。

 

先说明下三个主要插件的功能以及实现的思路:

mos.hibernate:

提供hibernate所需要的全部jar包,以后如果有版本变更,全部在这里维护。该插件不依赖于任何业务包。

清单包括(此处默认dom4j已经作为独立bundle,不计入其中):

<Bundle-ClassPath>.,lib/ejb3-persistence.jar,lib/hibernate-annotations.jar,lib/hibernate-commons-annotations.jar,lib/hibernate-entitymanager.jar,lib/antlr-2.7.6.jar,lib/asm-all-3.3.1.jar,lib/c3p0-0.9.1.jar,lib/cglib-2.2.2.jar,lib/commons-collections-2.1.1.jar,
lib/commons-logging-1.0.4.jar,lib/concurrent-1.3.4.jar,lib/ehcache-1.2.3.jar,lib/hibernate-3.2.7.ga.jar,lib/jta-1.1.jar</Bundle-ClassPath>

osgi整合hibernate最大的问题在于bundle的ClassLoader是分离的,而hibernate大量使用了反射方法,且在它设计本身,是没有考虑到多ClassLoader的情况的。

在绝大多数代码里,它使用了Thread.currentThread().getContextClassLoader()这个ClassLoader,于是只能获取到当前bundle能访问到的类。

如果是equinox环境,要解决这个问题就相对简单,eclipse为我们提供了一个buddy策略,参见《RCP Buddy简易实现》

但是,这对于osgi是破坏性的,它完全忽略了osgi规范定下的访问级别。

在felix环境下,我们有另外的替代方案:

方案一:

1、fragment bundle

我们可以把数据库驱动放在一个一个的fragment bundle中,让它的main bundle设为mos.hibernate,这样就实现了hibernate没有依赖于业务插件,也可以相对灵活的配置数据库

但是明显的,它有局限性。

2、DynamicImport-Package

这是OSGI规范内部的东西,它的作用是动态的查找可导入的包。

示例:

<DynamicImport-Package>*</DynamicImport-Package>

既然它符合osgi规范,那么,就必然无法动态导入已经依赖了mos.hibernate插件的其他插件中的package。

对于数据库驱动来说,这不是个问题。

但是对于业务Entity插件来说,这是必然会矛盾的地方。

所以对于业务Entity插件,我们还有另外的处理方式,将在mos.hibernate.manager讲解处说明。

 

mos.hibernate.extender:

1、注册数据库配置(HbmDatabaseConfig)和映射配置(HbmMappingConfig)

2、监听bundle的启动和停止,并解析其MANIFEST.MF文件,获取<Database-Configuration>,<Mapping-Configuration>的配置信息。

配置格式如下:

<Database-Configuration>[sessionFactoryId];[hibernate.cfg.xml File Path],[sessionFactoryId];[hibernate.cfg.xml File Path]</Database-Configuration>

<Mapping-Configuration>[sessionFactoryId];[Entity class name],[sessionFactoryId];[Entity class name]</Mapping-Configuration>

示例:

<Database-Configuration>hsqldb;/config/hsqldb.cfg.xml</Database-Configuration>
<Mapping-Configuration>hsqldb;mos.hibernate.demo.DemoBean,hsqldb;mos.hibernate.demo.Cat</Mapping-Configuration>

该bundle的实现有点类似于eclipse的扩展点机制。

事实上extender是一种非常值得学习的插件编程方式。

它由两个部分组成:

1)通过 context.getBundles()遍历全部已经存在的bundle

2)使用BundleListener,来对BundleEvent.STARTED状态的bundle注册,和BundleEvent.STOPPING状态的bundle反注册

同时,它提供对MANIFEST.MF文件的解析

bundle.getHeaders()能获取全部的MF属性名。

参见mos.hibernate.extender.util.HibernateBundleHelper的实现

 

mos.hibernate.manager:

1、提供数据库配置(HbmDatabaseConfig)和映射配置(HbmMappingConfig)的定义

2、提供数据库配置容器的定义以及缓存。

3、提供外部访问接口DAO(暂未完善)

这个插件的实现难点主要在于,使hibernate能获取到业务实体的Class实例。

通常的Configuration类的实现里,hibernate是对org.dom4j.Document的解析,获取类名,然后通过反射来实现获取实例的。

在osgi环境下,这种方式遇到了困难。

我们来使用另外几个jar包:

1、hibernate-annotations.jar

2、ejb3-persistence.jar

hibernate-annotations.jar提供一个AnnotationConfiguration

它继承于Configuration,但是提供了特别的对Class的处理。

如下:

 

@Override
    protected void parseMappingElement(Element subelement, String name) {
        Attribute rsrc = subelement.attribute( "resource" );
        Attribute file = subelement.attribute( "file" );
        Attribute jar = subelement.attribute( "jar" );
        Attribute pckg = subelement.attribute( "package" );
        Attribute clazz = subelement.attribute( "class" );
        if ( rsrc != null ) {
            log.debug( name + "<-" + rsrc );
            addResource( rsrc.getValue() );
        }
        else if ( jar != null ) {
            log.debug( name + "<-" + jar );
            addJar( new File( jar.getValue() ) );
        }
        else if ( file != null ) {
            log.debug( name + "<-" + file );
            addFile( file.getValue() );
        }
        else if ( pckg != null ) {
            log.debug( name + "<-" + pckg );
            addPackage( pckg.getValue() );
        }
        else if ( clazz != null ) {
            log.debug( name + "<-" + clazz );
            Class loadedClass = null;
            try {
                loadedClass = ReflectHelper.classForName( clazz.getValue() );
            }
            catch (ClassNotFoundException cnf) {
                throw new MappingException(
                        "Unable to load class declared as <mapping class=\"" + clazz.getValue() + "\"/> in the configuration:",
                        cnf
                );
            }
            catch (NoClassDefFoundError ncdf) {
                throw new MappingException(
                        "Unable to load class declared as <mapping class=\"" + clazz.getValue() + "\"/> in the configuration:",
                        ncdf
                );
            }

            addAnnotatedClass( loadedClass );
        }
        else {
            throw new MappingException( "<mapping> element in configuration specifies no attributes" );
        }
    }

 

注意addAnnotatedClass这个方法:

它的实现是:

public AnnotationConfiguration addAnnotatedClass(Class persistentClass) throws MappingException {
        XClass persistentXClass = reflectionManager.toXClass( persistentClass );
        try {
            annotatedClasses.add( persistentXClass );
            return this;
        }
        catch (MappingException me) {
            log.error( "Could not compile the mapping annotations", me );
            throw me;
        }
    }

 

于是我们可以猜想,被注册的Class已经维护在了annotatedClasses里。

事实上也是如此。

一个简单的Annotated实体类的定义如下:

package mos.hibernate.demo;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.persistence.TableGenerator;

/**
 * @author caiyu
 * @date 2012-10-11 下午2:41:21
 */
@Entity
@Table(name = "CAT")
public class Cat {
    @Id
    @TableGenerator(name = "CAT", allocationSize = 1)
    @GeneratedValue(strategy = GenerationType.TABLE, generator = "CAT")
    private int id;
    
    @Column(name="name")
    private String name;
    
    @Column(name="color")
    private String color;

    public Cat() {
    }

    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 String getColor() {
        return color;
    }

    public void setColor(String color) {
        this.color = color;
    }

    public String toString() {
        StringBuffer sb = new StringBuffer();
        sb.append("ID:");
        sb.append(id);
        sb.append("\n");
        sb.append("Name:");
        sb.append(name);
        sb.append("\n");
        sb.append("Color:");
        sb.append(color);
        sb.append("\n");
        return sb.toString();
    }
}

它不再需要另一个单独的XML文件来定义它的hibernate映射关系,这些映射关系已经被它本身的annotation定义描述出来了。

 

 

要注意的细节问题:

1、dom4j找不到驱动和NoClassDefFoundError问题,这是因为dom4j需要的xerces和xml-apis已经被jdk 1.4以及以后版本引入了,在config.properties配置里添加:

# The following property makes specified packages from the class path
# available to all bundles. You should avoid using this property.

org.osgi.framework.bootdelegation=javax.*,org.*

即是使jre下的javax.*和org.*对osgi的全部bundle可见。

当然也可以将xerces和xml-apis的合适版本插件化,但这样比较麻烦,且可能会导致类名重复的问题。

2、使用该整合的bundle,需要import如下package:

mos.hibernate.manager,org.hibernate,javax.persistence,org.hibernate.proxy,net.sf.cglib.proxy

posted @ 2012-10-16 11:50  荒土  阅读(4535)  评论(0编辑  收藏  举报