faultdata.java

bpel执行引擎用来执行bpel业务流程

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.ode.bpel.runtime.channels;

import org.apache.ode.bpel.o.OBase;
import org.apache.ode.bpel.o.OElementVarType;
import org.apache.ode.bpel.o.OMessageVarType;
import org.apache.ode.bpel.o.OVarType;
import org.apache.ode.utils.SerializableElement;
import org.w3c.dom.Element;

import javax.xml.namespace.QName;
import java.io.Serializable;


/**
 * Information about a BPEL fault.
 */
public class FaultData implements Serializable {
	private static final long serialVersionUID = 1L;

	/** Name of the fault. */
  private QName _faultName;

  /** MessageType of the fault. */
  private OVarType _faultVarType;

  private SerializableElement _faultMsg;

  private OBase _location;

	private final String _explanation;

  public FaultData(QName fault, OBase location, String explanation) {
    _faultName = fault;
    _location = location;
    _explanation = explanation;
  }

  public FaultData(QName fault, Element faultMsg, OVarType faultVarType, OBase location) {
    this(fault, location, null);
    assert faultMsg != null;
    assert faultVarType != null;
    assert faultVarType instanceof OMessageVarType || faultVarType instanceof OElementVarType;
    _faultMsg = new SerializableElement(faultMsg);
    _faultVarType = faultVarType;
  }

  /**
   * Return potential message associated with fault.
   * Null if no fault data.
   * @return fault message Element
   */
  public Element getFaultMessage() {
    return (_faultMsg == null)
           ? null
           : _faultMsg.getElement();
  }
  
  /**
   * The message type of the fault message data.  Null if no fault data.
   * @return fault type
   */
  public OVarType getFaultType(){
  	return _faultVarType;
  }

  /**
   * Get the fault name.
   *
   * @return qualified fault name.
   */
  public QName getFaultName() {
    return _faultName;
  }
  
  public int getFaultLineNo(){
  	return findLineNo(_location);
  }
  
  public String getExplanation() {
  	return _explanation;
  }

  public int getActivityId() {
    return _location.getId();
  }

  /**
   * Find the best line number for the given location.
   * @param location
   * @return line number
   */
  protected int findLineNo(OBase location) {
  	if (location == null)
  		return -1;
  	if (location.debugInfo == null)
  		return -1;
  	return location.debugInfo.startLine;
  }


  /**
   * @see java.lang.Object#toString()
   */
  public String toString(){
    StringBuilder sb = new StringBuilder("FaultData: [faultName=");
    sb.append(_faultName);
    sb.append(", faulType=");
    sb.append(_faultVarType);
    if (_explanation != null) {
    	sb.append(" (");
    	sb.append(_explanation);
    	sb.append(")");
    }
    
    sb.append("] @");
    sb.append(findLineNo(_location));
    return sb.toString();
  }

}