Parent

所有超级接口:

java.lang.Cloneable, NamespaceAware, java.io.Serializable

所有已知实现类:

Document, Element, LocatedElement
```
public interface Parent
extends java.lang.Cloneable, NamespaceAware, java.io.Serializable
```
Interface for JDOM objects which are allowed to contain Content content - Element and Document.

作者:

Bradley S. Huffman, Jason Hunter, Rolf Lear

另请参阅:

Content, Document, Element

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`Parent`	`addContent(java.util.Collection<? extends Content> c)` Appends all children in the given collection to the end of the content list.
`Parent`	`addContent(Content child)` Appends the child to the end of the content list.
`Parent`	`addContent(int index, java.util.Collection<? extends Content> c)` Inserts the content in a collection into the content list at the given index.
`Parent`	`addContent(int index, Content child)` Inserts the child into the content list at the given index.
`void`	`canContainContent(Content content, int index, boolean replace)` Test whether this Parent instance can contain the specified content at the specified position.
`java.lang.Object`	`clone()` Obtain a deep, unattached copy of this parent and it's children.
`java.util.List<Content>`	`cloneContent()` Returns a list containing detached clones of this parent's content list.
`java.util.List<Content>`	`getContent()` Returns the full content of this parent as a `List` which contains objects of type `Content`.
`<E extends Content> java.util.List<E>`	`getContent(Filter<E> filter)` Returns as a `List` the content of this parent that matches the supplied filter.
`Content`	`getContent(int index)` Returns the child at the given index.
`int`	`getContentSize()` Returns the number of children in this parent's content list.
`IteratorIterable<Content>`	`getDescendants()` Returns an `Iterator` that walks over all descendants in document order.
`<E extends Content> IteratorIterable<E>`	`getDescendants(Filter<E> filter)` Returns an `Iterator` that walks over all descendants in document order applying the Filter to return only content that match the filter rule.
`Document`	`getDocument()` Return this parent's owning document or null if the branch containing this parent is currently not attached to a document.
`Parent`	`getParent()` Return this parent's parent, or null if this parent is currently not attached to another parent.
`int`	`indexOf(Content child)` Returns the index of the supplied child in the content list, or -1 if not a child of this parent.
`java.util.List<Content>`	`removeContent()` Removes all content from this parent and returns the detached children.
`boolean`	`removeContent(Content child)` Removes a single child node from the content list.
`<E extends Content> java.util.List<E>`	`removeContent(Filter<E> filter)` Removes from this parent all child content matching the given filter and returns a list of the detached children.
`Content`	`removeContent(int index)` Removes and returns the child at the given index, or returns null if there's no such child.

从接口继承的方法 org.jdom2.NamespaceAware
getNamespacesInherited, getNamespacesInScope, getNamespacesIntroduced

- 方法详细资料
  - getContentSize
```
int getContentSize()
```
    Returns the number of children in this parent's content list. Children may be any Content type.
    
    返回:
    
    number of children
  - indexOf
```
int indexOf(Content child)
```
    Returns the index of the supplied child in the content list, or -1 if not a child of this parent.
    
    参数:
    
    child - child to search for
    
    返回:
    
    index of child, or -1 if not found
  - cloneContent
```
java.util.List<Content> cloneContent()
```
    Returns a list containing detached clones of this parent's content list.
    
    返回:
    
    list of cloned child content
  - getContent
```
Content getContent(int index)
```
    Returns the child at the given index.
    
    参数:
    
    index - location of desired child
    
    返回:
    
    child at the given index
    
    抛出:
    
    java.lang.IndexOutOfBoundsException - if index is negative or beyond the current number of children
    
    java.lang.IllegalStateException - if parent is a Document and the root element is not set
  - getContent
```
java.util.List<Content> getContent()
```
    Returns the full content of this parent as a List which contains objects of type Content. The returned list is "live" and in document order. Any modifications to it affect the element's actual contents. Modifications are checked for conformance to XML 1.0 rules.
    Sequential traversal through the List is best done with an Iterator since the underlying implement of List.size() may require walking the entire list and indexed lookups may require starting at the beginning each time.
    
    返回:
    
    a list of the content of the parent
    
    抛出:
    
    java.lang.IllegalStateException - if parent is a Document and the root element is not set
  - getContent
