CompositeTag

java.lang.Object
- org.htmlparser.nodes.AbstractNode
- - org.htmlparser.nodes.TagNode
  - - org.htmlparser.tags.CompositeTag

所有已实现的接口:

java.io.Serializable, java.lang.Cloneable, Node, Tag

直接已知子类:

AppletTag, BodyTag, Bullet, BulletList, CompositeTagScannerTest.AnotherTag, CompositeTagScannerTest.CustomTag, DefinitionList, DefinitionListBullet, Div, FormTag, FrameSetTag, HeadingTag, HeadTag, Html, LabelTag, LinkTag, ObjectTag, OptionTag, ParagraphTag, ScriptTag, SelectTag, SHTag, Span, StyleTag, TableColumn, TableHeader, TableRow, TableTag, TextareaTag, TitleTag, UlTag
```
public class CompositeTag
extends TagNode
```
The base class for tags that have an end tag. Provided extra accessors for the children above and beyond what the basic Tag provides. Also handles the conversion of it's children for the toHtml method.

另请参阅:

序列化表格

构造器概要

构造器
构造器和说明

CompositeTag()
Create a composite tag.

构造器
构造器和说明
`CompositeTag()` Create a composite tag.

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`accept(NodeVisitor visitor)` Tag visiting code.
`Node`	`childAt(int index)` Get child at given index
`SimpleNodeIterator`	`children()` Get an iterator over the children of this node.
`void`	`collectInto(NodeList list, NodeFilter filter)` Collect this node and its child nodes (if-applicable) into the list parameter, provided the node satisfies the filtering criteria.
`Text[]`	`digupStringNode(java.lang.String searchText)` Finds a text node, however embedded it might be, and returns it.
`SimpleNodeIterator`	`elements()` Return the child tags as an iterator.
`int`	`findPositionOf(Node searchNode)` Returns the node number of a child node given the node object.
`int`	`findPositionOf(java.lang.String text)` Returns the node number of the first node containing the given text.
`int`	`findPositionOf(java.lang.String text, java.util.Locale locale)` Returns the node number of the first node containing the given text.
`Node`	`getChild(int index)` Get the child of this node at the given position.
`int`	`getChildCount()` Return the number of child nodes in this tag.
`Node[]`	`getChildrenAsNodeArray()` Get the children as an array of `Node` objects.
`java.lang.String`	`getChildrenHTML()` Return the HTML code for the children of this tag.
`Tag`	`getEndTag()` Get the end tag for this tag.
`java.lang.String`	`getStringText()` Return the text between the start tag and the end tag.
`java.lang.String`	`getText()` Return the text contained in this tag.
`void`	`removeChild(int i)` Remove the child at the position given.
`Tag`	`searchByName(java.lang.String name)` Searches all children who for a name attribute.
`NodeList`	`searchFor(java.lang.Class classType, boolean recursive)` Collect all objects that are of a certain type Note that this will not check for parent types, and will not recurse through child tags
`NodeList`	`searchFor(java.lang.String searchString)` Searches for all nodes whose text representation contains the search string.
`NodeList`	`searchFor(java.lang.String searchString, boolean caseSensitive)` Searches for all nodes whose text representation contains the search string.
`NodeList`	`searchFor(java.lang.String searchString, boolean caseSensitive, java.util.Locale locale)` Searches for all nodes whose text representation contains the search string.
`void`	`setEndTag(Tag tag)` Set the end tag for this tag.
`java.lang.String`	`toHtml(boolean verbatim)` Return this tag as HTML code.
`java.lang.String`	`toPlainTextString()` Return the textual contents of this tag and it's children.
`java.lang.String`	`toString()` Return a string representation of the contents of this tag, it's children and it's end tag suitable for debugging.
`void`	`toString(int level, java.lang.StringBuffer buffer)` Return a string representation of the contents of this tag, it's children and it's end tag suitable for debugging.

