modulespecadv.java

jxme的一些相关程序,主要是手机上程序开发以及手机和计算机通信的一些程序资料,程序编译需要Ant支持

/*
 * Copyright (c) 2001 Sun Microsystems, Inc.  All rights
 * reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. The end-user documentation included with the redistribution,
 *    if any, must include the following acknowledgment:
 *       "This product includes software developed by the
 *       Sun Microsystems, Inc. for Project JXTA."
 *    Alternately, this acknowledgment may appear in the software itself,
 *    if and wherever such third-party acknowledgments normally appear.
 *
 * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
 *    not be used to endorse or promote products derived from this
 *    software without prior written permission. For written
 *    permission, please contact Project JXTA at http://www.jxta.org.
 *
 * 5. Products derived from this software may not be called "JXTA",
 *    nor may "JXTA" appear in their name, without prior written
 *    permission of Sun.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL SUN MICROSYSTEMS OR
 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of Project JXTA.  For more
 * information on Project JXTA, please see
 * <http://www.jxta.org/>.
 *
 * This license is based on the BSD license adopted by the Apache Foundation.
 *
 * $Id: ModuleSpecAdv.java,v 1.4 2002/06/18 20:46:00 hamada Exp $
 */
package net.jxta.impl.protocol;

import java.util.Enumeration;
import java.net.URL;

import java.net.MalformedURLException;
import java.net.UnknownServiceException;

import net.jxta.protocol.ModuleSpecAdvertisement;
import net.jxta.protocol.PipeAdvertisement;
import net.jxta.platform.ModuleSpecID;
import net.jxta.id.IDFactory;
import net.jxta.document.*;

public class ModuleSpecAdv extends ModuleSpecAdvertisement {

    private static final String idTag = "MSID";
    private static final String nameTag = "Name";
    private static final String creatorTag = "Crtr";
    private static final String uriTag = "SURI";
    private static final String versTag = "Vers";
    private static final String descTag = "Desc";
    private static final String paramTag = "Parm";
    private static final String proxyIdTag = "Proxy";
    private static final String authIdTag = "Auth";

    public static class Instantiator implements AdvertisementFactory.Instantiator {
        
        /**
         * Returns the identifying type of this Advertisement.
         *
         * @return String the type of advertisement
         *
         * @since JXTA 1.0
         **/
        public String getAdvertisementType( ) {
            return ModuleSpecAdv.getAdvertisementType();
        }
        
        /**
         * Constructs an instance of <CODE>Advertisement</CODE> matching the type
         * specified by the <CODE>advertisementType</CODE> parameter.
         *
         * @param advertisementType Specifies the mime media type to be associated with the
         * <CODE>StructuredDocument</CODE> to be created.
         * @return The instance of <CODE>Advertisement</CODE> or null if it
         * could not be created.
         *
         * @exception InvocationTargetException error invoking target constructor
         *
         * @since JXTA 1.0
         **/
        public Advertisement newInstance( ) {
            return new ModuleSpecAdv();
        }
        
        /**
         * Constructs an instance of <CODE>Advertisement</CODE> matching the type
         * specified by the <CODE>advertisementType</CODE> parameter.
         *
         * @param root Specifies a portion of a StructuredDocument which will be
         * converted into an Advertisement.
         * @return The instance of <CODE>Advertisement</CODE> or null if it
         * could not be created.
         *
         * @exception InvocationTargetException error invoking target constructor
         *
         * @since JXTA 1.0
         **/
        public Advertisement newInstance( net.jxta.document.Element root ) {
            return new ModuleSpecAdv( root );
        }
    };

    public ModuleSpecAdv() {
    }

