JBPM4常用错误汇总

1.在tomcat6.0下布署错误
   基于JBPM4的web项目jsp页面发布出错
现象：
   javax.servlet.ServletException: java.lang.LinkageError: loader constraint violation: when resolving interface method "javax.servlet.jsp.JspApplicationContext.getExpressionFactory()Ljavax/el/ExpressionFactory;" the class loader (instance of org/apache/jasper/servlet/JasperLoader) of the current class, org/apache/jsp/OnDuty/wfmanage_jsp, and the class loader (instance of org/apache/catalina/loader/StandardClassLoader) for resolved class, javax/servlet/jsp/JspApplicationContext, have different Class objects for the type javax/el/ExpressionFactory used in the signature
       org.apache.jasper.servlet.JspServlet.service(JspServlet.java:275)
       javax.servlet.http.HttpServlet.service(HttpServlet.java:717)
。。。

原因：
   项目中WEB-INF\lib中的三个jar包(juel.jar, juel-engine.jar, juel-impl.jar)和tomcat6下lib中jar包(el-api.jar)冲突

解决方法：
   方法一：换成tomcat5.5 一点问题也没有了
   方法二：将juel.jar, juel-engine.jar, juel-impl.jar这三个包复制到tomcat6下lib中，并删除原来的el-api.jar，切记要把WEB-INF\lib中的juel.jar, juel-engine.jar, juel-impl.jar删除。不然还是要冲突。

2.无法保存(布署)含有中文的流程定义文件
现象：
保存流程定义文件
   <?xml version="1.0" encoding="GBK"?>
   <process name="leave" xmlns="http://jbpm.org/4.0/jpdl">
      <start g="201,14,48,48" name="开始">
         <transition g="-42,-10" name="请假" to="填写请假单"/>
      </start>
      ...
提示错误：
   MalformedByteSequenceException:Invalid byte 1 of 1-byte UTF-8 sequence

原因：
   XML字符串大概经过了下面一些方法才被解析为DOM：
org.jbpm.pvm.internal.repository.DeploymentImpl：
  public NewDeployment addResourceFromString(String resourceName, String text) { 
      addResourceFromStreamInput(resourceName, new StringStreamInput(text)); 
      return this; 
  } 
public NewDeployment addResourceFromString(String resourceName, String text) {
  addResourceFromStreamInput(resourceName, new StringStreamInput(text));
  return this;
}

org.jbpm.pvm.internal.stream.StringStreamInput：
   public class StringStreamInput extends StreamInput { 
      String string; 
      public StringStreamInput(String string) { 
        this.name = "string"; 
        this.string = string; 
      } 
     public InputStream openStream() { 
       byte[] bytes = string.getBytes(); 
       return new ByteArrayInputStream(bytes); 
     } 
   } 
public class StringStreamInput extends StreamInput {
  String string;
  public StringStreamInput(String string) {
    this.name = "string";
    this.string = string;
  }
  public InputStream openStream() {
    byte[] bytes = string.getBytes();
    return new ByteArrayInputStream(bytes);
  }
}

org.jbpm.pvm.internal.xml.Parse：
    protected InputSource getInputSource() { 
      if (inputSource!=null) { 
        return inputSource; 
      } 
      if (streamInput!=null) { 
        inputStream = streamInput.openStream(); 
        return new InputSource(inputStream); 
      } 
     addProblem("no source specified to parse"); 
     return null; 
   } 
protected InputSource getInputSource() {
  if (inputSource!=null) {
    return inputSource;
  }
  if (streamInput!=null) {
    inputStream = streamInput.openStream();
    return new InputSource(inputStream);
  }
  addProblem("no source specified to parse");
  return null;
}

org.jbpm.pvm.internal.xml.Parser：
    protected Document buildDom(Parse parse) { 
      Document document = null; 
      try { 
        SAXParser saxParser = saxParserFactory.newSAXParser(); 
        XMLReader xmlReader = saxParser.getXMLReader(); 
        // ... 
         
       InputSource inputSource = parse.getInputSource();  
       xmlReader.parse(inputSource); 
    
     } catch (Exception e) { 
       parse.addProblem("couldn't parse xml document", e); 
     } 
    
     return document; 
   } 
   经过层层包装、拆包、再包装再拆包，可怜的字符串终于来到SAX解析器的手上。问题是jBPM在中间调用了String.getBytes()：这个方法会把Java字符串（Unicode）转换为系统默认编码并返回对应的byte[]，但当InputSource中没有设置编码信息时，SAXParser默认是以UTF-8编码来读取输入流的。我的开发机的系统默认编码是GBK，于是就出问题了。

