iqserviceshandler.java

一款即时通讯软件

/*
 *   License
 *
 * The contents of this file are subject to the Jabber Open Source License
 * Version 1.0 (the "License").  You may not copy or use this file, in either
 * source code or executable form, except in compliance with the License.  You
 * may obtain a copy of the License at http://www.jabber.com/license/ or at
 * http://www.opensource.org/.  
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied.  See the License
 * for the specific language governing rights and limitations under the
 * License.
 *
 *   Copyrights
 *
 * Portions created by or assigned to Jabber.com, Inc. are 
 * Copyright (c) 2000 Jabber.com, Inc.  All Rights Reserved.  Contact
 * information for Jabber.com, Inc. is available at http://www.jabber.com/.
 *
 * Portions Copyright (c) 1999-2000 David Waite 
 *
 *   Acknowledgements
 * 
 * Special thanks to the Jabber Open Source Contributors for their
 * suggestions and support of Jabber.
 * 
 *   Changes
 *
 * @author  $Author: chris $
 * @version $Revision: 1.1 $
 *
 * j.komzak
 * Changed in IQServicesHandler for BuddySpace services namespace.
 */

package edu.ou.kmi.buddyspace.xml;

import org.jabber.jabberbeans.sax.HandlerFactory;
import org.jabber.jabberbeans.sax.SubHandler;
import org.jabber.jabberbeans.Extension.Extension;
import org.jabber.jabberbeans.sax.Extension.HashExtensionHandler;
import org.xml.sax.SAXException;
import org.xml.sax.AttributeList;

/**
 * Handler class to build jabber:iq:register objects. All work is
 * done by the HashExtensionHandler.
 *
 * @author  David Waite <a href="mailto:[e-mail]">
 *                      <i>&lt;[e-mail]&gt;</i></a>
 * @author  $Author: chris $
 * @version $Revision: 1.1 $ 
 *
 * @author  Jiri Komzak <a href="mailto:[e-mail]">
 *                      <i>&lt;[e-mail]&gt;</i></a>
 * @author  $Author: chris $
 * @version $Revision: 1.1 $
 */
public class IQServicesHandler extends /*SubHandler {*/ HashExtensionHandler {
    
    /** StringBuffer holding data between elements */
    //protected StringBuffer elementChars;
    
    /** builder to construct the product extension object */
    //protected IQServicesBuilder builder;

    /**
     * Creates a new <code>IQServicesHandler</code> instance.
     */
    public IQServicesHandler() 
    {
        super();
        builder = new IQServicesBuilder();
    }
    
    /**
     * Gets called when the underlying engine decides to pass an entity and
     * all sub-entities off to your subhandler.<p>
     *
     * Upon seeing the element that this subhandler handles, we call this
     * constructor, passing in the attributes.
     *
     * @param name name of the element which we are handling.
     * @param attributes list of attributes on this element
     */
    protected void startHandler(String name, AttributeList attributes)
	throws SAXException
    { 
	elementChars=new StringBuffer();
	builder.reset();
        
        if("query".equals(name))
            ((IQServicesBuilder)builder).setIQ(true);
        else
            ((IQServicesBuilder)builder).setIQ(false);
    }
        
    
    /*
     * <code>handleStartElement</code> is overloaded by the new class to
     * provide logic to handle the element code.
     *
     * @param name a <code>String</code> value
     * @param attributes an <code>AttributeList</code> value
     * @exception SAXException if an error occurs
     */
    protected void handleStartElement(String name, AttributeList attributes) throws SAXException
    {			
            elementChars=new StringBuffer();

            //Start new handler for items that *may* be containers, but never for namespaces "ns".
            /*if("x".equals(name) && 
               "jabber:x:data".equals(attributes.getValue("xmlns"))) {
                
                setChildSubHandler(new XDataHandler(), name, attributes);
                //setChildSubHandler(new LayerTagHandler(), name, attributes);
                return;
            }*/
            
            // if this is has a handler, we switch off to it.
            HandlerFactory hf = getHandlerFactory();
            SubHandler newHandler = hf.getHandlerInstance(name, attributes);
            if (newHandler != null) {
                setChildSubHandler(newHandler, name, attributes);
                return;
            }
    }

    
    /*
     * <code>receiveChildData</code> is called when a child handler exits,
     * returning control to this code. The now-defunct handler along with the
     * data object are both returned.
     *
     * @param subHandler a <code>SubHandler</code> value
     * @param o an <code>Object</code> value
     */
    protected void receiveChildData(SubHandler subHandler, Object o)
    {
            //Add the returned object to the child vector
            ((IQServicesBuilder)builder).addExtension((Extension)o);
    }
	
}