从类继承的方法 org.htmlparser.nodes.TagNode
breaksFlow, getAttribute, getAttributeEx, getAttributesEx, getEnders, getEndingLineNumber, getEndTagEnders, getIds, getRawTagName, getStartingLineNumber, getTagBegin, getTagEnd, getTagName, getThisScanner, isEmptyXmlTag, isEndTag, removeAttribute, setAttribute, setAttribute, setAttribute, setAttributeEx, setAttributesEx, setEmptyXmlTag, setTagBegin, setTagEnd, setTagName, setText, setThisScanner

从类继承的方法 org.htmlparser.nodes.AbstractNode
clone, doSemanticAction, getChildren, getEndPosition, getFirstChild, getLastChild, getNextSibling, getPage, getParent, getPreviousSibling, getStartPosition, setChildren, setEndPosition, setPage, setParent, setStartPosition, toHtml

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

从接口继承的方法 org.htmlparser.Node
clone, doSemanticAction, getChildren, getEndPosition, getFirstChild, getLastChild, getNextSibling, getPage, getParent, getPreviousSibling, getStartPosition, setChildren, setEndPosition, setPage, setParent, setStartPosition, toHtml

- 构造器详细资料
  - CompositeTag
```
public CompositeTag()
```
    Create a composite tag.
- 方法详细资料
  - children
```
public SimpleNodeIterator children()
```
    Get an iterator over the children of this node.
    
    返回:
    
    Am iterator over the children of this node.
  - getChild
```
public Node getChild(int index)
```
    Get the child of this node at the given position.
    
    参数:
    
    index - The in the node list of the child.
    
    返回:
    
    The child at that index.
  - getChildrenAsNodeArray
```
public Node[] getChildrenAsNodeArray()
```
    Get the children as an array of Node objects.
    
    返回:
    
    The children in an array.
  - removeChild
```
public void removeChild(int i)
```
    Remove the child at the position given.
    
    参数:
    
    i - The index of the child to remove.
  - elements
```
public SimpleNodeIterator elements()
```
    Return the child tags as an iterator. Equivalent to calling getChildren ().elements ().
    
    返回:
    
    An iterator over the children.
  - toPlainTextString
```
public java.lang.String toPlainTextString()
```
    Return the textual contents of this tag and it's children.
    
    指定者:
    
    toPlainTextString 在接口中 Node
    
    覆盖:
    
    toPlainTextString 在类中 TagNode
    
    返回:
    
    The 'browser' text contents of this tag.
  - toHtml
```
public java.lang.String toHtml(boolean verbatim)
```
    Return this tag as HTML code.
    
    指定者:
    
    toHtml 在接口中 Node
    
    覆盖:
    
    toHtml 在类中 TagNode
    
    参数:
    
    verbatim - If true return as close to the original page text as possible.
    
    返回:
    
    This tag and it's contents (children) and the end tag as HTML code.
    
    另请参阅:
    
    Node.toHtml()
  - searchByName
```
public Tag searchByName(java.lang.String name)
```
    Searches all children who for a name attribute. Returns first match.
    
    参数:
    
    name - Attribute to match in tag
    
    返回:
    
    Tag Tag matching the name attribute
  - searchFor
```
public NodeList searchFor(java.lang.String searchString)
```
    Searches for all nodes whose text representation contains the search string. Collects all nodes containing the search string into a NodeList. This search is case-insensitive and the search string and the node text are converted to uppercase using an English locale. For example, if you wish to find any textareas in a form tag containing "hello world", the code would be: NodeList nodeList = formTag.searchFor("Hello World");
    
    参数:
    
    searchString - Search criterion.
    
    返回:
    
    A collection of nodes whose string contents or representation have the searchString in them.
  - searchFor
```
public NodeList searchFor(java.lang.String searchString,
                          boolean caseSensitive)
```
    Searches for all nodes whose text representation contains the search string. Collects all nodes containing the search string into a NodeList. For example, if you wish to find any textareas in a form tag containing "hello world", the code would be: NodeList nodeList = formTag.searchFor("Hello World");
    
    参数:
    
    searchString - Search criterion.
    
    caseSensitive - If true this search should be case sensitive. Otherwise, the search string and the node text are converted to uppercase using an English locale.
    
    返回:
    
    A collection of nodes whose string contents or representation have the searchString in them.
  - searchFor
