Java XML First Child Element getFirstChildElement(@Nonnull final Node aStartNode)

Description

Get the first direct child element of the passed element.

License

Apache License

Parameter

Parameter	Description
aStartNode	The element to start searching.

Return

null if the passed element does not have any direct child element.

Declaration

@Nullable
public static Element getFirstChildElement(@Nonnull final Node aStartNode) 

Method Source Code

//package com.java2s;
/**/*  w  w  w .  ja v a  2  s  . c  o m*/
 * Copyright (C) 2014-2015 Philip Helger (www.helger.com)
 * philip[at]helger[dot]com
 *
 * Licensed 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.
 */

import javax.annotation.Nonnegative;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;

import org.w3c.dom.Element;

import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

public class Main {
    /**
     * Get the first direct child element of the passed element.
     *
     * @param aStartNode
     *        The element to start searching.
     * @return <code>null</code> if the passed element does not have any direct
     *         child element.
     */
    @Nullable
    public static Element getFirstChildElement(@Nonnull final Node aStartNode) {
        final NodeList aNodeList = aStartNode.getChildNodes();
        final int nLen = aNodeList.getLength();
        for (int i = 0; i < nLen; ++i) {
            final Node aNode = aNodeList.item(i);
            if (aNode.getNodeType() == Node.ELEMENT_NODE)
                return (Element) aNode;
        }
        return null;
    }

    @Nonnegative
    public static int getLength(@Nullable final NodeList aNL) {
        return aNL == null ? 0 : aNL.getLength();
    }
}

Related

1. getFirstChildByTagName(Element parent, String tagName)
2. getFirstChildByTagName(Node parent, String tagName)
3. getFirstChildByTagNameNS(Node contextNode, String nsuri, String tag)
4. getFirstChildByType(Element element, int nodeType)
5. getFirstChildByType(Element element, short nodeType)
6. getFirstChildElement(Element e)
7. getFirstChildElement(Element e)
8. getFirstChildElement(Element e)
9. getFirstChildElement(Element ele)