Java XML Element First getFirstElement(Document document, String tagName)

Description

This method returns the first element from the document.

License

Open Source License

Parameter

Parameter	Description
document	The document.
tagName	The element name.

Return

The element object.

Declaration

public static Element getFirstElement(Document document, String tagName) 

Method Source Code

//package com.java2s;
/**// ww w  . j a v  a 2s  .c om
 * Copyright 2003, 2004  ONCE Corporation
 *
 * LICENSE:
 * This file is part of BuilditMPI. It may be redistributed and/or modified
 * under the terms of the Common Public License, version 1.0.
 * You should have received a copy of the Common Public License along with this
 * software. See LICENSE.txt for details. Otherwise, you may find it online at:
 *   http://www.oncecorp.com/CPL10/ or http://opensource.org/licenses/cpl.php
 *
 * DISCLAIMER OF WARRANTIES AND LIABILITY:
 * THE SOFTWARE IS PROVIDED "AS IS".  THE AUTHOR MAKES NO REPRESENTATIONS OR
 * WARRANTIES, EITHER EXPRESS OR IMPLIED.  TO THE EXTENT NOT PROHIBITED BY LAW,
 * IN NO EVENT WILL THE AUTHOR BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT
 * LIMITATION, LOST REVENUE, PROFITS OR DATA, OR FOR SPECIAL, INDIRECT,
 * CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS
 * OF THE THEORY OF LIABILITY, ARISING OUT OF OR RELATED TO ANY FURNISHING,
 * PRACTICING, MODIFYING OR ANY USE OF THE SOFTWARE, EVEN IF THE AUTHOR HAVE
 * BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 *
 * -----------------------------------------------------
 * $Id$
 */

import org.w3c.dom.Document;
import org.w3c.dom.Element;

import org.w3c.dom.NodeList;

public class Main {
    /**
     * This method returns the first element from the document.
     * @param document The document.
     * @param tagName The element name.
     * @return The element object.
     */
    public static Element getFirstElement(Document document, String tagName) {
        NodeList nodes = document.getElementsByTagName(tagName);
        if (nodes != null && nodes.getLength() != 0) {
            return (Element) nodes.item(0);
        } else {
            return null;
        }
    }
}

Related

1. getFirstElement(Document document)
2. getFirstElement(Element documentElement)
3. getFirstElement(String name, Element root)
4. getFirstElementByTagName(Document doc, String tagName)
5. getFirstElementByTagName(Document document, String name)