解决方法：
   String xmlStr = "<?xml version=\"1.0\" encoding=\"" + System.getProperty("file.encoding") + "\"?><test name=\"名称\"></test>";
   这里就用System.getProperty("file.encoding")去获取系统默认编码，以便于String.getBytes()匹配。
   如果你能确保你的WEB服务器上运行的字符集是GBK，也可以写成
<?xml version="1.0" encoding="GBK"?>
<process name="leave" xmlns="http://jbpm.org/4.0/jpdl">
   <start g="201,14,48,48" name="开始">
      <transition g="-42,-10" name="请假" to="填写请假单"/>
   </start>
   ...

3.无法保存(布署)含有中文的流程定义文件
现象：
   流程定义已经成功保存到数据库中，但无法执行，
   数据库表jbpm4_execution中的任务名称为乱码

原因：
   数据库中任务名称为乱码的根本原因不是hiberate保存到jbpm4_lob中的字段BLOB_VALUE造成的。而是JSP页面传递给servlet流程定义文本时，中文转码错误造成的。即servlet接收的即乱码。

解决方法
  1）JSP页面中显示中文乱码
     在JSP文件中使用page命令指定响应结果的MIME类型，如<%@ page language="java" contentType="text/html;charset=gbk" %>
  2）表单提交乱码  
    表单提交时（post和Get方法），使用request.getParameter方法得到乱码，这是因为tomcat处理提交的参数时默认的是iso-8859-1，表单提交get和post处理乱码问题不同，下面分别说明。
    (1)POST处理
    对post提交的表单通过编写一个过滤器的方法来解决，过滤器在用户提交的数据被处理之前被调用，可以在这里改变参数的编码方式，过滤器的代码如下：
Java代码
package example.util;
   
    import java.io.IOException;
    import javax.servlet.Filter;
    import javax.servlet.FilterChain;
    import javax.servlet.FilterConfig;
    import javax.servlet.ServletException;
    import javax.servlet.ServletRequest;
    import javax.servlet.ServletResponse;
   
    public class SetCharacterEncodingFilter implements Filter {
       protected String encoding = null;
       protected FilterConfig filterConfig = null;
       protected boolean ignore = true;
   
     public void destroy() {
      this.encoding = null;
      this.filterConfig = null;
     }
   
     public void doFilter(ServletRequest request, ServletResponse response,
       FilterChain chain) throws IOException, ServletException {
          if (ignore || (request.getCharacterEncoding() == null)) {
       String encoding = selectEncoding(request);
       if (encoding != null) {
        request.setCharacterEncoding(encoding);
       }
      }
   
      // Pass control on to the next filter
      chain.doFilter(request, response);
   
     }
    public void init(FilterConfig filterConfig) throws ServletException {
   
      this.filterConfig = filterConfig;
      this.encoding = filterConfig.getInitParameter("encoding");
      String value = filterConfig.getInitParameter("ignore");
      if (value == null) {
       this.ignore = true;
      } else if (value.equalsIgnoreCase("true")) {
       this.ignore = true;
      } else if (value.equalsIgnoreCase("yes")) {
       this.ignore = true;
      } else {
       this.ignore = false;
      }
   
     }
   
     protected String selectEncoding(ServletRequest request) {
   
      return (this.encoding);
   
     }
   
    }