```
public NodeList searchFor(java.lang.String searchString,
                          boolean caseSensitive,
                          java.util.Locale locale)
```
    Searches for all nodes whose text representation contains the search string. Collects all nodes containing the search string into a NodeList. For example, if you wish to find any textareas in a form tag containing "hello world", the code would be: NodeList nodeList = formTag.searchFor("Hello World");
    
    参数:
    
    searchString - Search criterion.
    
    caseSensitive - If true this search should be case sensitive. Otherwise, the search string and the node text are converted to uppercase using the locale provided.
    
    locale - The locale for uppercase conversion.
    
    返回:
    
    A collection of nodes whose string contents or representation have the searchString in them.
  - searchFor
```
public NodeList searchFor(java.lang.Class classType,
                          boolean recursive)
```
    Collect all objects that are of a certain type Note that this will not check for parent types, and will not recurse through child tags
    
    参数:
    
    classType - The class to search for.
    
    recursive - If true, recursively search through the children.
    
    返回:
    
    A list of children found.
  - findPositionOf
```
public int findPositionOf(java.lang.String text)
```
    Returns the node number of the first node containing the given text. This can be useful to index into the composite tag and get other children. Text is compared without case sensitivity and conversion to uppercase uses an English locale.
    
    参数:
    
    text - The text to search for.
    
    返回:
    
    int The node index in the children list of the node containing the text or -1 if not found.
    
    另请参阅:
    
    (String, Locale)
  - findPositionOf
```
public int findPositionOf(java.lang.String text,
                          java.util.Locale locale)
```
    Returns the node number of the first node containing the given text. This can be useful to index into the composite tag and get other children. Text is compared without case sensitivity and conversion to uppercase uses the supplied locale.
    
    参数:
    
    locale - The locale to use in converting to uppercase.
    
    text - The text to search for.
    
    返回:
    
    int The node index in the children list of the node containing the text or -1 if not found.
  - findPositionOf
```
public int findPositionOf(Node searchNode)
```
    Returns the node number of a child node given the node object. This would typically be used in conjuction with digUpStringNode, after which the string node's parent can be used to find the string node's position. Faster than calling findPositionOf(text) again. Note that the position is at a linear level alone - there is no recursion in this method.
    
    参数:
    
    searchNode - The child node to find.
    
    返回:
    
    The offset of the child tag or -1 if it was not found.
  - childAt
```
public Node childAt(int index)
```
    Get child at given index
    
    参数:
    
    index - The index into the child node list.
    
    返回:
    
    Node The child node at the given index or null if none.
  - collectInto
```
public void collectInto(NodeList list,
                        NodeFilter filter)
```
    Collect this node and its child nodes (if-applicable) into the list parameter, provided the node satisfies the filtering criteria.
    This mechanism allows powerful filtering code to be written very easily, without bothering about collection of embedded tags separately. e.g. when we try to get all the links on a page, it is not possible to get it at the top-level, as many tags (like form tags), can contain links embedded in them. We could get the links out by checking if the current node is a CompositeTag, and going through its children. So this method provides a convenient way to do this.
    
    Using collectInto(), programs get a lot shorter. Now, the code to extract all links from a page would look like:
```
 NodeList list = new NodeList();
 NodeFilter filter = new TagNameFilter ("A");
 for (NodeIterator e = parser.elements(); e.hasMoreNodes();)
      e.nextNode().collectInto(list, filter);
 
```
    Thus, list will hold all the link nodes, irrespective of how deep the links are embedded.
    Another way to accomplish the same objective is:
```
 NodeList list = new NodeList();
 NodeFilter filter = new TagClassFilter (LinkTag.class);
 for (NodeIterator e = parser.elements(); e.hasMoreNodes();)
      e.nextNode().collectInto(list, filter);
 
```
    This is slightly less specific because the LinkTag class may be registered for more than one node name, e.g. <LINK> tags too.
    指定者:
    
    collectInto 在接口中 Node
    
    覆盖:
    
    collectInto 在类中 AbstractNode
    
    参数:
    
    list - The list to add nodes to.
    
    filter - The filter to apply.
    
    另请参阅:
    
    org.htmlparser.filters
  - getChildrenHTML
