org.apache.abdera.model
Interface Element

All Superinterfaces:

Base, Cloneable, Iterable<Element>

All Known Subinterfaces:

Categories, Category, Collection, Content, Control, DateTime, Div, Entry, ExtensibleElement, Feed, Generator, IRIElement, Link, Person, Service, Source, Text, Workspace

All Known Implementing Classes:

Bar, DateTimeWrapper, ElementWrapper, Error, ExtensibleElementWrapper, Foo, PersonWrapper

public interface Element
extends Base, Iterable<Element>

Root interface for all elements in the Feed Object Model

Method Summary

<T extends Element> T	declareNS(String uri, String prefix) Declare a namespace
void	discard() Removes this element from its current document
List<QName>	getAttributes() Returns a listing of all attributes on this element
String	getAttributeValue(QName qname) Returns the value of the named attribute
String	getAttributeValue(String name) Returns the value of the named attribute
IRI	getBaseUri() Returns the value of this element's xml:base attribute or null if xml:base is undefined.
<T extends Element> Document<T>	getDocument() Returns the document to which this element belongs
<T extends Element> List<T>	getElements() Return a listing of this elements child elements
List<QName>	getExtensionAttributes() Returns a listing of extension attributes on this element (extension attributes are attributes whose namespace URI is different than the elements)
<T extends Element> T	getFirstChild() Get the first child element
<T extends Element> T	getFirstChild(QName qname) Get the first child element with the given QName
String	getLanguage() Returns the value of this elements xml:lang attribute or null if xml:lang is undefined.
Lang	getLanguageTag() Returns the value of the xml:lang attribute as a Lang object
Locale	getLocale() Returns a Locale object created from the xml:lang attribute
boolean	getMustPreserveWhitespace() Return true if insignificant whitespace must be preserved
Map<String,String>	getNamespaces() Return a map listing the xml namespaces declared for this element
<T extends Element> T	getNextSibling() Get the element following this one
<T extends Element> T	getNextSibling(QName qname) Get the first following sibling with the specified QName
<T extends Base> T	getParentElement() Return this Element's parent element or document
<T extends Element> T	getPreviousSibling() Get the element preceding this one
<T extends Element> T	getPreviousSibling(QName qname) Get the first previous sibling with the specified QName
QName	getQName() Return the XML QName of this element
IRI	getResolvedBaseUri() Returns the current in-scope, fully qualified Base URI for this element.
String	getText() Returns the Text value of this element
<T extends Element> T	removeAttribute(QName qname) Remove the named Attribute
<T extends Element> T	removeAttribute(String name) Remove the named attribute
<T extends Element> T	setAttributeValue(QName qname, String value) Sets the value of the named attribute
<T extends Element> T	setAttributeValue(String name, String value) Sets the value of the named attribute
<T extends Element> T	setBaseUri(IRI base) Sets the value of this element's xml:base attribute.
<T extends Element> T	setBaseUri(String base) Sets the value of this element's xml:base attribute.
<T extends Element> T	setLanguage(String language) Sets the value of this elements xml:lang attribute.
<T extends Element> T	setMustPreserveWhitespace(boolean preserve) Set to true to preserve insignificant whitespace
<T extends Element> T	setParentElement(Element parent) Set this Element's parent element
<T extends Element> T	setText(javax.activation.DataHandler dataHandler) Set the Text value of this element using the data handler
void	setText(String text) Set the Text value of this element

Methods inherited from interface org.apache.abdera.model.Base

addComment, clone, complete, getDefaultWriterOptions, getFactory, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo

Methods inherited from interface java.lang.Iterable

iterator

Method Detail

getParentElement

<T extends Base> T getParentElement()

Return this Element's parent element or document

Returns:

The parent

setParentElement

<T extends Element> T setParentElement(Element parent)

Set this Element's parent element

Parameters:

parent - The parent element

getPreviousSibling

<T extends Element> T getPreviousSibling()

Get the element preceding this one

Returns:

The preceding sibling

getNextSibling

<T extends Element> T getNextSibling()

Get the element following this one

Returns:

The following sibling

getFirstChild

<T extends Element> T getFirstChild()

Get the first child element

Returns:

The first child

getPreviousSibling

<T extends Element> T getPreviousSibling(QName qname)

