/*
    * File: ManualContentHandlerHelper.java
    * Created: 3-čec-06 7:04:55 
    *
    * Copyright 2006 Michal Burda.
    *
    * This program is free software; you can redistribute it and/or modify
    * it under the terms of the GNU General Public License as published by
    * the Free Software Foundation; either version 2 of the License, or
   * (at your option) any later version.
   *
   * This program is distributed in the hope that it will be useful,
   * but WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   * GNU General Public License for more details.
   *
   * You should have received a copy of the GNU General Public License
   * along with this program; if not, write to the Free Software
   * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
   */
  package net.sf.webmancer.util.xml.sax;
  
  import java.util.Stack;
  
  import javax.xml.namespace.QName;
  
  import net.sf.webmancer.util.ContractChecker;
  
  import org.xml.sax.Attributes;
  import org.xml.sax.ContentHandler;
  import org.xml.sax.Locator;
  import org.xml.sax.SAXException;
  import org.xml.sax.helpers.AttributesImpl;
  
  /**
   * @author Michal Burda
   */
  public class ManualContentHandlerHelper {
      /**
       * @author Michal Burda
       */
      private static class StackItem {
          String uri;
  
          String localName;
  
          String qName;
  
          StackItem(final String uri, final String localName, final String qName) {
              this.uri = uri;
              this.localName = localName;
              this.qName = qName;
          }
      }
  
      /**
       * 
       */
      private ContentHandler handler;
  
      /**
       * 
       */
      private Stack<StackItem> openElements;
  
      /**
       * 
       */
      public ManualContentHandlerHelper(final ContentHandler handler) {
          super();
          ContractChecker.mustNotBeNull(handler, "handler");
          this.handler = handler;
          this.openElements = new Stack<StackItem>();
      }
  
      /**
       * @see org.xml.sax.ContentHandler#characters(char[], int, int)
       */
      public void characters(final char[] ch, final int start, final int length) throws SAXException {
          this.handler.characters(ch, start, length);
      }
  
      /**
       * @param str
       * @throws SAXException
       */
      public void characters(final String str) throws SAXException {
          if (str != null) {
              this.handler.characters(str.toCharArray(), 0, str.length());
          }
      }
  
      /**
       * @see org.xml.sax.ContentHandler#endDocument()
       */
      public void endDocument() throws SAXException {
          this.handler.endDocument();
      }
  
     /**
      * @throws SAXException
      */
     public void endElement() throws SAXException {
         StackItem item = this.openElements.pop();
         this.handler.endElement(item.uri, item.localName, item.qName);
     }
 
     /**
      * @see org.xml.sax.ContentHandler#endPrefixMapping(java.lang.String)
      */
     public void endPrefixMapping(final String prefix) throws SAXException {
         this.handler.endPrefixMapping(prefix);
     }
 
     /**
      * @see org.xml.sax.ContentHandler#ignorableWhitespace(char[], int, int)
      */
     public void ignorableWhitespace(final char[] ch, final int start, final int length) throws SAXException {
         this.handler.ignorableWhitespace(ch, start, length);
     }
 
     /**
      * @see org.xml.sax.ContentHandler#processingInstruction(java.lang.String, java.lang.String)
      */
     public void processingInstruction(final String target, final String data) throws SAXException {
         this.handler.processingInstruction(target, data);
     }
 
     /**
      * @see org.xml.sax.ContentHandler#setDocumentLocator(org.xml.sax.Locator)
      */
     public void setDocumentLocator(final Locator locator) {
         this.handler.setDocumentLocator(locator);
     }
 
     /**
      * @see org.xml.sax.ContentHandler#skippedEntity(java.lang.String)
      */
     public void skippedEntity(final String name) throws SAXException {
         this.handler.skippedEntity(name);
     }
 
     /**
      * @see org.xml.sax.ContentHandler#startDocument()
      */
     public void startDocument() throws SAXException {
         this.handler.startDocument();
     }
 
     /**
      * @see org.xml.sax.ContentHandler#startElement(java.lang.String, java.lang.String, java.lang.String,
      *      org.xml.sax.Attributes)
      */
     public void startElement(final String uri, final String localName, final String qName, final Attributes atts) throws SAXException {
         this.handler.startElement(uri, localName, qName, atts);
         this.openElements.push(new StackItem(uri, localName, qName));
     }
 
     /**
      * @param uri
      * @param localName
      * @param qName
      * @throws SAXException
      */
     public void startElement(final String uri, final String localName, final String qName) throws SAXException {
         startElement(uri, localName, qName, new AttributesImpl());
     }
 
     /**
      * @param uri
      * @param localName
      * @param atts
      * @throws SAXException
      */
     public void startElement(final String uri, final String localName, final Attributes atts) throws SAXException {
         startElement(uri, localName, localName, atts);
     }
 
     /**
      * @param uri
      * @param localName
      * @throws SAXException
      */
     public void startElement(final String uri, final String localName) throws SAXException {
         startElement(uri, localName, localName, new AttributesImpl());
     }
 
     /**
      * @param qName
      * @param atts
      * @throws SAXException
      */
     public void startElement(final QName qName, final Attributes atts) throws SAXException {
         StringBuffer qualified = new StringBuffer();
         String prefix = qName.getPrefix();
         if (prefix != null && prefix.length() > 0) {
             qualified.append(prefix).append(':');
         }
         qualified.append(qName.getLocalPart());
         startElement(qName.getNamespaceURI(), qName.getLocalPart(), qualified.toString(), atts);
     }
 
     /**
      * @param qName
      * @throws SAXException
      */
     public void startElement(final QName qName) throws SAXException {
         startElement(qName, new AttributesImpl());
     }
 
     /**
      * @param qName
      * @throws SAXException
      */
     public void startElementWithNsDeclaration(final QName qName) throws SAXException {
         AttributesImpl attrs = new AttributesImpl();
         attrs.addAttribute("http://www.w3.org/2000/xmlns/", "xmlns", "xmlns", "CDATA", qName.getNamespaceURI());
         startElement(qName, attrs);
     }
 
     /**
      * @param qName
      * @param atts
      * @param value
      * @throws SAXException
      */
     public void putElement(final QName qName, final Attributes atts, final String value) throws SAXException {
         startElement(qName, atts);
         characters(value);
         endElement();
     }
 
     /**
      * @param qName
      * @param value
      * @throws SAXException
      */
     public void putElement(final QName qName, final String value) throws SAXException {
         putElement(qName, new AttributesImpl(), value);
     }
 
     /**
      * @param qName
      * @param atts
      * @throws SAXException
      */
     public void putElement(final QName qName, final Attributes atts) throws SAXException {
         startElement(qName, atts);
         endElement();
     }
 
     /**
      * @param qName
      * @throws SAXException
      */
     public void putElement(final QName qName) throws SAXException {
         startElement(qName, new AttributesImpl());
         endElement();
     }
 
     /**
      * @see org.xml.sax.ContentHandler#startPrefixMapping(java.lang.String, java.lang.String)
      */
     public void startPrefixMapping(final String prefix, final String uri) throws SAXException {
         this.handler.startPrefixMapping(prefix, uri);
     }
 
 }