    public ModuleSpecAdv( Element root ) {
        initialize( root );
    }
    public void initialize(Element root) {
        
        if( !TextElement.class.isInstance( root ) )
            throw new IllegalArgumentException( getClass().getName() + " only supports TextElement" );
        
        TextElement doc = (TextElement) root;
        
        if (! doc.getName().equals( getAdvertisementType() ) )
            
            throw new IllegalArgumentException( "Could not construct : "
                                                + getClass().getName()
                                                + "from doc containing a "
                                                + doc.getName() );
        
        // set defaults, in case initialized is called on a used object.
        setDescription( null );
        setName( null );
        setModuleSpecID( null );
        setCreator(null);
        setSpecURI(null);
        setVersion(null);
        setDescription(null);
        setPipeAdvertisement(null);
        setProxySpecID(null);
        setAuthSpecID(null);
        setParam(null);

        Enumeration elements = doc.getChildren();
        
        while (elements.hasMoreElements()) {
            TextElement elem = (TextElement) elements.nextElement();
            String nm = elem.getName();
            if(nm.equals(nameTag)) {
                setName( elem.getTextValue() );
                continue;
            }
            if(nm.equals(descTag)) {
                setDescription( elem.getTextValue() );
                continue;
            }
            if (nm.equals(idTag)) {
                try {
	        URL spID =  IDFactory.jxtaURL( elem.getTextValue() );
                setModuleSpecID( (ModuleSpecID) IDFactory.fromURL( spID ) );
                } catch ( MalformedURLException badID ) {
                    throw new IllegalArgumentException( "Bad spec ID in advertisement" );
                } catch ( UnknownServiceException badID ) {
                    throw new IllegalArgumentException( "Unusable ID in advertisement" );
                }
                continue;
            }
            if (nm.equals(creatorTag)) {
                setCreator( elem.getTextValue() );
                continue;
            }
            if (nm.equals(uriTag)) {
                setSpecURI( elem.getTextValue() );
                continue;
            }
            if (nm.equals(versTag)) {
                setVersion( elem.getTextValue() );
                continue;
            }
            if (nm.equals(paramTag)) {
                // Copy the element into a complete new document
                // which type matches the element name. There is no
                // API Advertisement for it, each module implementation
                // may have its own Advertisement subclass for its param.
                StructuredTextDocument paramDoc = (StructuredTextDocument)
                    StructuredDocumentFactory.newStructuredDocument
                    (doc.getRoot().getMimeType(), paramTag,
                     elem.getTextValue());
                StructuredDocumentUtils.copyChildren(paramDoc, paramDoc, elem);
                setParam(paramDoc);
                continue;
            }
            if (nm.equals(proxyIdTag)) {
                try {
	        URL spID =  IDFactory.jxtaURL( elem.getTextValue() );
                setProxySpecID( (ModuleSpecID) IDFactory.fromURL( spID ) );
                } catch ( MalformedURLException badID ) {
                    throw new IllegalArgumentException( "Bad proxy spec ID in advertisement" );
                } catch ( UnknownServiceException badID ) {
                    throw new IllegalArgumentException( "Unusable ID in advertisement" );
                }
                continue;
            }
            if (nm.equals(authIdTag)) {
                try {
	        URL spID =  IDFactory.jxtaURL( elem.getTextValue() );
                setAuthSpecID( (ModuleSpecID) IDFactory.fromURL( spID ) );
                } catch ( MalformedURLException badID ) {
                    throw new IllegalArgumentException( "Bad authenticator spec ID in advertisement" );
                } catch ( UnknownServiceException badID ) {
                    throw new IllegalArgumentException( "Unusable ID in advertisement" );
                }
                continue;
            }
            if (nm.equals(PipeAdvertisement.getAdvertisementType())) {
                try {
                    PipeAdvertisement pipeAdv = (PipeAdvertisement)
                        AdvertisementFactory.newAdvertisement(elem);
                    setPipeAdvertisement( pipeAdv );
                } catch ( ClassCastException wrongAdv ) {
                    throw new IllegalArgumentException( "Bad pipe advertisement in advertisement" );
                }
                continue;
            }
        }
            
    }
    
    public Document getDocument( MimeMediaType encodeAs ) {
        StructuredTextDocument adv = null;
        
        try {
            adv = (StructuredTextDocument)
            StructuredDocumentFactory.newStructuredDocument(
            encodeAs, getAdvertisementType() );
        }
        catch ( Throwable everything ) {
            return null;
        }
        
        Element e;
        e = adv.createElement(idTag, getModuleSpecID().toString());
        adv.appendChild(e);

        e = adv.createElement(nameTag, getName());
        adv.appendChild(e);

        e = adv.createElement(creatorTag, getCreator());
        adv.appendChild(e);

        e = adv.createElement(uriTag, getSpecURI());
        adv.appendChild(e);

        e = adv.createElement(versTag, getVersion());
        adv.appendChild(e);

        String description = getDescription();
        if( null != description ) {
            e = adv.createElement(descTag, description);
            adv.appendChild(e);
        }
        e = getParam();
        // Copy the param document as an element of adv.
        if (e != null) {
            StructuredDocumentUtils.copyElements(adv, adv, e);
        }
        PipeAdvertisement pipeAdv = getPipeAdvertisement();
        if (pipeAdv != null) {
            StructuredTextDocument advDoc = (StructuredTextDocument)
                pipeAdv.getDocument(new MimeMediaType("text", "xml"));
            StructuredDocumentUtils.copyElements(adv, adv, advDoc);
        }
        ModuleSpecID tmpId = getProxySpecID();
        if (tmpId != null) {
            e = adv.createElement(proxyIdTag, tmpId.toString());
            adv.appendChild(e);
        }
        tmpId = getAuthSpecID();
        if (tmpId != null) {
            e = adv.createElement(authIdTag, tmpId.toString());
            adv.appendChild(e);
        }
        return adv;
    }
}