xmlqosbase.java

java开源的企业总线.xmlBlaster

/*------------------------------------------------------------------------------
Name:      XmlQoSBase.java
Project:   xmlBlaster.org
Copyright: xmlBlaster.org, see xmlBlaster-LICENSE file
Comment:   Handling one QoS (quality of service), knows how to parse it with SAX
Version:   $Id: XmlQoSBase.java 15124 2006-05-09 11:17:09Z ruff $
------------------------------------------------------------------------------*/
package org.xmlBlaster.util;

import java.util.Set;
import java.util.TreeSet;
import java.util.logging.Logger;

import org.xml.sax.Attributes;
import org.xmlBlaster.util.qos.ClientProperty;


/**
 * In good old C days this would have been named a 'flag' (with bit wise setting)<br />
 * But this allows to specify QoS (quality of service) in XML syntax.
 * <p />
 * With XML there are no problems to extend the services of the xmlBlaster in unlimited ways.<br />
 * The xml string is parsed with a SAX parser, since no persistent DOM tree is needed
 * and SAX is much faster.
 * <p />
 * You may use this as a base class for your specialized QoS.<br />
 * The &lt;qos> tag is parsed here, and you provide the parsing of the inner tags.
 */
public class XmlQoSBase extends SaxHandlerBase
{
   private static Logger log = Logger.getLogger(XmlQoSBase.class.getName());
   protected boolean inQos = false;     // parsing inside <qos> ? </qos>
   protected ClientProperty clientProperty;
   protected final Set clientPropertyTagNames = new TreeSet();
   private int inClientProperty;
   protected StringBuffer cpCharacter;

   /**
    * Constructs an un initialized QoS (quality of service) object.
    * You need to call the init() method to parse the XML string.
    */
   public XmlQoSBase()
   {
      this(null);
   }

   public XmlQoSBase(Global glob)
   {
      super(glob);
      this.clientPropertyTagNames.add(ClientProperty.CLIENTPROPERTY_TAG); // "clientProperty"
      this.clientPropertyTagNames.add(ClientProperty.ATTRIBUTE_TAG); // "attribute"
   }

   /**
    * To avoid SAX parsing (which costs many CPU cycles)
    * check the QoS string here if it contains anything useful.
    * @param qos The literal ASCII xml string
    */
   protected boolean isEmpty(String qos)
   {
      if (qos == null)
         return true;

      qos = qos.trim();

      if (qos.length() < 11) // minimum: "<qos/>" or "<qos></qos>"
         return true;

      String middle = qos.substring(5, qos.length()-6);
      if (middle.trim().length() < 1)
         return true;

      return false;
   }


   /**
    * Start element callback, does handling of tag &lt;qos>.
    * <p />
    * You may include this into your derived startElement() method like this:<br />
    * <pre>
    *  if (super.startElementBase(name, attrs) == true)
    *     return;
    * </pre>
    * @return true if the tag is parsed here, the derived class doesn't need to look at this tag anymore
    *         false this tag is not handled by this Base class
    */
   protected final boolean startElementBase(String uri, String localName, String name, Attributes attrs)
   {
      if (this.inClientProperty > 0) {
         if (this.clientPropertyTagNames.contains(name))
            this.inClientProperty++;

         addTagToString(this.cpCharacter, name, attrs);
         return true;
      }
      if (name.equalsIgnoreCase("qos")) {
         inQos = true;
         return true;
      }
      if (!inQos) {
         log.warning("Ignoring unknown element '" + name + "'.");
         character.setLength(0);
         Thread.dumpStack();
         return true;
      }
      if (this.clientPropertyTagNames.contains(name)) {
         this.inClientProperty++;
         if (this.cpCharacter == null) this.cpCharacter = new StringBuffer();
         this.clientProperty = new ClientProperty(attrs.getValue("name"), attrs.getValue("type"), attrs.getValue("encoding"));
         String charset = attrs.getValue("charset");
         if (charset != null && charset.length() > 0)
            this.clientProperty.setCharset(charset);
         character.setLength(0);
         return true;
      }
      return false;
   }

   protected static void addTagToString(StringBuffer buf,  String tagName, Attributes attrs) {
      buf.append("<").append(tagName);
      if (attrs == null || attrs.getLength() < 1)
         return;
      for (int i=0; i < attrs.getLength(); i++) {
         buf.append(" ").append(attrs.getQName(i)).append("='").append(attrs.getValue(i)).append("'");
      }
      buf.append(">");
   }
   
   /**
    * Characters.
    * The text between two tags, in the following example 'Hello':
    * <key>Hello</key>
    */
   public void characters(char ch[], int start, int length) {
      if (this.inClientProperty > 0) {
         this.cpCharacter.append(ch, start, length);
      }
      else { 
         super.characters(ch, start, length);
      }
   }

   /**
    * Start element.
    * <p />
    * Default implementation, knows how to parse &lt;qos> but knows nothing about the tags inside of qos
    */
   public void startElement(String uri, String localName, String name, Attributes attrs) throws org.xml.sax.SAXException
   {
      startElementBase(uri, localName, name, attrs);
   }


   /**
    * End element callback, does handling of tag &lt;qos>.
    * <p />
    * You may include this into your derived endElement() method like this:<br />
    * <pre>
    *  if (super.endElementBase(name) == true)
    *     return;
    * </pre>
    * @return true if the tag is parsed here, the derived class doesn't need to look at this tag anymore
    *         false this tag is not handled by this Base class
    */
   protected final boolean endElementBase(String uri, String localName, String name) {
      if( name.equalsIgnoreCase("qos") && (this.inClientProperty < 1)) {
         inQos = false;
         character.setLength(0);
         return true;
      }

      if (this.clientPropertyTagNames.contains(name)) {
         this.inClientProperty--;
         if (this.inClientProperty < 1) {
            if (this.clientProperty != null) {
               String tmp = (this.clientProperty.isStringType()) ? this.cpCharacter.toString() : this.cpCharacter.toString().trim();
               if (this.clientProperty.isStringType() && !this.clientProperty.isBase64())
                  this.clientProperty.setValue(tmp);
               else
                  this.clientProperty.setValueRaw(tmp);
            }
            this.cpCharacter.setLength(0);
            return true;
         }
      }

      if (this.inClientProperty > 0) {
         this.cpCharacter.append("</").append(name).append(">");
         return true;
      }

      return false;
   }


   /** End element.
    * <p />
    * Default implementation, knows how to parse &lt;qos> but knows nothing about the tags inside of qos
    */
   public void endElement(String uri, String localName, String name) throws org.xml.sax.SAXException
   {
      endElementBase(uri, localName, name);
   }
}