src/org/apache/html/dom/HTMLElementImpl.java - xerces-j - Git at Google

 /*
  * 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 org.apache.html.dom;

 import java.util.Locale;

 import org.apache.xerces.dom.ElementImpl;
 import org.w3c.dom.Attr;
 import org.w3c.dom.Node;
 import org.w3c.dom.NodeList;
 import org.w3c.dom.html.HTMLElement;
 import org.w3c.dom.html.HTMLFormElement;

 /**
  * Implements an HTML-specific element, an {@link org.w3c.dom.Element} that
  * will only appear inside HTML documents. This element extends {@link
  * org.apache.xerces.dom.ElementImpl} by adding methods for directly
  * manipulating HTML-specific attributes. All HTML elements gain access to
  * the <code>id</code>, <code>title</code>, <code>lang</code>,
  * <code>dir</code> and <code>class</code> attributes. Other elements
  * add their own specific attributes.
  *
  * @xerces.internal
  *
  * @version $Revision$ $Date$
  * @author <a href="mailto:arkin@exoffice.com">Assaf Arkin</a>
  * @see org.w3c.dom.html.HTMLElement
  */
 public class HTMLElementImpl
     extends ElementImpl
     implements HTMLElement
 {

     private static final long serialVersionUID = 5283925246324423495L;

     /**
      * Constructor required owner document and element tag name. Will be called
      * by the constructor of specific element types but with a known tag name.
      * Assures that the owner document is an HTML element.
      *
      * @param owner The owner HTML document
      * @param tagName The element's tag name
      */
     public HTMLElementImpl( HTMLDocumentImpl owner, String tagName ) {
         super( owner, tagName.toUpperCase(Locale.ENGLISH) );
     }

     public String getId() {
         return getAttribute( "id" );
     }

     public void setId( String id ) {
         setAttribute( "id", id );
     }

     public String getTitle() {
         return getAttribute( "title" );
     }

     public void setTitle( String title ) {
         setAttribute( "title", title );
     }

     public String getLang() {
         return getAttribute( "lang" );
     }

     public void setLang( String lang ) {
         setAttribute( "lang", lang );
     }

     public String getDir() {
         return getAttribute( "dir" );
     }

     public void setDir( String dir ) {
         setAttribute( "dir", dir );
     }

     public String getClassName() {
         return getAttribute( "class" );
     }

     public void setClassName( String className ) {
         setAttribute( "class", className );
     }

     /**
      * Convenience method used to translate an attribute value into an integer
      * value. Returns the integer value or zero if the attribute is not a
      * valid numeric string.
      *
      * @param value The value of the attribute
      * @return The integer value, or zero if not a valid numeric string
      */
     int getInteger( String value ) {
         try {
             return Integer.parseInt( value );
         }
         catch ( NumberFormatException except ) {
             return 0;
         }
     }

     /**
      * Convenience method used to translate an attribute value into a boolean
      * value. If the attribute has an associated value (even an empty string),
      * it is set and true is returned. If the attribute does not exist, false
      * is returend.
      *
      * @param value The value of the attribute
      * @return True or false depending on whether the attribute has been set
      */
     boolean getBinary( String name ) {
         return ( getAttributeNode( name ) != null );
     }

     /**
      * Convenience method used to set a boolean attribute. If the value is true,
      * the attribute is set to an empty string. If the value is false, the attribute
      * is removed. HTML 4.0 understands empty strings as set attributes.
      *
      * @param name The name of the attribute
      * @param value The value of the attribute
      */
     void setAttribute( String name, boolean value ) {
         if ( value ) {
             setAttribute( name, name );
         }
         else {
             removeAttribute( name );
         }
     }

     public Attr getAttributeNode( String attrName ) {
         return super.getAttributeNode( attrName.toLowerCase(Locale.ENGLISH) );
     }

     public Attr getAttributeNodeNS( String namespaceURI,
             String localName ) {
         if ( namespaceURI != null && namespaceURI.length() > 0 ) {
             return super.getAttributeNodeNS( namespaceURI, localName );
         }
         return super.getAttributeNode( localName.toLowerCase(Locale.ENGLISH) );
     }

     public String getAttribute( String attrName ) {
         return super.getAttribute( attrName.toLowerCase(Locale.ENGLISH) );
     }

     public String getAttributeNS( String namespaceURI,
             String localName ) {
         if ( namespaceURI != null && namespaceURI.length() > 0 ) {
             return super.getAttributeNS( namespaceURI, localName );
         }
         return super.getAttribute( localName.toLowerCase(Locale.ENGLISH) );
     }

     public final NodeList getElementsByTagName( String tagName ) {
         return super.getElementsByTagName( tagName.toUpperCase(Locale.ENGLISH) );
     }

     public final NodeList getElementsByTagNameNS( String namespaceURI,
             String localName ) {
         if ( namespaceURI != null && namespaceURI.length() > 0 ) {
             return super.getElementsByTagNameNS( namespaceURI, localName.toUpperCase(Locale.ENGLISH) );
         }
         return super.getElementsByTagName( localName.toUpperCase(Locale.ENGLISH) );
     }

     /**
      * Convenience method used to capitalize a one-off attribute value before it
      * is returned. For example, the align values "LEFT" and "left" will both
      * return as "Left".
      *
      * @param value The value of the attribute
      * @return The capitalized value
      */
     String capitalize( String value ) {

         char[]    chars;
         int        i;

         // Convert string to charactares. Convert the first one to upper case,
         // the other characters to lower case, and return the converted string.
         chars = value.toCharArray();
         if ( chars.length > 0 ) {
             chars[ 0 ] = Character.toUpperCase( chars[ 0 ] );
             for ( i = 1 ; i < chars.length ; ++i ) {
                 chars[ i ] = Character.toLowerCase( chars[ i ] );
             }
             return String.valueOf( chars );
         }
         return value;
     }

     /**
      * Convenience method used to capitalize a one-off attribute value before it
      * is returned. For example, the align values "LEFT" and "left" will both
      * return as "Left".
      *
      * @param name The name of the attribute
      * @return The capitalized value
      */
     String getCapitalized( String name ) {
         String    value;
         char[]    chars;
         int        i;

         value = getAttribute( name );
         if ( value != null ) {
             // Convert string to charactares. Convert the first one to upper case,
             // the other characters to lower case, and return the converted string.
             chars = value.toCharArray();
             if ( chars.length > 0 ) {
                 chars[ 0 ] = Character.toUpperCase( chars[ 0 ] );
                 for ( i = 1 ; i < chars.length ; ++i ) {
                     chars[ i ] = Character.toLowerCase( chars[ i ] );
                 }
                 return String.valueOf( chars );
             }
         }
         return value;
     }


     /**
      * Convenience method returns the form in which this form element is contained.
      * This method is exposed for form elements through the DOM API, but other
      * elements have no access to it through the API.
      */
     public HTMLFormElement getForm() {
         Node parent = getParentNode();
         while ( parent != null ) {
             if ( parent instanceof HTMLFormElement ) {
                 return (HTMLFormElement) parent;
             }
             parent = parent.getParentNode();
         }
         return null;
     }

 }
	/*
	* 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 org.apache.html.dom;

	import java.util.Locale;

	import org.apache.xerces.dom.ElementImpl;
	import org.w3c.dom.Attr;
	import org.w3c.dom.Node;
	import org.w3c.dom.NodeList;
	import org.w3c.dom.html.HTMLElement;
	import org.w3c.dom.html.HTMLFormElement;

	/**
	* Implements an HTML-specific element, an {@link org.w3c.dom.Element} that
	* will only appear inside HTML documents. This element extends {@link
	* org.apache.xerces.dom.ElementImpl} by adding methods for directly
	* manipulating HTML-specific attributes. All HTML elements gain access to
	* the <code>id</code>, <code>title</code>, <code>lang</code>,
	* <code>dir</code> and <code>class</code> attributes. Other elements
	* add their own specific attributes.
	*
	* @xerces.internal
	*
	* @version $Revision$ $Date$
	* @author <a href="mailto:arkin@exoffice.com">Assaf Arkin</a>
	* @see org.w3c.dom.html.HTMLElement
	*/
	public class HTMLElementImpl
	extends ElementImpl
	implements HTMLElement
	{

	private static final long serialVersionUID = 5283925246324423495L;

	/**
	* Constructor required owner document and element tag name. Will be called
	* by the constructor of specific element types but with a known tag name.
	* Assures that the owner document is an HTML element.
	*
	* @param owner The owner HTML document
	* @param tagName The element's tag name
	*/
	public HTMLElementImpl( HTMLDocumentImpl owner, String tagName ) {
	super( owner, tagName.toUpperCase(Locale.ENGLISH) );
	}

	public String getId() {
	return getAttribute( "id" );
	}

	public void setId( String id ) {
	setAttribute( "id", id );
	}

	public String getTitle() {
	return getAttribute( "title" );
	}

	public void setTitle( String title ) {
	setAttribute( "title", title );
	}

	public String getLang() {
	return getAttribute( "lang" );
	}

	public void setLang( String lang ) {
	setAttribute( "lang", lang );
	}

	public String getDir() {
	return getAttribute( "dir" );
	}

	public void setDir( String dir ) {
	setAttribute( "dir", dir );
	}

	public String getClassName() {
	return getAttribute( "class" );
	}

	public void setClassName( String className ) {
	setAttribute( "class", className );
	}

	/**
	* Convenience method used to translate an attribute value into an integer
	* value. Returns the integer value or zero if the attribute is not a
	* valid numeric string.
	*
	* @param value The value of the attribute
	* @return The integer value, or zero if not a valid numeric string
	*/
	int getInteger( String value ) {
	try {
	return Integer.parseInt( value );
	}
	catch ( NumberFormatException except ) {
	return 0;
	}
	}

	/**
	* Convenience method used to translate an attribute value into a boolean
	* value. If the attribute has an associated value (even an empty string),
	* it is set and true is returned. If the attribute does not exist, false
	* is returend.
	*
	* @param value The value of the attribute
	* @return True or false depending on whether the attribute has been set
	*/
	boolean getBinary( String name ) {
	return ( getAttributeNode( name ) != null );
	}

	/**
	* Convenience method used to set a boolean attribute. If the value is true,
	* the attribute is set to an empty string. If the value is false, the attribute
	* is removed. HTML 4.0 understands empty strings as set attributes.
	*
	* @param name The name of the attribute
	* @param value The value of the attribute
	*/
	void setAttribute( String name, boolean value ) {
	if ( value ) {
	setAttribute( name, name );
	}
	else {
	removeAttribute( name );
	}
	}

	public Attr getAttributeNode( String attrName ) {
	return super.getAttributeNode( attrName.toLowerCase(Locale.ENGLISH) );
	}

	public Attr getAttributeNodeNS( String namespaceURI,
	String localName ) {
	if ( namespaceURI != null && namespaceURI.length() > 0 ) {
	return super.getAttributeNodeNS( namespaceURI, localName );
	}
	return super.getAttributeNode( localName.toLowerCase(Locale.ENGLISH) );
	}

	public String getAttribute( String attrName ) {
	return super.getAttribute( attrName.toLowerCase(Locale.ENGLISH) );
	}

	public String getAttributeNS( String namespaceURI,
	String localName ) {
	if ( namespaceURI != null && namespaceURI.length() > 0 ) {
	return super.getAttributeNS( namespaceURI, localName );
	}
	return super.getAttribute( localName.toLowerCase(Locale.ENGLISH) );
	}

	public final NodeList getElementsByTagName( String tagName ) {
	return super.getElementsByTagName( tagName.toUpperCase(Locale.ENGLISH) );
	}

	public final NodeList getElementsByTagNameNS( String namespaceURI,
	String localName ) {
	if ( namespaceURI != null && namespaceURI.length() > 0 ) {
	return super.getElementsByTagNameNS( namespaceURI, localName.toUpperCase(Locale.ENGLISH) );
	}
	return super.getElementsByTagName( localName.toUpperCase(Locale.ENGLISH) );
	}

	/**
	* Convenience method used to capitalize a one-off attribute value before it
	* is returned. For example, the align values "LEFT" and "left" will both
	* return as "Left".
	*
	* @param value The value of the attribute
	* @return The capitalized value
	*/
	String capitalize( String value ) {

	char[] chars;
	int i;

	// Convert string to charactares. Convert the first one to upper case,
	// the other characters to lower case, and return the converted string.
	chars = value.toCharArray();
	if ( chars.length > 0 ) {
	chars[ 0 ] = Character.toUpperCase( chars[ 0 ] );
	for ( i = 1 ; i < chars.length ; ++i ) {
	chars[ i ] = Character.toLowerCase( chars[ i ] );
	}
	return String.valueOf( chars );
	}
	return value;
	}

	/**
	* Convenience method used to capitalize a one-off attribute value before it
	* is returned. For example, the align values "LEFT" and "left" will both
	* return as "Left".
	*
	* @param name The name of the attribute
	* @return The capitalized value
	*/
	String getCapitalized( String name ) {
	String value;
	char[] chars;
	int i;

	value = getAttribute( name );
	if ( value != null ) {
	// Convert string to charactares. Convert the first one to upper case,
	// the other characters to lower case, and return the converted string.
	chars = value.toCharArray();
	if ( chars.length > 0 ) {
	chars[ 0 ] = Character.toUpperCase( chars[ 0 ] );
	for ( i = 1 ; i < chars.length ; ++i ) {
	chars[ i ] = Character.toLowerCase( chars[ i ] );
	}
	return String.valueOf( chars );
	}
	}
	return value;
	}


	/**
	* Convenience method returns the form in which this form element is contained.
	* This method is exposed for form elements through the DOM API, but other
	* elements have no access to it through the API.
	*/
	public HTMLFormElement getForm() {
	Node parent = getParentNode();
	while ( parent != null ) {
	if ( parent instanceof HTMLFormElement ) {
	return (HTMLFormElement) parent;
	}
	parent = parent.getParentNode();
	}
	return null;
	}

	}