Class TagNodePollInclusive

  • public class TagNodePollInclusive
extends java.lang.Object
    TagNodePollInclusive 🠞
    1. TagNode: This implies that only HTML TagNode's will be used for searching. The field TagNode.tok field is used as a search criteria. This public, final String field contains the name of the HTML Element - for instance, 'div', 'p', 'span', 'img', etc...

      InnerTag's - (a.k.a. 'attributes') - are not part of the search.

    2. Poll: This refers to the operation of both removing and returning node matches to the programmer. After a 'poll' operation, the initial vectorized-html will actually contain fewer elements - and the removed elements shall be returned to the calling method.

    3. Inclusive: The word "Inclusive" is used to indicate that all HTMLNode's between an opening and closing HTML-tag are requested. The concept is extremely similar to the Java-Script feature / term '.innerHTML', although in this (JavaHTML) JAR Library, no DOM-Trees are ever constructed. This method will POLL all nodes between a matching, opening, TagNode element, and its corresponding-closing TagNode.
    Searches for TagNode matches, using exactly the same criteria offered by class TagNodePoll, but also obtains the corresponding Closing-Tags from the input-Vector and, subsequently, extracts these sublists from the input-Vector and then returns the sublists as new instances of Vector<HTMLNode>.

    Methods Available

    Method Explanation
    first (...) This will remove the first, complete, Vector<HTMLNode> sub-list or sub-page found inside the vectorized HTML page parameter that matches the specified search-criteria.
    nth (...) This will remove the nth, complete, Vector<HTMLNode> sub-list or sub-page found inside the vectorized HTML page parameter that matches the specified search-criteria.
    last (...) This will remove the last, complete, Vector<HTMLNode> sub-list or sub-page found inside the vectorized HTML page parameter that matches the specified search-criteria.
    nthFromEnd (...) This will remove the nth-from-last, complete, Vector<HTMLNode> sub-list or sub-page found inside the vectorized HTML page parameter that matches the specified search-criteria.
    all (...) This will remove the each and every, complete, Vector<HTMLNode> sub-list or sub-page found inside the vectorized HTML page parameter that matches the specified search-criteria.
    allExcept (...) This will remove the each and every, complete, Vector<HTMLNode> sub-list or sub-page found inside the vectorized HTML page parameter that does not match the specified search-criteria.

    Method Parameters

    Parameter Explanation
    Vector<? extends HTMLNode> html This represents any vectorized HTML page, sub-page, or list of partial-elements.
    int nth This represents the 'nth' match of a comparison for-loop. When the method-signature used includes the int 'nth' value, the first n-1 matches will be skipped, and the 'nth' match will be removed.
    int sPos, int ePos When these parameters are present, only HTMLNode's that are found between the specified Vector indices will be considered for matching with the search criteria.

    NOTE: In every situation where the parameters int sPos, int ePos are used, parameter 'ePos' will accept a negative value, but parameter 'sPos' will not. When 'ePos' is passed a negative-value, the internal LV ('Loop Variable Counter') will have its public final int end; field set to the length of the vectorized-html page that was passed. (html.size() of parameter Vector<HTMLNode> html).

    EXCEPTIONS: An IndexOutOfBoundsException will be thrown if:

    • If sPos is negative, or if sPos is greater-than or equal-to the size of the input Vector
    • If ePos is zero, or greater than the size of the input Vector.
    • If sPos is a larger integer than ePos
    TC tagCriteria The three values of enumeration TC are: TC.OpeningTags, TC.ClosingTags and TC.Both. These values specify a search-criteria result set for an HTML TagNode. There are two types of HTML Elements:

    • "opening versions" of the HTML-tag such as: <A HREF="...">
    • "closing versions" of the element such as: </A>.

    NOTE: If parameter 'tagCriteria' is passed a value of TC.Both, then (and this is hopefully obvious), that both 'opening' and 'closing' versions of the tag will be considered to meet / match the search criteria.
    String... htmlTags When this parameter is present, only HTMLNode's which are both instances of class TagNode *and* whose TagNode.tok field String-value matches (is equal to) at least one of the elements in this VarArgs String parameter-set will be considered for a match.

    COMMON EXAMPLES: Some common examples of valid htmlTags are: a, div, img, table, tr, meta as well as all other valid HTML element-tokens.

    NOTE: This comparison is performed using a case-insensitive compare-method

    EXCEPTIONS: If even one of the elements in this parameter-set is an invalid HTML token, an HTMLTokException will be thrown.

    Return Values:

    1. Vector<HTMLNode> This is a sub-set or sub-list that matches the search-criteria from the html vectorized-page parameter 'html' These are the exact nodes that were removed from the input-vector.
    2. Vector<Vector<HTMLNode>> This would be a "list of sub-lists" or an "array of sub-arrays" which are used when multiple results (multiple sub-lists) were removed from the input-vector, and being returned as a result of the "Poll" operation.
    3. A zero-length Vector<Vector<HTMLNode>> vector means no matches were found on the page or sub-page. This also shall mean that the original-input vector shall remain unchanged - with no sublists having been removed. Zero-length vectors are returned from any method where the possibility existed for multiple-matches being provided as a result-set.



    Stateless Class:
    This class neither contains any program-state, nor can it be instantiated. The @StaticFunctional Annotation may also be called 'The Spaghetti Report'. Static-Functional classes are, essentially, C-Styled Files, without any constructors or non-static member fields. It is a concept very similar to the Java-Bean's @Stateless Annotation.

    • 1 Constructor(s), 1 declared private, zero-argument constructor
    • 12 Method(s), 12 declared static
    • 0 Field(s)


    • Method Summary

       
      All Matches
      Modifier and Type Method
      static Vector<Vector<HTMLNode>> all​(Vector<? extends HTMLNode> html, String... htmlTags)
       
      All Matches, Range Limited
      Modifier and Type Method
      static Vector<Vector<HTMLNode>> all​(Vector<? extends HTMLNode> html, int sPos, int ePos, String... htmlTags)
       
      All Non-Matches
      Modifier and Type Method
      static Vector<Vector<HTMLNode>> allExcept​(Vector<? extends HTMLNode> html, String... htmlTags)
       
      All Non-Matches, Range Limited
      Modifier and Type Method
      static Vector<Vector<HTMLNode>> allExcept​(Vector<? extends HTMLNode> html, int sPos, int ePos, String... htmlTags)
       
      First Match
      Modifier and Type Method
      static Vector<HTMLNode> first​(Vector<? extends HTMLNode> html, String... htmlTags)
       
      First Match, Range Limited
      Modifier and Type Method
      static Vector<HTMLNode> first​(Vector<? extends HTMLNode> html, int sPos, int ePos, String... htmlTags)
       
      Last Match
      Modifier and Type Method
      static Vector<HTMLNode> last​(Vector<? extends HTMLNode> html, String... htmlTags)
       
      Last Match, Range Limited
      Modifier and Type Method
      static Vector<HTMLNode> last​(Vector<? extends HTMLNode> html, int sPos, int ePos, String... htmlTags)
       
      Nth Match
      Modifier and Type Method
      static Vector<HTMLNode> nth​(Vector<? extends HTMLNode> html, int nth, String... htmlTags)
       
      Nth Match, Range Limited
      Modifier and Type Method
      static Vector<HTMLNode> nth​(Vector<? extends HTMLNode> html, int nth, int sPos, int ePos, String... htmlTags)
       
      Nth Match From End
      Modifier and Type Method
      static Vector<HTMLNode> nthFromEnd​(Vector<? extends HTMLNode> html, int nth, String... htmlTags)
       
      Nth Match From End, Range Limited
      Modifier and Type Method
      static Vector<HTMLNode> nthFromEnd​(Vector<? extends HTMLNode> html, int nth, int sPos, int ePos, String... htmlTags)

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait