Class DetailsPartEnumConst


  • public class DetailsPartEnumConst
    extends java.lang.Object
    JavaDoc Details-Part Enum Constant - Documentation.

    This will scour and retrieve the parts of a vectorized-HTML Java Class Documentation Enumerated Constant Definition for it's various sub-parts. Each JavaDoc generated HTML Page 'Enumerated Constant' details contains some or all of the following sections:

    • Enumerated Constant Name
    • Enumerated Constant Signature
    • Enumerated Constant Description
    • A 'see further' list of links

    The methods in this class will return the subsection as a DotPair pointer-pair, and it shall return null if this section was not found. These methods will throw an DetailsException if passed an invalid Method-HTML-Description part.

    USES, BENEFITS: Primarily, the three classes: DetailsPartConstructor, DetailsPartMethod and DetailsPartField is to help the user avoid trolling through the HTML-Source output of the JavaDoc utility. Having already done that, providing a simple method that can return an index-pointer (vector-location) to the entry or item in a standard JavaDoc Output Page - one could easily automate a build script to insert nicer, pretty-printed HTML-based explanations to further improve their code's documentation.




Stateless Class: This class neither contains any program-state, nor can it be instantiated.
The @StaticFunctional Annotation may also be called 'The Spaghetti Report'
  • 1 Constructor(s), 1 declared private, zero-argument constructor
  • 4 Method(s), 4 declared static
  • 0 Field(s)


    • Method Detail

      • name

        public static DotPair name​
                    (java.util.Vector<HTMLNode> javaDocEnumConstHTML)
        
        This method should be used in conjunction with Details.enumConstDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Enumerated-Constant Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the enumerated-constant "name" vectorized-HTML.

        HTML Elements:
        1
        2
         <h4> [Enumerated Constant Name] </h4>
         
        
        Parameters:
        javaDocEnumConstHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Enumerated-Constant in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Enumerated-Constant Details').
        Returns:
        DotPair pointing to HTML for the 'Enum-Const Name' part.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Enumerated-Constant Details' section, retrieved via Details.enumConstDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        DetailsException, TagNodeFindInclusive, Details.enumConstDetailsIterator(Vector)
        Code:
        Exact Method Body:
        1
        2
         DetailsException.check(javaDocEnumConstHTML);
         return TagNodeFindInclusive.first(javaDocEnumConstHTML, "h4");
        
      • signature

        public static DotPair signature​
                    (java.util.Vector<HTMLNode> javaDocEnumConstHTML)
        
        This method should be used in conjunction with Details.enumConstDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Enumerated-Constant Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the enumerated-constant "signature" vectorized-HTML.

        HTML Elements:
        1
        2
        3
         <h4> [Enumerated Constant Name] </h4>
         <pre> ... </pre>
         
        
        Parameters:
        javaDocEnumConstHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Enumerated-Constant in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Enumerated-Constant Details').
        Returns:
        DotPair pointing to HTML for the 'Enum-Const Signature' part.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Enumerated-Constant Details' section, retrieved via Details.enumConstDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        DetailsException, TagNodeFindInclusive, Details.methodDetailsIterator(Vector)
        Code:
        Exact Method Body:
        1
        2
         DetailsException.check(javaDocEnumConstHTML);
         return TagNodeFindInclusive.first(javaDocEnumConstHTML, "pre");
        
      • description

        public static DotPair description​
                    (java.util.Vector<HTMLNode> javaDocEnumConstHTML)
        
        This method should be used in conjunction with Details.enumConstDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Enumerated-Constant Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the enumerated-constant "description" vectorized-HTML.

        HTML Elements:
        1
        2
         <div class="block"> ... [Textual Description of Enumerated Type Constant] ... </div>
         
        
        Parameters:
        javaDocEnumConstHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Enumerated-Constant in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Enumerated-Constant Details').
        Returns:
        DotPair pointing to HTML for the 'Enum-Const Description' part.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Enumerated-Constant Details' section, retrieved via Details.enumConstDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        DetailsException, InnerTagFindInclusive, Details.methodDetailsIterator(Vector)
        Code:
        Exact Method Body:
        1
        2
        3
         DetailsException.check(javaDocEnumConstHTML);
         return InnerTagFindInclusive.first
             (javaDocEnumConstHTML, "div", "class", TextComparitor.C, "block");
        
      • see

        public static DotPair see​(java.util.Vector<HTMLNode> javaDocEnumConstHTML)
        This method should be used in conjunction with Details.enumConstDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Enumerated-Constant Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the enumerated-constant "see also" vectorized-HTML.

        HTML Elements:
        1
        2
        3
         <dt><span class="seeLabel">See Also:</span></dt>
         <dd>...
         
        
        Parameters:
        javaDocEnumConstHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Enumerated-Constant in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Enumerated-Constant Details').
        Returns:
        DotPair pointing to HTML for the 'Enum-Const See Also' part.

        Null will be returned if this HTML class description page for the Enumerated-Constant that is passed does not contain a 'see also' section.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Enumerated-Constant Details' section, retrieved via Details.enumConstDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        HELPER.getSpanSection(Vector, String)
        Code:
        Exact Method Body:
        1
         return HELPER.getSpanSection(javaDocEnumConstHTML, "seeLabel");