Get the first previous sibling with the specified QName

Parameters:

qname - The XML QName of the sibling to find

Returns:

The matching element

getNextSibling

<T extends Element> T getNextSibling(QName qname)

Get the first following sibling with the specified QName

Parameters:

qname - The XML QName of the sibling to find

Returns:

The matching element

getFirstChild

<T extends Element> T getFirstChild(QName qname)

Get the first child element with the given QName

Parameters:

qname - The XML QName of the sibling to find

Returns:

The matching element

getQName

QName getQName()

Return the XML QName of this element

Returns:

The QName of the element

getLanguage

String getLanguage()

Returns the value of this elements xml:lang attribute or null if xml:lang is undefined.

Returns:

The xml:lang value

getLanguageTag

Lang getLanguageTag()

Returns the value of the xml:lang attribute as a Lang object

getLocale

Locale getLocale()

Returns a Locale object created from the xml:lang attribute

Returns:

A Locale appropriate for the Language (xml:lang)

setLanguage

<T extends Element> T setLanguage(String language)

Sets the value of this elements xml:lang attribute.

Parameters:

language - the value of the xml:lang element

getBaseUri

IRI getBaseUri()

Returns the value of this element's xml:base attribute or null if xml:base is undefined.

Returns:

The Base URI

Throws:

IRISyntaxException - if the Base URI is malformed

getResolvedBaseUri

IRI getResolvedBaseUri()

Returns the current in-scope, fully qualified Base URI for this element.

Throws:

IRISyntaxException - if the Base URI is malformed

setBaseUri

<T extends Element> T setBaseUri(IRI base)

Sets the value of this element's xml:base attribute.

Parameters:

base - The IRI base value

setBaseUri

<T extends Element> T setBaseUri(String base)

Sets the value of this element's xml:base attribute.

Parameters:

base - The Base IRI

Throws:

IRISyntaxException - if the base URI is malformed

getDocument

<T extends Element> Document<T> getDocument()

Returns the document to which this element belongs

Returns:

The Document to which this element belongs

getAttributeValue

String getAttributeValue(String name)

Returns the value of the named attribute

Parameters:

name - The name of the attribute

Returns:

The value of the attribute

getAttributeValue

String getAttributeValue(QName qname)

Returns the value of the named attribute

Parameters:

qname - The XML QName of the attribute

Returns:

The value of the attribute

getAttributes

List<QName> getAttributes()

Returns a listing of all attributes on this element

Returns:

The listing of attributes for this element

getExtensionAttributes

List<QName> getExtensionAttributes()

Returns a listing of extension attributes on this element (extension attributes are attributes whose namespace URI is different than the elements)

Returns:

The listing non-Atom attributes

removeAttribute

<T extends Element> T removeAttribute(QName qname)

Remove the named Attribute

Parameters:

qname - The XML QName of the attribute to remove

removeAttribute

<T extends Element> T removeAttribute(String name)

Remove the named attribute

Parameters:

name - The name of the attribute to remove

setAttributeValue

<T extends Element> T setAttributeValue(String name,
                                        String value)

Sets the value of the named attribute

Parameters:

name - The name of the attribute

value - The value of the attribute

setAttributeValue

<T extends Element> T setAttributeValue(QName qname,
                                        String value)

Sets the value of the named attribute

Parameters:

qname - The XML QName of the attribute

value - The value of the attribute

discard

void discard()

Removes this element from its current document

getText

String getText()

Returns the Text value of this element

Returns:

The text value

setText

void setText(String text)

Set the Text value of this element

Parameters:

text - The text value

setText

<T extends Element> T setText(javax.activation.DataHandler dataHandler)

Set the Text value of this element using the data handler

declareNS

<T extends Element> T declareNS(String uri,
                                String prefix)

Declare a namespace

getNamespaces

Map<String,String> getNamespaces()

Return a map listing the xml namespaces declared for this element

getElements

<T extends Element> List<T> getElements()

Return a listing of this elements child elements

getMustPreserveWhitespace

boolean getMustPreserveWhitespace()

Return true if insignificant whitespace must be preserved

setMustPreserveWhitespace

<T extends Element> T setMustPreserveWhitespace(boolean preserve)

Set to true to preserve insignificant whitespace