```
public java.lang.String getChildrenHTML()
```
    Return the HTML code for the children of this tag.
    
    返回:
    
    A string with the HTML code for the contents of this tag.
  - accept
```
public void accept(NodeVisitor visitor)
```
    Tag visiting code. Invokes accept() on the start tag and then walks the child list invoking accept() on each of the children, finishing up with an accept() call on the end tag. If shouldRecurseSelf() returns true it then asks the visitor to visit itself.
    
    指定者:
    
    accept 在接口中 Node
    
    覆盖:
    
    accept 在类中 TagNode
    
    参数:
    
    visitor - The NodeVisitor object to be signalled for each child and possibly this tag.
  - getChildCount
```
public int getChildCount()
```
    Return the number of child nodes in this tag.
    
    返回:
    
    The child node count.
  - getEndTag
```
public Tag getEndTag()
```
    Get the end tag for this tag. For example, if the node is {html The label}, then this method would return the {html LABLE} end tag.
    
    指定者:
    
    getEndTag 在接口中 Tag
    
    覆盖:
    
    getEndTag 在类中 TagNode
    
    返回:
    
    The end tag for this node. Note: If the start and end position of the end tag is the same, then the end tag was injected (it's a virtual end tag).
    
    另请参阅:
    
    Tag.setEndTag(org.htmlparser.Tag)
  - setEndTag
```
public void setEndTag(Tag tag)
```
    Set the end tag for this tag.
    
    指定者:
    
    setEndTag 在接口中 Tag
    
    覆盖:
    
    setEndTag 在类中 TagNode
    
    参数:
    
    tag - The new end tag for this tag. Note: no checking is perfromed so you can generate bad HTML by setting the end tag with a name not equal to the name of the start tag, i.e. {html The label}
    
    另请参阅:
    
    Tag.getEndTag()
  - digupStringNode
```
public Text[] digupStringNode(java.lang.String searchText)
```
    Finds a text node, however embedded it might be, and returns it. The text node will retain links to its parents, so further navigation is possible.
    
    参数:
    
    searchText - The text to search for.
    
    返回:
    
    The list of text nodes (recursively) found.
  - toString
```
public java.lang.String toString()
```
    Return a string representation of the contents of this tag, it's children and it's end tag suitable for debugging.
    
    指定者:
    
    toString 在接口中 Node
    
    覆盖:
    
    toString 在类中 TagNode
    
    返回:
    
    A textual representation of the tag.
  - getText
```
public java.lang.String getText()
```
    Return the text contained in this tag.
    
    指定者:
    
    getText 在接口中 Node
    
    覆盖:
    
    getText 在类中 TagNode
    
    返回:
    
    The complete contents of the tag (within the angle brackets).
    
    另请参阅:
    
    Node.setText(java.lang.String)
  - getStringText
```
public java.lang.String getStringText()
```
    Return the text between the start tag and the end tag.
    
    返回:
    
    The contents of the CompositeTag.
  - toString
```
public void toString(int level,
                     java.lang.StringBuffer buffer)
```
    Return a string representation of the contents of this tag, it's children and it's end tag suitable for debugging.
    
    参数:
    
    level - The indentation level to use.
    
    buffer - The buffer to append to.

类 CompositeTag

构造器概要

方法概要

从类继承的方法 org.htmlparser.nodes.TagNode

从类继承的方法 org.htmlparser.nodes.AbstractNode

从类继承的方法 java.lang.Object

从接口继承的方法 org.htmlparser.Node

构造器详细资料

CompositeTag

方法详细资料

children

getChild

getChildrenAsNodeArray

removeChild

elements

toPlainTextString

toHtml

searchByName

searchFor

searchFor

searchFor

searchFor

findPositionOf

findPositionOf

findPositionOf

childAt

collectInto

getChildrenHTML

accept

getChildCount

getEndTag

setEndTag

digupStringNode

toString

getText

getStringText

toString