soapobject.java

j2me手机看交通监视器实时录像源码,包含文档说明

/* kSOAP
 *
 * The contents of this file are subject to the Enhydra Public License
 * Version 1.1 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License
 * on the Enhydra web site ( http://www.enhydra.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 terms governing rights and limitations
 * under the License.
 *
 * The Initial Developer of kSOAP is Stefan Haustein. Copyright (C)
 * 2000, 2001 Stefan Haustein, D-46045 Oberhausen (Rhld.),
 * Germany. All Rights Reserved.
 *
 * Contributor(s): John D. Beatty, Dave Dash, Andre Gerard, F. Hunter,
 * Renaud Tognelli
 *
 * */
 

package org.ksoap;

import java.util.Vector;
import org.kobjects.serialization.*;


/** A simple dynamic object that can be used to build
    soap calls without implementing KvmSerializable */ 

/** 
 * A simple dynamic object that can be used to build soap calls without 
 * implementing KvmSerializable 
 * <p>Essentially, this is what goes inside the body of a soap envelope - 
 * it is the direct subelement of the body and all further subelements</p>
 * <p>Instead of this this class, custom classes
 * can be used if they implement the KvmSerializable interface. </p>
 */ 

public class SoapObject implements KvmSerializable {

    String namespace;
    String name;
    Vector info = new Vector ();
    Vector data = new Vector ();
    /**
     * Creates a new <code>SoapObject</code> instance.
     *
     * @param namespace the namespace for the soap object
     * @param name the name of the soap object
     */

    public SoapObject (String namespace, String name) {
	this.namespace = namespace;
	this.name = name;
    }


    public boolean equals (Object o) {
	if (!(o instanceof SoapObject)) return false;
	
	SoapObject so = (SoapObject) o;
	int cnt = data.size ();

	if (cnt != so.data.size ()) return false;

	try {
	    for (int i = 0; i < cnt; i++) 
		if (!data.elementAt (i).equals 
		    (so.getProperty (((PropertyInfo) info.elementAt (i)).name))) 
		    return false;
	}
	catch (Exception e) {
	    return false;
	}
	return true;
    }
    
    
    public String getName () {
	return name;
    }


    public String getNamespace () {
	return namespace;
    }


     /**
     * Returns a specific property at a certain index. 
     *  
     * @param index the index of the desired property
     * @return the desired property
     */
    public Object getProperty (int index) {
	return data.elementAt (index);
    }
    

    public Object getProperty (String name) {

	for (int i = 0; i < data.size (); i++) {
	    if (name.equals (((PropertyInfo) info.elementAt (i)).name))
		return data.elementAt (i);
	}

	throw new RuntimeException ("illegal property: "+name);
    }


     /**
     * Returns the number of properties
     *
     * @return the number of properties
     */

    public int getPropertyCount () {
	return data.size ();
    }

     /**
     * Places PropertyInfo of desired property into a designated PropertyInfo
     * object
     *
     * @param index index of desired property
     * @param info designated retainer of desired property
     */

    public void getPropertyInfo (int index, PropertyInfo pi) {
	PropertyInfo p = (PropertyInfo) info.elementAt (index);
	pi.name = p.name;
	pi.copy (p);
    }

    
  
    /**
     * Creates a new SoapObject based on this, allows usage of SoapObjects 
     * as templates. One application is to set the expected return type 
     * of a soap call if the server does not send explicit type information.
     *
     * @return a copy of this.
     */ 
 
    public SoapObject newInstance () {
	SoapObject o = new SoapObject (namespace, name);
	for (int i = 0; i < data.size (); i++) {
	    PropertyInfo p = (PropertyInfo) info.elementAt (i);
	    o.addProperty (p.name, p, data.elementAt (i));
	}
	return o;
    }
    

    /**
     * Sets a specified property to a certain value.
     *
     * @param index the index of the specified property
     * @param value the new value of the property
     */
    public void setProperty (int index, Object value) {
	data.setElementAt (value, index);
    }
    
    
    /**
     * Adds a property (parameter) to the object.  This is essentially
     * a sub element.
     *
     * @param name The name of the property
     * @param value the value of the property
     */
    public SoapObject addProperty (String name, Object value) {

	return addProperty 
	    (new PropertyInfo 
		(name, value == null 
		 ? ElementType.OBJECT_CLASS 
		 : value.getClass ()), 
	     value);
    }
    
    
    /** @deprecated
	Adds a property (parameter) to the object.  This is essentially
	a sub element.
	
	@param name the name of the property
	@param type the type or class of the element
	@param value the value of the property
    */

    public SoapObject addProperty (String name, ElementType type, 
				   Object value) {

	PropertyInfo p = new PropertyInfo ();
	p.copy (type);
	p.name = name;
	return addProperty (p, value);
    }


    /** Adds a property (parameter) to the object.  This is
	essentially a sub element.
	
	@param name the name of the property
	@param type the type or class of the element
	@param value the value of the property */

    public SoapObject addProperty (PropertyInfo pi, Object value) {
	info.addElement (pi);
	data.addElement (value);
	return this;
    }

}