你的位置:首页 > Java教程

[Java教程]Weblogic环境下hibernate、antlr类加载冲突问题分析及解决方案


公司应用项目在客户部署时经常遇到此类问题,为避免实施部署时增加配置量,花了点时间找到了此问题的终极解决办法(方案二、修改org.hibernate.hql.ast.HqlLexer的源代码)。在此进行记录本问题的分析解决方案。

一、问题现象描述:

1、异常信息:

'weblogic.kernel.Default (self-tuning)']…

org.hibernate.QueryException: ClassNotFoundException: org.hibernate.hql.ast.HqlToken [

 

    at org.hibernate.hql.ast.HqlLexer.panic(HqlLexer.java:57)

    at antlr.CharScanner.setTokenObjectClass(CharScanner.java:340)

    at org.hibernate.hql.ast.HqlLexer.setTokenObjectClass(HqlLexer.java:31)

    at antlr.CharScanner.<init>(CharScanner.java:51)

    at antlr.CharScanner.<init>(CharScanner.java:60)

    at org.hibernate.hql.antlr.HqlBaseLexer.<init>(HqlBaseLexer.java:56)

    at org.hibernate.hql.antlr.HqlBaseLexer.<init>(HqlBaseLexer.java:53)

    at org.hibernate.hql.antlr.HqlBaseLexer.<init>(HqlBaseLexer.java:50)

    at org.hibernate.hql.ast.HqlLexer.<init>(HqlLexer.java:26)

    at org.hibernate.hql.ast.HqlParser.getInstance(HqlParser.java:44)

    at org.hibernate.hql.ast.QueryTranslatorImpl.parse(QueryTranslatorImpl.java:242)

    atorg.hibernate.hql.ast.QueryTranslatorImpl.doCompile(QueryTranslatorImpl.java:157)

    at org.hibernate.hql.ast.QueryTranslatorImpl.compile(QueryTranslatorImpl.java:111)

    at org.hibernate.engine.query.HQLQueryPlan.<init>(HQLQueryPlan.java:77)

    at org.hibernate.engine.query.HQLQueryPlan.<init>(HQLQueryPlan.java:56)

    at org.hibernate.engine.query.QueryPlanCache.getHQLQueryPlan(QueryPlanCache.java:72)

    at org.hibernate.impl.SessionFactoryImpl.checkNamedQueries(SessionFactoryImpl.java:402)

    at org.hibernate.impl.SessionFactoryImpl.<init>(SessionFactoryImpl.java:352)

    at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:1294)


2、查询weblogic安装目录下的antlr包:

3、应用中引用的是hibernate3和antlr_2.7.6的jar

 

二、原因分析

根据以上异常信息查看hibernate及antlr的源代码:

org.hibernate.hql.ast.HqlLexer的部分代码:

public void setTokenObjectClass(String cl) {        

super.setTokenObjectClass( HqlToken.class.getName() );

        }

以上super.setTokenObjectClass 方法就是antlr.CharScanner类中定义的方法:

public void setTokenObjectClass(String paramString) {

    try {

      this.tokenObjectClass = Utils.loadClass(paramString);

    } catch (ClassNotFoundException localClassNotFoundException) {

      panic("ClassNotFoundException: " + paramString);

    }

}

此方法的关键部分:Utils.loadClass(paramString);即在hibernate在解析hql是会采用此工具加载org.hibernate.hql.ast.HqlToken类(即HqlLexer类中的setTokenObjectClass方法)。此处会发生什么情况呢,请看Utils.loadClass的源代码:

  static {

          if ("true".equalsIgnoreCase(System.getProperty("ANTLR_DO_NOT_EXIT", "false")))

              useSystemExit = false;

          if ("true".equalsIgnoreCase(System.getProperty("ANTLR_USE_DIRECT_CLASS_LOADING", "false")))

              useDirectClassLoading = true;

  }

 

    /** Thanks to Max Andersen at JBOSS and Scott Stanchfield */

    public static Class loadClass(String name) throws ClassNotFoundException {

        try {

            ClassLoader contextClassLoader =Thread.currentThread(). getContextClassLoader();

            if (!useDirectClassLoading && contextClassLoader!=null ) {

                return contextClassLoader.loadClass(name);

            }

            return Class.forName(name);

        }

        catch (Exception e) {

            return Class.forName(name);

        }

    }

 

从以上的代码可看处,加载org.hibernate.hql.ast.HqlToken类的类加载器是weblogic启动类加载器(不管是Thread.currentThread().getContextClassLoader()还是Class.forName,其中Class.forName采用的是Reflection.getCallerClass()的类加载器,即antlr的类加载器),并非应用类加载器。Weblogic类路径下已经存在antlr的jar包了,系统会优先使用weblogic下的antlr包,而weblogic类路径下并没有hibnate的jar包,所以在加载org.hibernate.hql.ast.HqlToken类是会抛出ClassNotFoundException: org.hibernate.hql.ast.HqlToken异常。

 

三、解决方案

    方案一、修改weblogic类加载器中antlr加载的优先级

  1. 拷贝应用中的包antlr-2.7.6.jar到%WL_HOME%\server\lib下 
  2. 修改% mydomain%\startWebLogic.cmd(.sh) : 
    在set CLASSPATH之前加上下面一句: 
    set PRE_CLASSPATH=%WL_HOME%\server\lib\antlr-2.7.6.jar; 
    在set CLASSPATH之后加上下面一句: 
    set CLASSPATH=%PRE_CLASSPATH%;%CLASSPATH% 

此方案并不总是有效(尤其是在osgi类型项目或者同一个weblogic域下部署多个项目的情况),当然根据笔者遇到的情况成功率也在95%以上。当此方案无效时可以采用方案二。

    方案二、修改org.hibernate.hql.ast.HqlLexer的源代码:

        加载org.hibernate.hql.ast.HqlToken类是,直接用hibernate所在类classload加载即可:

    将原来的代码:

  public void setTokenObjectClass(String cl) {        

super.setTokenObjectClass( HqlToken.class.getName() );

        }

 

    修改为:直接将hqltoken类赋值给this.tokenObjectClass

public void setTokenObjectClass(String cl) {

    this.tokenObjectClass = HqlToken.class;

}