/*
 * 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.
 */

/* $Id: GenerationHelperContentHandler.java 1522934 2013-09-13 13:56:18Z gadams $ */

package org.apache.fop.util;

import org.xml.sax.Attributes;
import org.xml.sax.ContentHandler;
import org.xml.sax.SAXException;
import org.xml.sax.helpers.AttributesImpl;

import org.apache.xmlgraphics.util.QName;

This class is a delegating SAX ContentHandler which has the purpose to provide a few handy
methods that make life easier when generating SAX events.
/**
 * This class is a delegating SAX ContentHandler which has the purpose to provide a few handy
 * methods that make life easier when generating SAX events.
 */
public class GenerationHelperContentHandler extends DelegatingContentHandler {

    private static final Attributes EMPTY_ATTS = new AttributesImpl();

    private String mainNamespace;
    private Object contentHandlerContext;

    
Main constructor. If the given handler also implements any of the EntityResolver,
DTDHandler, LexicalHandler or ErrorHandler interfaces, these are set automatically.
Params:
handler – the SAX content handler to delegate all calls to
mainNamespace – the main namespace used for generated XML content when abbreviated
                         ContentHandler calls are used.
contentHandlerContext – additional content handler context state/**
     * Main constructor. If the given handler also implements any of the EntityResolver,
     * DTDHandler, LexicalHandler or ErrorHandler interfaces, these are set automatically.
     * @param handler the SAX content handler to delegate all calls to
     * @param mainNamespace the main namespace used for generated XML content when abbreviated
     *                          ContentHandler calls are used.
     * @param contentHandlerContext additional content handler context state
     */
    public GenerationHelperContentHandler(ContentHandler handler, String mainNamespace, Object contentHandlerContext) {
        super(handler);
        this.mainNamespace = mainNamespace;
        this.contentHandlerContext = contentHandlerContext;
    }

    
Returns the main namespace used for generated XML content.
Returns:
the main namespace/**
     * Returns the main namespace used for generated XML content.
     * @return the main namespace
     */
    public String getMainNamespace() {
        return this.mainNamespace;
    }

    
Sets the main namespace used for generated XML content when abbreviated ContentHandler
calls are used.
Params:
namespaceURI – the new main namespace URI/**
     * Sets the main namespace used for generated XML content when abbreviated ContentHandler
     * calls are used.
     * @param namespaceURI the new main namespace URI
     */
    public void setMainNamespace(String namespaceURI) {
        this.mainNamespace = namespaceURI;
    }

    
Returns the context object (may be null).
Returns:
the context object/**
     * Returns the context object (may be null).
     * @return the context object
     */
    public Object getContentHandlerContext() {
        return this.contentHandlerContext;
    }

    
Convenience method to generate a startElement SAX event.
Params:
localName – the local name of the element
atts – the attributes
Throws:
SAXException – if a SAX exception occurs/**
     * Convenience method to generate a startElement SAX event.
     * @param localName the local name of the element
     * @param atts the attributes
     * @throws SAXException if a SAX exception occurs
     */
    public void startElement(String localName, Attributes atts) throws SAXException {
        getDelegateContentHandler().startElement(getMainNamespace(), localName, localName, atts);
    }

    
Convenience method to generate a startElement SAX event.
Params:
localName – the local name of the element
Throws:
SAXException – if a SAX exception occurs/**
     * Convenience method to generate a startElement SAX event.
     * @param localName the local name of the element
     * @throws SAXException if a SAX exception occurs
     */
    public void startElement(String localName) throws SAXException {
        startElement(localName, EMPTY_ATTS);
    }

    
Convenience method to generate a startElement SAX event.
Params:
qName – the qualified name of the element
atts – the attributes
Throws:
SAXException – if a SAX exception occurs/**
     * Convenience method to generate a startElement SAX event.
     * @param qName the qualified name of the element
     * @param atts the attributes
     * @throws SAXException if a SAX exception occurs
     */
    public void startElement(QName qName, Attributes atts) throws SAXException {
        getDelegateContentHandler().startElement(qName.getNamespaceURI(), qName.getLocalName(),
                qName.getQName(), atts);
    }

    
Convenience method to generate a startElement SAX event.
Params:
qName – the qualified name of the element
Throws:
SAXException – if a SAX exception occurs/**
     * Convenience method to generate a startElement SAX event.
     * @param qName the qualified name of the element
     * @throws SAXException if a SAX exception occurs
     */
    public void startElement(QName qName) throws SAXException {
        startElement(qName, EMPTY_ATTS);
    }

    
Convenience method to generate a endElement SAX event.
Params:
localName – the local name of the element
Throws:
SAXException – if a SAX exception occurs/**
     * Convenience method to generate a endElement SAX event.
     * @param localName the local name of the element
     * @throws SAXException if a SAX exception occurs
     */
    public void endElement(String localName) throws SAXException {
        getDelegateContentHandler().endElement(getMainNamespace(), localName, localName);
    }

    
Convenience method to generate a startElement SAX event.
Params:
qName – the qualified name of the element
Throws:
SAXException – if a SAX exception occurs/**
     * Convenience method to generate a startElement SAX event.
     * @param qName the qualified name of the element
     * @throws SAXException if a SAX exception occurs
     */
    public void endElement(QName qName) throws SAXException {
        getDelegateContentHandler().endElement(qName.getNamespaceURI(), qName.getLocalName(),
                qName.getQName());
    }

    
Convenience method to generate an empty element with attributes.
Params:
localName – the local name of the element
atts – the attributes
Throws:
SAXException – if a SAX exception occurs/**
     * Convenience method to generate an empty element with attributes.
     * @param localName the local name of the element
     * @param atts the attributes
     * @throws SAXException if a SAX exception occurs
     */
    public void element(String localName, Attributes atts) throws SAXException {
        getDelegateContentHandler().startElement(getMainNamespace(), localName, localName, atts);
        getDelegateContentHandler().endElement(getMainNamespace(), localName, localName);
    }

    
Convenience method to generate an empty element with attributes.
Params:
qName – the qualified name of the element
atts – the attributes
Throws:
SAXException – if a SAX exception occurs/**
     * Convenience method to generate an empty element with attributes.
     * @param qName the qualified name of the element
     * @param atts the attributes
     * @throws SAXException if a SAX exception occurs
     */
    public void element(QName qName, Attributes atts) throws SAXException {
        getDelegateContentHandler().startElement(qName.getNamespaceURI(), qName.getLocalName(),
                qName.getQName(), atts);
        getDelegateContentHandler().endElement(qName.getNamespaceURI(), qName.getLocalName(),
                qName.getQName());
    }

}