[jdom-interest] Document.getRootElement()

Jason Hunter jhunter at acm.org
Tue Jun 13 11:37:15 PDT 2000


> There is a contradiction here: Does the method return null or does it
> throw a NoSuchElementException?

The code says it thorws NSEE.  This shouldn't naturally happen because
the public Element constructor requires an Element be passed in, but I
changed the Javadocs to match behavior.

    /**
     * <p>
     * This will return the root <code>Element</code>
     *   for this <code>Document</code>, or throw a
NoSuchElementException
     *   if it hasn't been properly set.
     * </p>
     *
     * @return <code>Element</code> - the document's root element
     * @throws <code>NoSuchElementException</code> - when no root
     *                                      element exists.
     */
    public Element getRootElement() throws NoSuchElementException {
        if (rootElement == null)  {
            throw new NoSuchElementException("No root element exists.");
        }
        return rootElement;
    }

-jh-



More information about the jdom-interest mailing list