Axis 2 example source code file (Name.java)

This example Axis 2 source code file (Name.java) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" ^TM.

Java - Axis 2 tags/keywords

name, name, string, string

The Axis 2 Name.java source code

/*
 * 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.
 */
package javax.xml.soap;

/**
 * A representation of an XML name.  This interface provides methods for getting the local and
 * namespace-qualified names and also for getting the prefix associated with the namespace for the
 * name. It is also possible to get the URI of the namespace.
 * <p/>
 * The following is an example of a namespace declaration in an element. <PRE>
 * <wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader"> </PRE> ("xmlns"
 * stands for "XML namespace".) The following shows what the methods in the <code>Name
 * interface will return. <UL> 
getQualifiedName will return "prefix:LocalName" =
 * "WOMBAT:GetLastTradePrice" <LI>getURI will return "http://www.wombat.org/trader"
 * <LI>getLocalName will return "GetLastTracePrice" 
getPrefix will
 * return "WOMBAT" </UL>
 * <p/>
 * XML namespaces are used to disambiguate SOAP identifiers from application-specific identifiers.
 * <p/>
 * <code>Name objects are created using the method SOAPEnvelope.createName,
 * which has two versions. One method creates <code>Name objects with a local name, a
 * namespace prefix, and a namespace URI. and the second creates <code>Name objects with just
 * a local name. The following line of code, in which <i>se is a SOAPEnvelope
 * object, creates a new <code>Name object with all three. 
 Name name =
 * se.createName("GetLastTradePrice", "WOMBAT", "http://www.wombat.org/trader"); </PRE> The
 * following line of code gives an example of how a <code>Name object can be used. The
 * variable <i>element is a SOAPElement object. This code creates a new
 * <code>SOAPElement object with the given name and adds it to element. 
 * element.addChildElement(name); </PRE>
 */
public interface Name {

    /**
     * Gets the local name part of the XML name that this <code>Name object represents.
     *
     * @return a string giving the local name
     */
    public abstract String getLocalName();

    /**
     * Gets the namespace-qualified name of the XML name that this <code>Name object
     * represents.
     *
     * @return the namespace-qualified name as a string
     */
    public abstract String getQualifiedName();

    /**
     * Returns the prefix associated with the namespace for the XML name that this <code>Name
     * object represents.
     *
     * @return the prefix as a string
     */
    public abstract String getPrefix();

    /**
     * Returns the URI of the namespace for the XML name that this <code>Name object
     * represents.
     *
     * @return the URI as a string
     */
    public abstract String getURI();
}


Other Axis 2 examples (source code examples)
Here is a short list of links related to this Axis 2 Name.java source code file:

  
 The search page
  
 Other Axis 2 source code examples at this package level
  
 Click here to learn more about this project