Hibernate的Antlr在Weblogic中产生Jar冲突的历史缘故以及解决办法

Hibernate的Antlr在Weblogic中产生Jar冲突的历史缘故以及解决办法

Hibernate使用的文法分析器是antlr， WebLogic同样也是。
不少 用户碰到ClassNotFoundException: org. hibernate.hql.ast.HqlToken的典型问题，这个典型问题已经通过
配置 weblogic. xml，要求Web 应用优先加载WEB-INF的Jar（即应用Classloader）而非WebLogic的System Classloader得以勉强 解决：
<weblogic-web-app>
  <container-descriptor>
    <prefer-web-inf-classes>true</prefer-web-inf-classes>
  </container-descriptor>
</weblogic-web-app>


Hibernate 3.0的用户发现上述的方法依然不能解决问题，因为Hibernate使用了Class.forName去Load一个类，而 JVM加载类的方式是先System Classloader（WebLogic），后Application Classloader(Web应用)，于是，应用即使采用prefer-web-inf-classes策略，但Class.forName还是 Load了WebLogic的Antlr！！

Hibernate 3.1迅速解决了这个问题，Hibernate会使用context classloader，Class.forName这种罪恶的 代码已经被消除掉。

无独有偶，2005年，澳大利亚的Suncorp-Metway公司使用Hibernate3.0.3 + WebLogic8.1SP4 开发他们的应用 , 当时的WebLogic 8.1SP4内置了antlr 2.7.1，跟Hibernate  3.0.3捆绑的antlr-2.7.5H3.jar冲突，Suncorp-Metway公司希望改变 WebLogic的SystemClassPath（加入antlr-2.7.5H3.jar），效果等于替换了WebLogic的Antlr，这当然能够解决Hibernate的问题，但天知道会带来什么问题，因为WebLogic自身会使用Antlr去分析EJBQL（如果不适用CMP，用户完全可以不管3721，置换WebLogic的Antlr版本了之），Suncorp-Metway公司担心这种替换对 系统带来其他影响，希望 BEA仍然能够提供技术支持。
当时，作为BEA在澳大利亚昆士兰州最大的BEA客户，他们的建议当然受到足够的尊重。 为此，BEA 8.1 SP4/SP5都提供了一个补丁，等同于升级了WebLogic 8.1自带的Antlr的版本，WebLogic 8.1SP6以及WebLogic 9.1开始都沿用这个变更。

很明显，这种办法不可能再次沿用到以后的SP，因为Antlr以及Hibernate的版本的更新速度远远高于WebLogic Service pack的更新速度，BEA不可能不断地重构Antlr来适应开源日新月异的API变化。

WebLogic 8.1 SP6之后，当使用Hibernate 3（策略是<prefer-web-inf-classes>true</prefer-web-inf-classes>）的 Antlr 2.7.6时候，轮到WebLogic自身的Servlet容器出问题（Hibernate好了，WebLogic出事了）抛出如下的Antlr异常:
java.lang.ClassCastException: antlr.CommonToken
at antlr.CharScanner.makeToken(CharScanner.java:175)
at weblogic.servlet.jsp.JspLexer.mWORD(JspLexer.java:4723)
at weblogic.servlet.jsp.JspLexer.mXML_ATTRIBUTES(JspLexer.java:4309)
at weblogic.servlet.jsp.JspLexer.mTAGLIB_DIRECTIVE_BODY(JspLexer.java:5034)
at weblogic.servlet.jsp.JspLexer.mTAGLIB_DIRECTIVE(JspLexer.java:4905)
at weblogic.servlet.jsp.JspLexer.mDIRECTIVE(JspLexer.java:4751)
at weblogic.servlet.jsp.JspLexer.mSTANDARD_THING(JspLexer.java:2161)
at weblogic.servlet.jsp.JspLexer.mTOKEN(JspLexer.java:1947)
at weblogic.servlet.jsp.JspLexer.nextToken(JspLexer.java:1820)
at weblogic.servlet.jsp.JspLexer.nextToken(JspLexer.java:1820)
at weblogic.servlet.jsp.JspLexer.parse(JspLexer.java:963)
at weblogic.servlet.jsp.JspParser.doit(JspParser.java:106)
at weblogic.servlet.jsp.JspParser.parse(JspParser.java:234)
at weblogic.servlet.jsp.Jsp2 Java.outputs(Jsp2Java.java:125)

这个问题是WebLogic Servlet容器没有意识到Hibernate用户对ANTLR的版本需求:
1) 在老的Antlr 2.7.1中，WebLogic的Servlet容器使用antlr.CharScanner通过下面的方法  Class.forName(String className) 加载token，因为jsp 编译的 classes本身是基于WebLogic系统Classloader，于是，Classloader当然使用WebLogic的Antlr版本 (2.7.1)，WebLogic没有被Hibernate的Antlr(2.7.6)所影响，Class.forName转型成System CL所规约的 antlr.CommonToken不会有问题。
2) 而当WebLogic Antlr 2.7.1+Hibernate Antlr2.7.6一起使用的时候，Servlet容器在CharScanner使用 Class.forName(String, boolean, ClassLoader)去加载token，而第三个 参数是注入了当前的应用的Classloader，即WebLogic被迫使用了Hibernate的Antlr 2.7.6，而最终会导致容器在将Antlr 2.7.6的 CommonToken转型成Antlr 2.7.1的CommonToken出现java.lang.ClassCastException。
讲述了这么多东西，其实，最终想揭示的问题是，无论是Hibernate和WebLogic，在一开始的时候都没有意识到开源代码重构的重要性。早期的 WebLogic确实已经XML Parser付出版本冲突的代价，所以后期，很多XML包都被WebLogic重新Rename Package（重构代码的一种方式）。 如果一开始，WebLogic就使用com.bea. opensource.antlr来让自己的容器使用Antlr，ANTLR冲突的这些问题肯定不会出现。

解决方法:
修改% mydomain% \ startWebLogic.cmd ：
在set CLASSPATH之前加上下面一句：
set PRE_CLASSPATH=%WL_HOME%\server\lib\antlr-2.7.5H3.jar;
在set CLASSPATH之后加上下面一句：
set CLASSPATH=%PRE_CLASSPATH%;%CLASSPATH%
一切OK！