```
<E extends Content> java.util.List<E> getContent(Filter<E> filter)
```
    Returns as a List the content of this parent that matches the supplied filter. The returned list is "live" and in document order. Any modifications to it affect the element's actual contents. Modifications are checked for conformance to XML 1.0 rules.
    Sequential traversal through the List is best done with an Iterator since the underlying implement of List.size() may require walking the entire list and indexed lookups may require starting at the beginning each time.
    
    类型参数:
    
    E - The Generic type of the returned content (the Filter's type)
    
    参数:
    
    filter - filter to apply
    
    返回:
    
    a list of the content of the parent matching the filter
    
    抛出:
    
    java.lang.IllegalStateException - if parent is a Document and the root element is not set
  - removeContent
```
java.util.List<Content> removeContent()
```
    Removes all content from this parent and returns the detached children.
    
    返回:
    
    list of the old content detached from this parent
  - removeContent
```
<E extends Content> java.util.List<E> removeContent(Filter<E> filter)
```
    Removes from this parent all child content matching the given filter and returns a list of the detached children.
    
    类型参数:
    
    E - The Generic type of the content to remove.
    
    参数:
    
    filter - filter to apply
    
    返回:
    
    list of the detached children matching the filter
  - removeContent
```
boolean removeContent(Content child)
```
    Removes a single child node from the content list.
    
    参数:
    
    child - child to remove
    
    返回:
    
    whether the removal occurred
  - removeContent
```
Content removeContent(int index)
```
    Removes and returns the child at the given index, or returns null if there's no such child.
    
    参数:
    
    index - index of child to remove
    
    返回:
    
    detached child at given index or null if no
    
    抛出:
    
    java.lang.IndexOutOfBoundsException - if index is negative or beyond the current number of children
  - clone
```
java.lang.Object clone()
```
    Obtain a deep, unattached copy of this parent and it's children.
    
    返回:
    
    a deep copy of this parent and it's children.
  - getDescendants
```
IteratorIterable<Content> getDescendants()
```
    Returns an Iterator that walks over all descendants in document order. Note that this method returns an IteratorIterable instance, which means that you can use it either as an Iterator, or an Iterable, allowing both:
```
   for (Iterator<Content> it = parent.getDescendants();
           it.hasNext();) {
       Content c = it.next();
       ....
   }
 
```
    and
```
   for (Content c : parent.getDescendants()) {
       ....
   }
 
```
    The Iterator version is most useful if you need to do list modification on the iterator (using remove()), and for compatibility with JDOM 1.x
    返回:
    
    an iterator to walk descendants
  - getDescendants
```
<E extends Content> IteratorIterable<E> getDescendants(Filter<E> filter)
```
    Returns an Iterator that walks over all descendants in document order applying the Filter to return only content that match the filter rule. With filters you can match only Elements, only Comments, Elements or Comments, only Elements with a given name and/or prefix, and so on. Note that this method returns an IteratorIterable instance, which means that you can use it either as an Iterator, or an Iterable, allowing both:
```
   for (Iterator<Element> it = parent.getDescendants(Filters.element());
           it.hasNext();) {
       Element e = it.next();
       ....
   }
 
```
    and
```
   for (Element e : parent.getDescendants(Filters.element())) {
       ....
   }
 
```
    The Iterator version is most useful if you need to do list modification on the iterator (using remove()), and for compatibility with JDOM 1.x
    类型参数:
    
    E - E
    
    参数:
    
    filter - filter to select which descendants to see
    
    返回:
    
    an iterator to walk descendants that match a filter
  - getParent
```
Parent getParent()
```
    Return this parent's parent, or null if this parent is currently not attached to another parent. This is the same method as in Content but also added to Parent to allow more easy up-the-tree walking.
    
    返回:
    
    this parent's parent or null if none
  - getDocument
```
Document getDocument()
```
    Return this parent's owning document or null if the branch containing this parent is currently not attached to a document.
    
    返回:
    
    this child's owning document or null if none
  - canContainContent
```
void canContainContent(Content content,
                       int index,
                       boolean replace)
                throws IllegalAddException
```
    Test whether this Parent instance can contain the specified content at the specified position.
    
    参数:
    
    content - The content to be checked
    
    index - The location where the content would be put.
    
    replace - true if the intention is to replace the content already at the index.
    
    抛出:
    
    IllegalAddException - if there is a problem with the content
  - addContent
```
Parent addContent(Content child)
```
    Appends the child to the end of the content list.
    
    参数:
    
    child - child to append to end of content list
    
    返回:
    
    the Parent instance on which the method was called
    
    抛出:
    
    IllegalAddException - if the given child already has a parent.
  - addContent
```
Parent addContent(java.util.Collection<? extends Content> c)
```
    Appends all children in the given collection to the end of the content list. In event of an exception during add the original content will be unchanged and the objects in the supplied collection will be unaltered.
    
    参数:
    
    c - collection to append
    
    返回:
    
    the document on which the method was called
    
    抛出:
    
    IllegalAddException - if any item in the collection already has a parent or is of an illegal type.
  - addContent
```
Parent addContent(int index,
                  Content child)
```
    Inserts the child into the content list at the given index.
    
    参数:
    
    index - location for adding the collection
    
    child - child to insert
    
    返回:
    
    the parent on which the method was called
    
    抛出:
    
    java.lang.IndexOutOfBoundsException - if index is negative or beyond the current number of children
    
    IllegalAddException - if the given child already has a parent.
  - addContent
```
Parent addContent(int index,
                  java.util.Collection<? extends Content> c)
```
    Inserts the content in a collection into the content list at the given index. In event of an exception the original content will be unchanged and the objects in the supplied collection will be unaltered.
    
    参数:
    
    index - location for adding the collection
    
    c - collection to insert
    
    返回:
    
    the parent on which the method was called
    
    抛出:
    
    java.lang.IndexOutOfBoundsException - if index is negative or beyond the current number of children
    
    IllegalAddException - if any item in the collection already has a parent or is of an illegal type.

接口 Parent

方法概要

从接口继承的方法 org.jdom2.NamespaceAware

方法详细资料

getContentSize

indexOf

cloneContent

getContent

getContent

getContent

removeContent

removeContent

removeContent

removeContent

clone

getDescendants

getDescendants

getParent

getDocument

canContainContent

addContent

addContent

addContent

addContent