web.xml文件加入过滤器
<filter>
    <filter-name>Encoding</filter-name>
    <filter-class>
            example.util.SetCharacterEncodingFilter
     </filter-class>
    <init-param>
   <param-name>encoding</param-name>
   <param-value>gbk</param-value>
   <!--gbk或者gb2312或者utf-8-->
  </init-param>
  <init-param>
   <param-name>ignore</param-name>
   <param-value>true</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>Encoding</filter-name>
  <servlet-name>/*</servlet-name>
</filter-mapping>

(2) Get方法的处理
tomcat对post和get的处理方法不一样，所以过滤器不能解决get的乱码问题，它需要在其他地方设置。
打开<tomcat_home>\conf目录下server.xml文件，找到对8080端口进行服务的Connector组件的设置部分，给这个组件添加一个属性：URIEncoding="GBK"。修改后的Connector设置为：
 
<Connector port="8080" maxHttpHeaderSize="8192"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="GBK" />
  * 注意修改后重新启动tomcat才能起作用。

4.运行出错时，数据库中的所有数据丢失
现象：
   运行出错后，数据库中的所有数据丢失，包括流程定义文件

原因：
   jbpm.hibernate.cfg.xml文件中有一个配置
   <property name="hibernate.hbm2ddl.auto" value="create-drop"/>

   几个参数的意思，我解释一下：
   validate    加载hibernate时，验证创建数据库表结构
   create      每次加载hibernate，重新创建数据库表结构，这就是导致数据库表数据丢失的原因。
   create-drop 加载hibernate时创建，退出是删除表结构
   update      加载hibernate自动更新数据库结构
   none        不进行任何操作

   由于jbpm4的默认配置为create-drop，所以出现以上问题

解决方法：
   将jbpm.hibernate.cfg.xml文件中修改如下
   <property name="hibernate.hbm2ddl.auto" value="none"/>

5.在eclipse3.5流程设计器上设计流程时，中文出现乱码
现象：
   将流程设计好之后，点击保存，再查看代码，发现中文是乱码

原因：
   不清楚，应该是插件的bug

解决方法：
   将流程设计好之后，不要点保存，先将界面切换到代码窗口，这时可以看到中文，再点击保存

6.无法布署zip流程定义文件
现象：
   提示以下错误
   streams type cannot be used in batching
   2009-11-26 15:58:07 org.hibernate.event.def.AbstractFlushingEventListener performExecutions
   严重: Could not synchronize database state with session
   org.hibernate.exception.GenericJDBCException: could not insert: [org.jbpm.pvm.internal.lob.Lob]

原因：
   当把数据值增加超过100时,hiberate就出现了这个异常--这意味着Oracle JDBC不允许流操作以批量方式执行

解决方法：
   在jbpm.hibernate.cfg.xml文件的<session-factory>下，添加
     <property name="hibernate.jdbc.batch_size">0</property>
   即可

7.无法布署zip流程定义文件
现象：
   提示错误
   Could not synchronize database state with session
   org.hibernate.exception.GenericJDBCException: could not insert: [org.jbpm.pvm.internal.lob.Lob]

原因：
   布署ZIP流程定义文件时hiberate无法插入blob
   用网络上提议的方法，添加以下配置
     <property name="hibernate.jdbc.batch_size">0</property>
     <property name="hibernate.jdbc.use_streams_for_binary">true</property>
   也不行

解决方法：
   采用以上方法，还是无法通过，最后重启操作系统，就解决了，奶奶的。

8.布署zip流程定义文件成功，但是数据库中中文为乱码
现象：
   <?xml version="1.0" encoding="GBK"?>
   <process name="leave" xmlns="http://jbpm.org/4.0/jpdl">
      <start g="201,14,48,48" name="开始">
         <transition g="-42,-10" name="请假" to="填写请假单"/>
      </start>
      ...
   由于我的oracle9数据库格式为GBK，所以XML文件头为<?xml version="1.0" encoding="GBK"?>
   含有中文的流程定义zip文件已经成功保存到了blob字段内，但是中文名为乱码
   或者提示XML parse error，无法保存到数据库

原因：
   repositoryService.createDeployment().addResourcesFromZipInputStream(new ZipInputStream(item.getInputStream())).deploy();
   仅上面一句话，就不知道转了多少次编码，经过测试发现，还是编码方式的问题，最后决定将jbpm4.2的源代码复制到项目中来调试。

解决方法：
   在网上发现了这篇文章《Java中压缩与解压--中文文件名乱码解决办法》
   结果问题还是没有解决
   最后经过测试，将org.jbpm.pvm.internal.repository.DeploymentImpl类中的方法进行修改
   public NewDeployment addResourcesFromZipInputStream(CnZipInputStream zipInputStream) {
        try {
          ZipEntry zipEntry = zipInputStream.getNextEntry();
          while(zipEntry!=null) {
            String entryName = zipEntry.getName();
            byte[] bytes = IoUtil.readBytes(zipInputStream);
           
            //如果是流程定义文件(不是图片)，则重新编码，再生成字节数组
            if(entryName.endsWith(".xml")){
                String s=new String(bytes,"utf-8");
                bytes=s.getBytes();
            }
                
            if (bytes!=null) {
              addResourceFromStreamInput(entryName, new ByteArrayStreamInput(bytes));
            }
            zipEntry = zipInputStream.getNextEntry();
          }
        } catch (Exception e) {
          throw new JbpmException("couldn't read zip archive", e);
        }
        return this;
      }
   问题解决，肯定是开始有一步编码方式是用UTF-8，中间你就是再怎么用GBK转码，都不会成功，这里先用UTF-8编码生成字符串，再转一次编码就成功了。

参考文献
1.dzq2008. JBPM4项目和tomcat6.0的兼容问题. http://dzq0371.iteye.com/blog/509632
2.碰到jBPM的编码问题了. http://rednaxelafx.iteye.com/blog/522436
3.如何解决Tomcat下中文乱码问题. http://www.iteye.com/topic/251743?page=1
4.关于Hibernate一个配置参数hibernate.hbm2ddl.auto. http://linshiquan.iteye.com/blog/263170